Web Service for Optimize for Infrastructure

This document covers the following topics:


General Information

This document describes the installation of the Natural for Ajax web service for Optimize for Infrastructure. This web service enables Optimize for Infrastructure to measure and display certain key performance indicators (KPIs) of the Natural for Ajax installation. The Optimize for Infrastructure documentation contains the definitions of these KPIs and describes how to make the web service known to Optimize for Infrastructure.

The web service is delivered as a web application (NJXOptimizeService.war).

Installing the Web Service on IBM WebSphere Application Server

The web service is installed using the Administration Console of IBM WebSphere Application Server.

The following is assumed:

  • <host> is the name of the machine on which the application server is installed.

  • <port> is the name of the port where the application server is installed. In a default installation, this is port 9080.

  • <adminport> is the name of the port where the Administration Console is installed. In a default installation, this is port 9060.

Start of instruction setTo install the web service

  1. Make sure the application server is running.

  2. Open your web browser and enter the following URL:

    http://<host>:<adminport>/ibm/console

    This opens the Administration Console.

  3. Deploy the web application NJXOptimizeService.war:

    1. Open the tree node Applications > Application Types > WebSphere enterprise applications.

    2. On the Enterprise applications page, choose Install.

    3. Select WebSphere/NJXOptimizeService.war as the path to the new application. Then choose Next.

    4. Choose Next. If additional information is required, you will be prompted.

    5. On the Select installation options page, select the Deploy Web services check box. Then choose Next.

    6. On the Map modules to servers page, select a cluster and server, select Natural for Ajax and choose Apply. Then choose Next.

    7. On the Map virtual hosts for Web modules page, select a virtual host, select Natural for Ajax and choose Next.

    8. On the Map context roots for Web modules page, enter "NJXOptimizeService" as context root and choose Next.

    9. On the Summary page, choose Finish.

    10. On the next page, choose Save.

Installing the Web Service on Apache Tomcat

The following topics are covered below:

Prerequisites

Start of instruction setJAX-WS 2.0

  1. Download a version of JAX-WS from https://javaee.github.io/metro-jax-ws/.

  2. Expand the JAX-WS archive and copy all *.jar files from the /lib directory into the WEB-INF/lib directory of the NJXOptimizeService web application.

Start of instruction setWeb Services Metadata for the Java Platform (JSR 181)

  1. Download https://mvnrepository.com/artifact/javax.jws/jsr181-api.

  2. Copy the .jar file into the WEB-INF/lib directory of the NJXOptimizeService web application.

Installation

The web service is installed using the Tomcat Manager.

The following is assumed:

  • <host> is the name or IP address of the machine on which Apache Tomcat is installed.

  • <port> is the port number of the Apache Tomcat instance. In a default installation, this is port 8080.

Start of instruction setTo install the web service

  1. Start Apache Tomcat.

  2. Open your web browser and enter the following URL:

    http://<host>:<port>/manager/html

    This opens the Tomcat Manager.

  3. Deploy the web application file NJXOptimizeService.war:

    • Under Select WAR file to upload, select the path to the file NJXOptimizeService.war.

    • Choose Deploy.

Verifying the Installation

It is assumed that http://<host>:<port> is the URL of your application server or web container.

Start of instruction setTo verify the installation

  • Enter the following URL in your web browser:

    http://<host>:<port>/NJXOptimizeService/DataCollectionService?wsdl

    The WSDL definition of the web service should be displayed.