The IBM TDI installer does not contain any user documentation, other than the Java API documentation, which can be displayed by selecting the Help -> Welcome screen, JavaDocs link in the Configuration Editor. IBM provides the user documentation in online form in an information center, at http://publib.boulder.ibm.com/infocenter/tivihelp/v2r1/topic/com.ibm.IBMDI.doc_7.1/welcome.htm.
IBM TDI is equipped with code1 to provide you with context-dependent online help that we can launch from the Configuration Editor (CE). By default, this code resolves the documentation from the online information center as referenced above. We can, however, install the documentation locally, such that you are not dependent upon the Internet to be able to read it.
These are the steps take to install documentation locally:
## Name of help server, comment out if we want local help system com.ibm.di.helpHost=publib.boulder.ibm.com/infocenter/tiv2help/index.jsp?topic=such that it reads:
## Name of help server, comment out if we want local help system #com.ibm.di.helpHost=publib.boulder.ibm.com/infocenter/tiv2help/index.jsp?topic=then next time we run the CE and launch Help, it starts a local task to serve the documentation, from the content in the plug-ins directory.
After you install the documentation in the plug-ins directory as outlined above, we can also decide to host the documentation on that computer for other installations of IBM TDI in your environment. In the TDI_install_dir/ibm_help directory there are a number of .bat files (Windows) or .sh files (Unix/Linux) that enable you to do this.
By editing this file, we can change the port number from the default, 8888; if we want to change this, to for example 80, change "-port 8888" to "-port 80". On those clients that are trying to access this information center, the port must match another property in the global.properties or solution.properties file, com.ibm.di.helpPort - its default is set to 80. Also, the com.ibm.di.helpHost property should read something like infocenter_IP_address/help, where infocenter_IP_address is the address of the local information center.In addition, in order for AMC to find this information center, update the parameters InfoCenterHostname and InfoCenterPort attributes in its configuration file, web.xml, to match the values above.
1.
The help system is powered by Eclipse™
technology. (http://www.eclipse.org)