Post-Installation Topics and Tasks

In this section:

After installation, review the following topics and perform the steps needed for your environment.


Top of page

x
iWay 7.0.7 Service Manager Directory Structure

After installation, an iway7 directory is created and contains the following subdirectories:

bin

Contains files required to start and access iWay Service Manager.

config

Contains configuration files for iWay components. Schemas and some web services information are written to subdirectories.

User IDs used to run iWay components must have full permissions to the config directory.

Note: You can run more than one instance of Service Manager by defining multiple configurations using the iWay Service Manager Administration Console. The iWay Service Manager Administration Console is introduced in Configuring iWay Components. By default, two configurations are defined, base and raw. The base configuration sets up everything you require to get started and includes SOAP and HTTP listeners. The raw configuration contains no listeners and provides a useful template to define additional configurations.

etc

Contains documentation, miscellaneous tools, and files to configure additional components. Subdirectories of etc also contain Extensions and additional tools.

lib

Contains adapters, drivers, and other files used by iWay components. All iWay components must access this directory and your library path must be set to this location. For details, see Environment Variables.


Top of page

x
Installing Third-Party Jar Files

Many protocols that iWay Service Manager supports require the presence of third-party jar files. Specific requirements are documented for each protocol in the iWay Service Manager Protocol Guide.

The j2ee.jar file is required for a number of iWay Service Manager features and functions across protocols.

J2EE is not a component that is normally distributed with JRE. If you are compiling an iSM exit that requires J2EE, Oracle provides a skeleton version that does not contain any method code. This version can be downloaded using the following link:

http://download.java.net/maven/2/javax/javaee-api/6.0/javaee-api-6.0.jar

The actual .jar file that contains the appropriate method code is licensed and supplied by the vendor of an application server (for example, Glassfish, JBOSS, and so on). The Apache Tomcat web server does not provide a J2EE, so you must locate the appropriate executable code. For example, you may need the mail.jar file from Oracle if you are using iSM mail systems.

There is a j2ee.jar file that is distributed by Oracle, which can be used. This file can be downloaded using the following link:

http://www.oracle.com/technetwork/java/javaee/download-141771.html

Download and install the software according to the instructions from the vendor and copy the j2ee.jar to [IWAYHOME]/lib.

For more information about your specific platform, contact iWay Customer Support.


Top of page

x
Installing Ebix Archives

Ebix archives are not packaged with the iWay 7.0.7 Service Manager installation. However, Ebix metadata is available for download from the following website, which is hosted and maintained by iWay Software and Information Builders:

http://techsupport.ibi.com

Top of page

x
iWay TCP Ports

iWay Service Manager uses two TCP ports for system communication. The following table lists the function and default values of these ports.

Listener

Default Port

Purpose

Console

9999

HTTP listener for the iWay Service Manager Administration Console.

SOAP

9000

SOAP listener for iBSP.

During iWay SM installation, you can select values other than the default for either or both of these ports (for security or in case of a port conflict).

Under certain circumstances, it may be necessary to change the iWay Service Manager system port assignments after installation is completed. This section describes the procedures to change the Console and SOAP and iBSP port assignments.



x
Procedure: How to Change the iWay Service Manager Administration Console Port Assignment

The iWay Service Manager Administration Console port assignment can be modified by accessing the console and navigating to Console Settings.



x
Procedure: How to Set Up the SOAP Listener to Follow the ibse-port Special Register

The SOAP listener port is set to the integer value literal entered during iWay Service Manager installation, with the default being 9000. This is not ideal for situations where the SOAP port will be changed after installation, since the ibse-port Special Register and the SOAP port must always be changed in tandem.

  1. Access the iWay Service Manager Administration Console.
  2. Click Registry in the top pane, and then click Listeners in the left pane.

    The Listeners pane opens.

  3. Click Add.

    The Select listener type pane opens.

  4. Select the SOAP1 listener from the Type drop-down list and click Next.
  5. In the Port Property Value field, enter SREG(ibse-port).

    The value you are replacing should be an integer port number, its value being 9000 if the default was accepted during installation. Do not change any of the other properties of the SOAP1 listener.

  6. Click Finish to save the change. The SOAP port will not change until the ibse-port Special Register is updated (see How to Set the ibse-port Special Register) and iWay Service Manager is restarted.

    Note: You only need to add the ibse-port Special Register in the SOAP1 Listener Port field once. After this has been set up, future changes to the ibse-port Special Register will automatically update the iWay Service Manager SOAP port.



x
Procedure: How to Set the ibse-port Special Register

Once you have successfully completed setting up the SOAP listener value to follow that of the ibse-port Special Register, changing the ibse-port register will automatically change the iWay Service Manager SOAP listener port, as well.

  1. Navigate to the iWay Service Manager home page by clicking the Server menu link in the upper-left corner.
  2. Select the server configuration you want to change from the Managed Server drop-down list. In most cases, this will be the single, master configured server named base.

    The console refreshes with the General Properties of the selected server.

  3. In the left pane, select Register Settings.

    A list of special registers appears in the right pane.

  4. Click on the link for ibse-port to display its Special Register Definition information.
  5. In the Value field, enter a new value for the ibse-port register.

    Note: This value must be an integer, within the range of valid port numbers, and currently not used by any other process on the machine. If necessary, contact your system administrator for assistance in choosing an available TCP port.

  6. Click Update to accept the change.

    The Register Settings page is displayed so you can confirm the new ibse-port value.

    As with all iWay Service Manager Special Register settings, you must restart the server for the new ibse-port setting to take effect.

  7. To restart the server, click Restart in the upper-right of the console.

    The following message appears in your browser:

    Server's master configuration is restarting...

    When restart is complete, the iWay Service Manager Administration Console home page appears.


Top of page

x
Environment Variables

After installation, environment variables are required to use iWay adapters and components. The variables can be set in your profile.

Note: If you plan to run multiple installations of iWay components, the environment variables must be set up appropriately for each installation.



x
Procedure: How to Set Environment Variables on UNIX Systems

The following environment variable settings are required to use iWay Service Manager and iWay adapters and components on a UNIX system:

  1. The following variable must be defined and set to the location of the iWay7 directory. The commands can be issued interactively or added to the iWay user .profile file using a text editor.
    IWAY7

    For example:

    IWAY7=/home/userID/iWay7/
    export IWAY7

    Note: Be sure to include the trailing slash.

  2. The PATH variable must contain the iWay7/lib directory, for example:
    PATH=$PATH:/home/userID/iWay7/lib
    export PATH
  3. On UNIX, the shared library variable must contain the iWay7/lib directory. This variable varies depending on your platform. The following table lists platforms and their associated variables.

    Platform

    Variable

    AIX

    LIBPATH

    HP-UX

    SHLIB_PATH

    Other UNIX Platforms

    LD_LIBRARY_PATH

    For example:

    LD_LIBRARY_PATH=/home/userID/iWay7/lib:$LD_LIBRARY_PATH
    export LD_LIBRARY_PATH

Top of page

x
Configuring iWay Service Manager Service as a Separate Process

By default, the iwsrv executable program installs the iSM Windows service to run out of process.

For more information on the iwsrv executable program, see the iWay Service Managers User’s Guide.


Top of page

x
Uninstalling iWay Service Manager

If you wish to remove iWay from your system, do the following:

  1. Copy any files you wish to save out of the iWay directory structure. Most user files are stored with the configuration, for example:
    C:\Program Files\iWay7\config
  2. Stop Service Manager if it is running.
  3. If you have deployed iWay components to an Application Server, undeploy them.
  4. Uninstall components using the provided utility.
    • On Windows platforms, open the Control Panel and then use the Add or Remove Programs option to remove iWay components. The main uninstall component is listed as:
      iWay 7.0 Service Manager

      You can also delete any iWay installation files in subdirectories of the following:

      C:\WINNT\Downloaded Installations\
      C:\WINDOWS\Downloaded Installations\

      If you ran the deploy tool to configure components for an application server, run its uninstall utility as well, for example:

      C:\Program Files\iWay7\etc\uninstall\deploy\uninstaller.exe
    • On UNIX, OS/400, and z/OS platforms, delete the iWay directories and remove the environment variables.

iWay Software