Post-Installation Topics and Tasks

iWay 6.1.7 SM Directory Structure

After installation, an iWay61 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.

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.

tools

Contains additional iWay components like iWay Designer and iWay Transformer.

Note: Some GUI tools are only available on Windows platforms.

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.

Installing Ebix Archives

Ebix archives are not packaged with the iWay 6.1.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

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.

Top of page

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

From the iWay Service Manager Administration Console home page, click Managed Servers.
The Server Management page appears. This page contains the list of defined server configurations. The configuration called base contains the master configuration information for your iWay Service Manager installation. If you have created other server configurations, you will see them listed on this page as well. Although only the master (base) port is used for the iWay Service Manager Administration Console, each configuration must have a unique, functional port.
Click the link for the base configuration.
The page of attributes for the server named base appears.
Locate the edit box for Port under Console Attributes (it will read 9999 if it is still set to the default value) and enter the new port number. This value must be an integer, within the range of valid port numbers, and currently not assigned to another process.
Note: If necessary, contact your system administrator for assistance in choosing an available TCP port.
Click Finish.
The Server Management page is displayed, confirming your new choice of console port.
To make the console port change effective, click on Restart Server located in the upper-right of the console page. The following message appears in your browser:
```
Server's master configuration is restarting... 
```
Because of the nature of this change, you will need to point your browser to the new URL. Wait ten to fifteen seconds and then reenter the server address with the new port number in the address bar.
When prompted, enter your login credentials. The iWay Service Manager Administration Console home page will display as usual, though served from the new port number.

Note: If you have installed iWay using an occupied port, or accidentally set your master (that is, base) console port to one that is occupied, it will be impossible to access the iWay Service Manager Administration Console. For information on how to correct this situation, contact iWay Technical Support.

Top of page

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.

Navigate to the iWay Adapter Manager console by clicking the version number that appears in the upper-right of the iWay Service Manager Administration Console.
The iWay Adapter Manager console (colored blue) appears.
From the Available Configurations drop-down list, select the server configuration you want to modify. In most cases this will be the single, master configured server named base.
Click Go to switch your administration context to the chosen server.
In the left pane, navigate to Configuration, Listeners.
The list of defined listeners for the configuration appears on the right.
Click the SOAP1 Listener to access its listener configuration page.
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.
Click Save 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 the iWay Service Manager server is restarted.
To return to the iWay Service Manager Administration Console, click the iWay Software banner located at the top of the iWay Adapter Manager console page.

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.

Top of page

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.

Navigate to the iWay Service Manager home page by clicking the Server menu link in the upper-left corner.
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.
In the left pane, select Register Settings.
A list of special registers appears in the right pane.
Click on the link for ibse-port to display its Special Register Definition information.
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.
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.
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.

Environment Variables

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

On Windows platforms, environment variables are automatically set by the installation program. No steps are necessary, but it is a good idea to be aware of them in case you need to troubleshoot.
On UNIX, OS/400, and z/OS platforms, you must manually set the appropriate environment variables for all user IDs that run iWay components.

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

Top of page

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:

The following variable must be defined and set to the location of the iWay61 directory. The commands can be issued interactively or added to the iWay user .profile file using a text editor.
```
IWAY61
```
For example:
```
IWAY61=/home/userID/iWay61/
export IWAY61
```
Note: Be sure to include the trailing slash.
The PATH variable must contain the iWay61/lib directory, for example:
```
PATH=$PATH:/home/userID/iWay61/lib
export PATH
```

On UNIX, the shared library variable must contain the iWay61/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/iWay61/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH

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.

Uninstalling iWay Service Manager

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

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\iWay61\config
```
Stop Service Manager if it is running.
If you have deployed iWay components to an Application Server, undeploy them.
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 6.1 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\iWay61\etc\uninstall\deploy\uninstaller.exe
```
- On UNIX, OS/400, and z/OS platforms, delete the iWay directories and remove the environment variables.