How to: |
iWay Service Manager provides model configurations that you can use as is, or edit to create a custom configuration. When you install iSM, it includes the following configurations:
You must never modify the raw configuration. It is reserved as the bootstrap configuration for creating other configurations.
You can base your new configuration on one of these two model configurations or on another existing configuration. To avoid conflicts with other configurations, the system automatically assigns the next available port as the console port for the new configuration. This port is used for internal communication and cannot be accessed directly. You can override this value. If you override the port with a value already assigned to another configuration, then you are prompted to make a different selection.
Based on the template you use, the configuration software generates the new configuration and the required folders and files. You can also add other components to your configuration. Before you can use a configuration effectively, you must define its channels and business logic.
To create a configuration:
In order to take advantage of performance enhancements, Service Manager configurations can be installed to run as services in separate Java processes. In order to do this:
To add a configuration to iWay Service Manager:
The Deployments pane opens by default, as shown in the following image.
The Servers pane opens, as shown in the following image.
The Servers configuration pane opens, as shown in the following image.
The new configuration, TestConfig, appears in the Configurations list, as shown in the following image.
After your configuration is created, you can create a Windows service to start the configuration. This is optional.
How to: |
To create a Windows service that can be used to start a new configuration:
C:\Program Files\iWay8\bin
The iwsrv command starts iSM in a command window and allows you to create a Windows service.
iwsrv config_name -s install
To create a service with Java running in a separate process, type
iwsrv config_name -s install -l java
where:
Is the name of the configuration for which you are creating a service.
A message appears, indicating that the service was installed successfully.
Your next task is to start the configuration as a service. For more information, see How to Start a Configuration as a Service on Windows.
The full syntax for the iwsrv command is:
iwsrv [configuration] [-s service] [-l launch] [options]
where:
Is the name of the server configuration that is loaded for this instance. The default value is base.
Is the name of the service that is executed. Valid values are:
start: Starts the server configuration (default).
stop: Stops the server configuration.
install: Installs the server configuration.
remove: Removes the server configuration.
query: Queries the server configuration.
Specifies the launch method. Valid methods are:
java: Loads Java in a separate process and uses the JVM options, NT dependencies, and other preferences found within the iSM configuration that are configured through the console. For example: iwsrv.exe base -s start -l java
script file: Specifies a script file that defines the run-time preferences. This script file must be located in the iWay Service Manager installation directory. For example: iwsrv.exe base -s start -l iWay8.cmd
Both of the above uses of -l will force the service to load Java in a separate process. When the service is stopped, both iwsrv.exe and java.exe are terminated.
Specifies tracing or server back-up information. Valid values include:
-b: Indicates that Service Manager is a back-up server, for example:
iwsrv.exe base -s start -b
-c: Turns tracing on. In this mode, you can display useful error messages on the console. For example, you can display a message that says the Java Runtime Environment (JRE) is not properly installed. For example:
iwsrv.exe base -s start -c
-d: Limits tracing to debug only, for example:
iwsrv.exe base -s start -d
-f: [PATH] filters the system path when invoking JAVA. [RESTART] suppresses the JVM fault restart capability.
-h: iWay8 home directory.
-t: The amount of time (in seconds) to process service shutdown.
To start a new configuration as a service on Windows:
The Services window opens.
The service status changes to Started. The default start-up type is Automatic.
To start a new configuration as a service on a platform other than Windows:
On UNIX, this file is called:
startservice.sh
On other non-Windows platforms, the name may vary.
#!/bin/sh
#####################################################################
#
# Init
# Setup global variables and signal handling
#
# Edit following lines to point to install dir and change user ID"
IWAY8=/WorkSource/iWay8/
IWAYUSER=root
IWAYCONFIG=baseMOD=""
cd $IWAY8/config/$IWAYCONFIG if test 'uname' = 'OS400'; then java $REMDBG -cp $CLASSPATH -DIWAY8=$IWAY8 com.ibi.service.edaqmSilentService -config $IWAYCONFIG >> $IWAY8/serviceOut.txt &elif test 'uname' = 'OS/390'; then java $REMDBG -cp $CLASSPATH -DIWAY8=$IWAY8 com.ibi.service.edaqmSilentService -config $IWAYCONFIG >> $IWAY8/serviceOut.txt &else su $IWAYUSER -c "java $REMDBG -cp $CLASSPATH - Diwaysoftware.af.idocument=com.ibi.edaqm.XDDocument -DIWAY8=$IWAY8 com.ibi.service.edaqmSilentService -config $IWAYCONFIG >> $IWAY8/serviceOut.txt &"fi
The service is started.