Verifying installation

The sections below describe the paths and filenames of the product after installation and how to verify your adapter installation.

Note:
All product pathnames are relative to the directory where the product is installed on your system.

Verifying installation on a Windows system

Before you begin, install the adapter. The Installer copies the standard files associated with the adapter into your system. The utility installs the connector into the ProductDir\connectors\XML directory, and adds a shortcut for the connector to the Start menu.

Perform the following steps to verify adapter installation on a Windows system, change to the directory where you installed the adapter ProductDir\ and compare the contents to those listed in Table 1.

Table 1 describes the Windows file structure used by the adapter, and shows the files that are automatically installed when you choose to install the adapter through Installer.

Table 1. Windows file structure for the connector
Subdirectory of ProductDir Description
\connectors\XML Contains the adapter application-specific component class files CWXML.jar, CwProtocolHandler.jar, and the adapter start file start_XML.bat
\connectors\messages\XMLConnector.txt Contains the error codes and description of the errors used by the connector
\connectors\XML\Samples Contains the files used for testing the connector
\connectors\XML\Dependencies\IBM Contains the .jar files for implementing security
\connectors\XML\start_XML_service.bat The startup script for the connector service.

Verifying installation on a Linux system

Before you begin, install the adapter. The Installer copies the standard files associated with the adapter into your system. The utility installs the connector agent into the ProductDir/connectors/XML directory.

Perform the following steps to verify adapter installation on a Linux system, change to the directory where you installed the adapter ProductDir/ and compare the contents to those listed in Table 2.

Table 2 describes the Linux file structure used by the adapter, and shows the files that are automatically installed when you choose to install the adapter through Installer.

Table 2. Linux file structure for the connector
Subdirectory of ProductDir Description
/QIBM/UserData/WBIServer44 Contains the adapter application-specific component class files CWXML.jar, CwProtocolHandler.jar, and the adapter start file start_XML.sh
/connectors/messages/XMLConnector.txt Contains the error codes and description of the errors used by the connector
/connectors/XML/Samples Contains the files used for testing the connector
/connectors/XML/Dependencies/IBM Contains the .jar files for implementing security

Verifying the installation on an i5/OS system

Before you begin, install the adapter. The Installer copies the standard files associated with the adapter into your system. The utility installs the connector agent into the ProductDir/connectors/WBIMB directory.

Perform the following steps to verify adapter installation on an i5/OS system, change to the directory where you installed the adapter ProductDir/ and compare the contents to those listed in Table 3.

Table 3 describes the i5/OS file structure used by the adapter, and shows the files that are automatically installed when you choose to install the adapter through Installer.

Table 3. i5/OS file structure for the connector
Subdirectory of ProductDir Description
/QIBM/UserData/WBIServer44 Contains the connector CWXML.jar, CWProtocolHandler.jar and start_XML.sh files
/QIBM/UserData/WBIServer44 Location for jcert.jar, jnet.jar, and jsse.jar files that are required for https connections. To use the Adapter for XML with your i5/OS system, you must obtain appropriate jsse.jar, jnet.jar, and jcert.jar files for use with i5/OS, and add them to this directory. These files are available as downloads from the Sun web site at: http://java.sun.com/products/jsse/. To set up these files, see the steps following this table.
/connectors/XML/Samples Contains java and xml files and sample business objects used for testing.
/connectors/XML/Dependencies/Sun Contains the xml.jar file.
/connectors/messages Contains the XMLConnector.txt file.
repository/XML Contains the CN_XML.txt file.
/lib Contains the WBIA.jar file.
/bin Contains the CWConnEnv.sh file.

To use the XML adapter with encryption on i5/OS, you must manually install some jar files that are not shipped with this product.

Perform the following steps to install the jar files in /QIBM/UserData/WBIServer44 to use the adapter with i5/OS.

  1. Obtain the appropriate jsse.jar, jnet.jar, and jcert.jar files for use with IBM i5/OS and from the sun web site at: http://java.sun.com/products/jsse/
  2. Unzip the jsse jar to hard-disk which creates a jsse project directory. Under the jsse directory there is a /lib directory (for example: \jsse1.0.3_03\lib) that contains the necessary jsse jars to run the adapter.
  3. Copy the three jar files in the /lib directory to the i5/OS IFS in the following location: /QIBM/UserData/WBIServer44 (you can use Windows Explorer and copy to the IFS mapped drive).
  4. After the jars are copied to IFS, the owner of the jar files should be changed to QWBISVR44 with the following CL commands:
    CHGOWN OBJ ('/QIBM/UserData/WBIServer44/jnet.jar')
    NEWOWN (QWBISVR44) RVKOLDAUT (*YES)
    CHGOWN OBJ ('/QIBM/UserData/WBIServer44/jcert.jar')
    NEWOWN (QWIBSVR44 RVKOLDAUT (*YES)
    CHGOWN OBJ ('/QIBM/UserData/WBIServer44/jsse.jar')
    NEWOWN (QWBISVR44) RVKOLDAUT (*YES)
  5. The start_XML.sh script must be edited to include the jar files in the classpath. Edit the following file:
    /QIBM/UserData/WBIServer44/<ICSName>/connectors/
    <XMLBasedConnector> is an XML connector
    for example: "XMLConnector' (for the default), or 'MyXMLConnector' if the user created a custom XML adapter named MyXML Connector)
    export JAVA_JSSE=/QIBM/UserData/WBIServer44/jcert.jar:/QIBM/UserData/
    WBIServer44/jnet.jar:/QIBM/UserData//WBIServer44/jnet.jar:/QIBM/
    UserData/WBIServer44/jsse.jar export JCLASSES=${JCLASSES}:${JAVA_JSSE}.

Copyright IBM Corp. 2004, 2005