In this section: |
If you are not running on Windows, see Starting and Stopping Service Manager on UNIX, OS/400, and z/OS.
Note: Running Service Manager usually refers to running the configuration called “base,” unless another configuration is specifically mentioned. The base configuration is created with the installation of the product.
You can run Service Manager on Windows in one of the following ways:
Use this method in most situations. For more information, see Starting and Stopping Service Manager as a Windows Service.
For more information, see Starting and Stopping Service Manager in the Command Window.
On Windows, the start-up procedure uses the configuration files as follows:
C:\Program Files\iWay60\bin\iwsrv.exe
When Service Manager is installed, a Windows service for the base configuration is created. By default, this service starts with Windows whenever you reboot the machine. You can manually start and stop the service as explained in the following procedures.
When running Service Manager as a Windows service, Service Manager runs in the background as the Local System account and remains running if you log off the machine. For assistance with troubleshooting, check the Event Viewer as explained in Diagnostics, Tracing, and Logging.
You can start the Service Manager service from either the Windows Services window or through the Start menu. You also can stop the Service Manager service from the Windows Services window or through the Start menu.
By default, the Service Manager service runs as the Local System account and starts automatically when you reboot the Windows machine. If you do not want Service Manager to start automatically with Windows, or you want to run Service Manager with a different user ID, see How to Change the Service Manager Windows Service Configuration.
Tip: To create Windows services for other configurations, see Managing Configurations.
To use the Services window to start or stop Service Manager as a Windows service:
The Services window opens.
The service status changes to started.
To use the Windows Start menu to start or stop Service Manager as a Windows service:
To prevent Service Manager from starting automatically or to run Service Manager with a user ID other than Local System:
The Services window opens.
The iWay Service Manager-base Properties dialog box opens.
The user ID must be an administrator of the local machine.
If you change the user ID under which Service Manager runs, ensure that the user ID has full NTFS permissions to the iWay60 directories.
For debugging purposes, you can run Service Manager in a command window instead of running it as a Windows service.
The command window enables you to interact with Service Manager and displays diagnostic information about Service Manager processing.
To start Service Manager in the command window:
C:\Program Files\iWay60\bin
iwsrv
Note: For other configurations, enter the configuration name after iwsrv. Configuration names are case-sensitive.
Messages appear in the command window detailing the start-up process. The following prompt appears when the start up is complete:
Enter command:>
If you receive errors similar to the following, Service Manager is probably already running as a service. You cannot run the same configuration at the same time as both a service and in the command window.
ERROR (HTTP1) Unable to create server socket 9980: java.net.BindException: Address already in use: JVM_Bind ERROR (SOAP1) Unable to create server socket 9000: java.net.BindException: Address already in use: JVM_Bind
To stop Service Manager in the command window:
Enter command:>
stop
quit
Note: If you close the command window without typing these commands, Service Manager stops. However, typing the commands is recommended.
The full syntax for the iwsrv command is:
iwsrv [config_name|base] [-s service|start] [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. The default value is start.
stop: Stops the server configuration.
install: Installs the server configuration.
remove: Removes the server configuration.
Specifies tracing or server back-up information. Valid values include:
-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
-b: Indicates that Service Manager is a back-up server, for example:
iwsrv.exe base -s start -b
-l: In order to improve server performance, iwsrv.exe can load Java in a separate process, and use the JVM options, NT dependencies, and other preferences found within the iSM configuration that are configured through the iSM Web console. For example:
iwsrv.exe base -s start -l java
The -l option can also be used to specify a script file that defines the run-time preferences. This script file must be located in the iWay60 installation directory, for example:
iwsrv.exe base -s start -l iWay60.cmd
Both of the above uses of -l force the Service Manager service to load Java in a separate process. When the service is stopped, both iwsrv.exe and java.exe are terminated.
iWay Software |