To tune conversion performance for the first time a user
views a document, make sure to complete the procedure for each Conversion
server.
Procedure
- Stop the server instances:
- Log into the IBM Conversion Server with an administrator
account.
- Navigate to .
- Click Task Scheduler Library.
- Right-click the following tasks and select End.
- Right-click the following tasks and select Disable.
- Stop the WebSphere Application server instance on the
Conversion server.
- Open Task Manager and confirm that all
soffice.bin
process
are terminated.
- Modify the instance parameters:
-
Open the directory conversion_install_root(for example,
C:\IBM\IBMConversion\\symphony.
- By default, four instances of the IBMConversion process
are created. This can be increased as needed.
- Copy the inst0 directory and duplicate it so that there
is one directory for each conversion instance. For example if you
want eight instances, you should have directories inst0 to inst7.
- Open the following file with a text editor:
C:\IBMConversion\symphony\sym_monitor\instances.cfg
- Add the following line, modifying the instance ID and
port number. The instance ID number should match that last number
of the port number. Repeat this process until there is one line corresponding
to each directory instance created in the previous step.
- Save the file and close the editor.
- On deployment manager, open file ${WAS_ROOT}/profiles/Dmgr01/config/cells/${CellName}/IBMDocs-config/conversion-config.json
- Locate the line containing:
{"host":"127.0.0.1","port":8100},{"host":"127.0.0.1","port":8101},{"host":"127.0.0.1","port":8102},{"host":"127.0.0.1","port":8103}
- Add the following information to the end of the line,
one for each port number which corresponds to the new instance:
{"host":"127.0.0.1","port":<port>}
- Example
{"host":"127.0.0.1","port":8100},{"host":"127.0.0.1","port":8101},{"host":"127.0.0.1","port":8102}
,
{"host":"127.0.0.1","port":8103},{"host":"127.0.0.1","port":8104},{"host":"127.0.0.1","port":8105}
,
{"host":"127.0.0.1","port":8106},{"host":"127.0.0.1","port":8107}
- Update the used-host-count property to be the value
of primary instances (1/2 the total instances deployed - so in this
example, you would update it to a value of 4).
- Update the number of conversion library instances.
An additional setting (new in release 1.0.5) that can be modified
is the number of conversion library instances. Perform the following
steps to update this setting:
- On deployment manager, open file ${WAS_ROOT}/profiles/Dmgr01/config/cells/${CellName}/IBMDocs-config/conversion-config.json.
- Locate the line containing:
maxInstanceNum
- Update the number of instances up to twice the number
of cores on the host.
- Save the file and close the editor.
- Restart the server instances
- Log into the IBM Conversion Server with an administrator
account.
- Navigate to .
- Click Task Scheduler.
- Right-click the following tasks and select Enable.
- Right-click the following tasks and select Run.
- Synchronize the Conversion nodes.
- Start the WebSphere Application server instance on the
Conversion server.
- Verify that the tuning is complete by uploading a new
ODT document to Files. Click Edit in HCL Docs.
If the document opens in HCL Docs,
the tuning is successful.