Skip to Content

Installing BMC Impact Integration Web Services server

Install the BMC Impact Integration Web Services server by using the following steps.

  1. Access the installation package for your required platform from the DVD or the EPD website.

    If you access the installation package from the EPD site, you must download the image from the EPD site to a local disk.

  2. Double-click setup_IIWS.exe or setup_IIWS.bin to launch the installation.
    On the EPD website, the setup file is located at BMC ProactiveNet Performance Management Suite > BMC ProactiveNet Performance Management Suite xx, (where xx is the version number) > BMC ProactiveNet Performance Management Suite (Monitoring, Analytics, Event and Impact) xx > BMC ProactiveNet xx > BMC ProactiveNet Performance Management Version xx - Core Components.

    Warning

    Note

    The location of the setup file may vary depending on the license you purchased.

    It could take several minutes for InstallAnywhere to prepare to install and extract the files. When it completes these tasks, the InstallAnywhere Wizard is opened, and the Welcome screen is displayed.

    Error
    Important: Only for installation on RHEL 7.7

    If you are installing the product on Red Hat Enterprise Linux 7.7 and if the installer does not start, install the product silently.

  3. Click Next to continue. The End User License Agreement is displayed.
  4. Read the license agreement, click I agree to the terms of the license agreement to continue, and then click Next.

    The Directory Selection window is displayed.
  5. Perform one of the following actions, then click Nextto continue:

    • Accept the default directory in the Destination Directory field.

      Warning

      Note

      If you are installing BMC Impact Integration Web Services on the same computer in which the BMC ProactiveNet Server is installed, do not choose the directory in which BMC ProactiveNet 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 field.
  6. On the HTTP/HTTPS port selection window, accept the default port number values or specify your own, and click Next to continue.
    The Installation Review window opens and provides you with an overview of the installation: the directory for the installation, the name of the feature being installed, and the amount of space in megabytes (MB) that it will use.
  7. After reviewing the installation information, click Next to continue.

    The Installation Summary window opens and confirms that the installation completed successfully.
  8. Click View Log to review the installation log.
  9. Click Done to exit InstallAnywhere.

 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

  • mcell.dir
  • ImWebServices. conf
  • iiws.selector
  • The mcell.dirfile
    • Defines the BMC Impact Manager cells with which the BMC Impact Integration Web Services component communicates
    • Defines the IIWSGatewayServer server entry that opens a gateway server to accept events that propagate from BMC Impact Manager cells
  • The ImWebServices.conf configuration file for BMC Impact Integration Web Services configuration parameters
  • The iiws.selector file defines the selectors that receive events from the BMC Impact Manager cells

$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

  • iiwsssl.jks
  • iiwscacerts.jks
  • iiwsssl.cer

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.

  Troubleshooting installation errors

To troubleshoot installation errors, you can view the installation logs.

  • Windows log files are located at: Document and Settings\ userName\Local Settings\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.




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC ProactiveNet 9.6