Installing BMC Impact Integration Web Services server
The BMC Impact Integration Web Services server installation program installs a stand-alone Tomcat server and Axis2 components. You can install the product by using the wizard or silently.
To install the BMC Impact Integration Web Services server by using the wizard
Use one of the following methods to access the installation program:
- DVD — Insert the installation DVD.
- BMC Software EPD website (http://webapps.bmc.com/epd) — For more information about downloading the Infrastructure Management software, see Downloading the Infrastructure Management installation files. Extract the contents of the zipped distribution file (TrueSight Infrastructure Management Version 11.3.04 - IIWS) to an appropriate directory.
- DVD — Insert the installation DVD.
Launch the installation wizard:
Important
To install IIWS on SuSE 15.x or Linux 8.x, you must install Adopt Open JDK 1.8. You can use Adopt Open JDK 1.8 to launch the IIWS installer by using the following command:
./setup_IIWS.bin LAX_VM "<java_path>"- Windows
In the <installLocation>\Windows\Impact_Web_Service directory, double-click setup_IIWS.exe. - Linux
In the <installLocation>/Linux/Impact_Web_Service directory, run setup_IIWS.bin. - Solaris
In the <installLocation>/Solaris/Impact_Web_Service directory, run setup_IIWS.bin.
- Windows
- On the Welcome page, click Next.
On the License Agreement page, read the agreement and select the I agree to the terms of the license agreement option, and click Next.
If you do not agree to the terms of the license agreement, the installation process will not continue.- The Directory Selection window is displayed.
Perform one of the following actions, then click Next to continue:Accept the default directory in the Destination Directory box.
Note
If you are installing BMC Impact Integration Web Services on the same computer in which the BMC TrueSight Infrastructure Management Server is installed, do not choose the directory in which Infrastructure Management is installed as the destination directory. Install BMC Impact Integration Web Services in a separate directory.
Click Browse to search for another directory path on the file system.
- Enter a custom directory path in the Destination Directory box.
- On the HTTP/HTTPS port selection window, accept the default port number values or specify your own, and click Next.
Review the installation details.
- To change any details, click Previous to view previous screens and change the relevant details.s
If the details are correct, click Install.
On the Installation Summary page, you can click View Log to view the installation logs or click Done to exit the installation wizard.
To install the BMC Impact Integration Web Services server silently
- On the command prompt, navigate to the directory where the Options file is located.
- Run the following command:
setup_IIWS.exe -i silent -DOPTIONS_FILE=Options.txt
BMC Impact Integration Web Services server installation directory contents
The installation installs a stand-alone Tomcat server and Axis2 components.
The BMC Impact Integration Web Services components are installed under $IIWS_HOME/Tomcat/webapps/imws/WEB-INF/.
The following table describes the directory contents of the BMC Impact Integration Web Services installation package.
Directory contents
Directory | File | Description |
|---|---|---|
$IIWS_HOME/Tomcat/webapps/ imws/WEB-INF/services | ImpactManager.aar | The Axis archive file for the BMC Impact Integration Web Services server includes the jar files and class files; the wsdl and xsd files; and the web service configuration file. |
$IIWS_HOME/Tomcat/webapps/ imws/WEB-INF/etc |
|
|
$IIWS_HOME/Tomcat/webapps/imws/WEB-INF/classes | log4j.properties | Defines the logging properties for BMC Impact Integration Web Services. The BMC Impact Integration Web Services trace log is created under the $IIWS_HOME/Tomcat/logs/iiws.log directory, by default. |
$IIWS_HOME/Tomcat/webapps/imws/WEB-INF/security |
| The keystore files for running HTTPS for BMC Impact Integration Web Services server. |
$IIWS_HOME/Tomcat/webapps/imws/client_samples | Provides the sample code for developing the BMC Impact Integration Web Services client. | |
$IIWS_HOME/Tomcat/webapps/ imws/WEB-INF/log | A directory that is created when you run BMC Impact Integration Web Services that contains the persistent files for BMC Impact Integration Web Services. |
To verify the installation
After installing and starting the server, you can verify that the BMC Impact Integration Web Services server wsdl file is installed through the following example URLs (where host name represents the name of the host where BMC Impact Integration Web Services is installed, and port is the port number assigned to BMC Impact Integration Web Services): http://hostname:port/imws/services/ImpactManager?wsdl
The default port is 9080. https://hostname:port/imws/services/ImpactManager?wsdl
The default port is 9443.
Troubleshooting
This section provides information about resolving some IIWS installation and connection issues.
Connection handle issue in the IIWS logs
Symptom
The following error is displayed in the IIWS logs:
Invalid connection handle <handle number>
Scope
This occurs because the IIWS client uses the cached connections.
Resolution
Perform the following steps:
- Open a new connection in IIWS.
- Use the valid connectHandle value returned from the Connect operation.
Cannot install IIWS on Linux 8.x
Symptom
IIWS cannot be installed on the Linux 8.x operating system.
Scope
The installation fails because the installer looks for the default path to JAVA on the system, and the default path points to JAVA 11. IIWS needs a default path for JDK 1.8.
Resolution
To install IIWS on SuSE 15.x or Linux 8.x, you must install Adopt Open JDK 1.8. You can use Adopt Open JDK 1.8 to launch the IIWS installer by using the following command:
./setup_IIWS.bin LAX_VM "<java_path>"
Note
You can install IIWS on RHEL 6.x or 7.x by using the following command:
./setup_IIWS.bin LAX_VM "<java_path>"
In this case, the default JAVA path that is set by the system can be used. The default path is /usr/bin/java.
Installation logs
To troubleshoot installation issues, you can view the installation logs.
- Windows log files are located at: \Temp\iiws_install_log.txt.
- UNIX log files are located at: $TMPDIR/iiws_install_log.txt or $IATMPDIR/iiws_install_log.txt.
On UNIX systems, if more than one Java Virtual Machine (JVM) is installed on the computer, you must uninstall BMC Impact Integration Web Services by running the
./setup_IIWS.bin LAX_VM "<java_path>"command, where <java_path> is the location in which Java is installed.
Comments
Is it possible to include an "options.txt" sample used when installing IIWS in silent mode, it is mentioned it is needed, but does not mention what does it need to contain.
Need to run install silently but there is no example of an otions file. can this be updated please
setup_IIWS.bin -i silent -DOPTIONS_FILE=Options.txt
Log in or register to comment.