x

By default, Service Manager runs as a Windows Service and there are two ways to start and stop it.

• Use the Windows start menu to select Programs, iWay 7.0 Service Manager, base, and Start Service Manager - base or Stop Service Manager - base.

or

• Open the Services window (Control Panel, Administrative Tools, and then Services), right-click iWay Service Manager -base, and select Start, Restart, or Stop.

Note: By default, Service Manager starts with Windows. To prevent it from starting with Windows, open the Services window, right-click iWay Service Manager -base, choose Properties, and change the Startup type to Manual.

Windows users can proceed to Configuring Service Manager.

x

To start Service Manager as a user task:

1. Navigate to the directory where iWay 7.0.7 SM is installed, for example:

   /home/userID/iway7

2. Type the following:

   ./iway7.sh base

   When you start Service Manager, you specify which configuration to use. The base configuration is available by default and includes SOAP and HTTP listeners. You can run more than one instance of Service Manager by defining multiple configurations using the iWay Service Manager Administration Console.

   When iWay has started, you receive the following prompt:

   Enter command:>

x

To stop Service Manager when it runs as a user task:

1. Go to the Service Manager prompt:

   Enter command:>

2. At the Service Manager prompt, enter the following to stop listeners:

   stop

3. When listeners have stopped, enter the following:

   quit

x

To start Service Manager as a service (daemon):

1. Navigate to the iway7/bin directory, for example:

   /home/userID/iway7/bin

2. Edit the following file.

   Note: This step is only required the first time you start Service Manager.

   1. Open the following file in a text editor:

      startservice.sh

   2. Edit the IWAY7 line to specify where iWay is installed. Be sure to include the final trailing slash, for example:

      IWAY7=/home/userID/iway7/

   3. Edit the IWAYUSER line so that it specifies the user ID that you want Service Manager to run under, for example:

      IWAYUSER=userID

      This user ID requires full permissions to the iway7 directory structure. For security reasons, it is not recommended to run iWay Service Manager as root.

   4. Save and exit the file.
3. Execute the startup service file, for example:

   ./startservice.sh

   If you are not logged on as root, you are prompted for the password of the user ID under which Service Manager runs.

   Password:

4. Enter the password for this user ID.

   The base configuration of Service Manager is started in the background and includes SOAP and HTTP listeners. A serviceOut.txt file appears in the iway7 directory and contains log information.

x

To stop Service Manager running as a service (daemon):

1. Navigate to the iway7/bin directory, for example:

   /home/userID/iway7/bin

2. Edit the shutdown file.

   Note: This step is only required the first time you stop Service Manager.

   1. Open the following file in a text editor:

      stopservice.sh

   2. Edit the IWAY7 line to specify where iWay is installed. Be sure to include the final trailing slash, for example:

      IWAY7=/home/userID/iway7/

   3. Edit the IWAYUSER line so that it specifies the user ID you are using to run Service Manager, for example:

      IWAYUSER=userID

   4. Save and exit the file.
3. Execute the shutdown file, for example:

   ./stopservice.sh

   If you are not logged on as root, you are prompted for the password of the user ID under which Service Manager runs.

   Password:

4. Enter the password for this user ID.

   Note: If you receive an error, ensure the user ID is defined in the shutdown file.

x

On z/OS systems, you can start Service Manager as a batch process using JCL.

1. Use the following sample JCL as a model to start Service Manager in batch:

   //EDABGBPX JOB (SMITH),'JAVA BPXBATCH',CLASS=A,MSGLEVEL=(1,1),
   //   MSGCLASS=X,REGION=0M,NOTIFY=EDABG,USER=EDABG1,PASSWORD=XXXXXXX
   //******************************************************************** 
   //* RUN JAVA UNDER A UNIX SYSTEM SERVICE SHELL
   //******************************************************************** 
   //STEP2 EXEC PGM=BPXBATSL,
   // PARM='PGM /bin/sh /u/edabg1/iway7/iway7.sh base -c'
   //STDOUT DD SYSOUT=*
   //STDERR DD SYSOUT=*
   //STDENV DD *
   JAVA_HOME=/usr/lpp/java/J1.6
   PATH=/usr/lpp/java/J1.6/bin
   //

2. Substitute the appropriate job card and HFS locations on your system accordingly.

x

On z/OS systems, you can stop Service Manager as a batch process using JCL.

1. Use the following sample JCL as a model to stop Service Manager in batch:

   //EDABGBPS JOB (SMITH),'JAVA BPXBATCH',CLASS=A,MSGLEVEL=(1,1),
   //   MSGCLASS=X,REGION=0M,NOTIFY=EDABG,USER=EDABG1,PASSWORD=XXXXXXX
   //********************************************************************
   //* RUN JAVA UNDER A UNIX SYSTEM SERVICE SHELL
   //********************************************************************
   //STEP2 EXEC PGM=BPXBATSL,
   // PARM='PGM /bin/sh /u/edabg1/iway7/bin/iway7sd.sh'
   //STDOUT DD SYSOUT=*
   //STDERR DD SYSOUT=*
   //STDENV DD *
   PATH="/usr/local/diff/bin:.:/usr/lpp/java/J1.6/bin:/bin::/usr/local/bin /usr/local/subin:/usr/sbin"1.6/bin'
   LIBPATH=/lib:/usr/lib:/usr/lpp/java/J1.6/bin:.
   JAVA_HOME=/usr/lpp/java/J1.6
   //

2. Substitute the appropriate job card and HFS locations on your system accordingly.

x

To access the iWay Service Manager Administration Console:

1. Open the following page in your web browser:

   http://hostname:9999

   where:

   hostname

   Is the host name where you installed iWay.

   If you changed the default port, substitute accordingly.

2. Log on when prompted. When first installed, the user ID and password are the following:

   User Name	admin
   Password	admin

   The iWay Service Manager Administration Console opens.

   

   Full information on using this console is in the iWay Service Manager User's Guide.

   For security purposes, you should change the default passwords used to access the console as follows.

3. At the top of the console, click Managed Servers.

   The Server Management page opens.

   The bottom of the page shows a list of existing users. By default, there are two user IDs:

   admin

   For administration.

   iway

   For general usage.

4. In the Name column, click iway to change the user password.
5. Type a new password in the Password field, confirm the password, and click Finish.
6. In the Name column, click admin to change the user password.
7. Type a new password in the Password field, confirm the password, and click Finish.

   You are prompted to log on with the new password.

8. Log on with the new password and click OK.

x

1. If it is not already open, access the iWay Service Manager Administration Console and log on as an administrator.
2. On top of the console, click Managed Servers.

   The Server Management page opens.

3. Under the Configurations area, click Add.

   A form appears to define the new configuration.

4. Complete the form as explained in the following table:

   Field Name	Value
   Name	Enter a name for the configuration. A directory with this name will be created under iway7\config, for example: C:\Program Files\iway7\config\myconf  This name is case-sensitive, even on Windows platforms.
   Description	Optionally enter a description for this configuration.
   Based On	Select a configuration or use a template for the new configuration. You can use one of the two defaults: The raw configuration contains no listeners and provides a blank template for defining additional configurations. The base configuration includes the default SOAP listener. If you use the base configuration as your template, you will need to later change the SOAP port of the new configuration so it does not conflict between instances. Note: If you have added additional listeners to the base configuration, those listeners will also be part of the new configuration.
   Port	Enter a port number that the new configuration will use for its console processing.
   Bind Address	Optionally enter an address for multihomed hosts.
   Secure	Optionally click the On check box to enable SSL.

5. After completing the form, click Finish.

   The new configuration is created. A directory for the configuration is added to the file system under the config directory. On Windows platforms, this is:

   C:\Program Files\iway7\config

x

If you are not using Windows, proceed to How to Run Additional Configurations on Non-Windows Platforms.

On Windows platforms, to create and run a new Windows service for the configuration:

1. Open a command prompt and navigate to the iway7\bin directory:

   C:\Program Files\iway7\bin

2. Enter the following to create the service.

   iwsrv config_name -s install

   where:

   config_name

   Is the name of the new configuration. This is case-sensitive, even on Windows platforms.

   The following is displayed:

   iWay Service Manager - config_name Service
   Installed Successfully.

   For details on iWay Service Manager, see the iWay Service Manager User's Guide.

3. Open the Control Panel, double-click Administrative Tools, and select Services.
4. Start and stop the configuration from the Services window. The service appears as:

   iWay Service Manager - config_name

   If you want to remove the service, ensure the service is stopped and then enter the following in a command prompt at the iway7\bin directory:

   iwsrv config_name -s remove

5. Proceed to How to Configure an Additional Configuration.

x

On other platforms, you can run the new configuration as a service (daemon) or as a user task.

• To run as a user task, navigate to the directory where you installed iWay and enter the following:

  iway7.sh config_name

  where:

  config_name

  Is the name of the new configuration.

• To run as a service, you must copy, edit, and then execute the default startup and stop files in the iway7/bin directory:

  startservice.sh

  stopservice.sh

Copy and rename these files and then edit them to replace base with the name of your configuration. Also be sure to change the log file names serviceOut.txt and serviceShutdown.txt so they are unique to this configuration. After copying and editing the startup file, execute it. The exact names of these files may vary depending on your platform.

x

1. After the configuration has started, return to the iWay Service Manager Administration Console home page for the default configuration:

   http://hostname:9999

   Note: Although each configuration has a iWay Service Manager Administration Console port, the console port for an additional configuration is not normally used. If you do use the iWay Service Manager Administration Console port for an additional configuration, you still need to select that configuration from the Managed Servers drop-down list.

2. In the Managed Servers drop-down list, select your configuration.
3. Use the iWay Service Manager Administration Console to configure the new configuration.
4. If you used the base configuration as a template, change the SOAP port so it does not conflict with the default base configuration. Then restart the configuration.

x

1. Ensure Service Manager is started.
2. Go to the following page in your browser:

   http://hostname:9000

   where:

   hostname

   Is the host name where you installed iWay.

   If you changed the default port, substitute accordingly.

   The iBSP home page opens as shown below. Three hyperlinks are available by default for the three default licenses, IVP, test, and production.

   

   This page allows you to test the sample web service installed with iWay 7.0.7 SM. When you create web services using iWay Explorer, you can also test them from this page.

3. Click IVP.
4. Click iwayivp.
5. Click ivp.
6. Click Invoke.

   An XML response that is similar to the following appears in your browser:

   <?xml version="1.0" encoding="UTF-8" ?>
   <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <SOAP-ENV:Body>
     <ivpResponse xmlns="urn:iwaysoftware:iBSP:jul2003:ivp:response"
      cid="A0328ED84ABFA055C4F64B8039C991AA">
      <CurrentTime>2017-05-02T19:14:03Z</CurrentTime>
      <Version>IWAY 7.0.7 Service Manager</Version>
     </ivpResponse>
    </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>