Class Path and Service Manager Restart Issues

Topics:

You should be aware of the information in the following topics about setting the class path and restarting Service Manager.

Class Path

When Service Manager starts, it loads the Java VM and adds all JAR or ZIP files in the iway7/lib directory to its CLASSPATH variable. To include files outside of iway7/lib in class path, register them as explained in Configuring General Properties Using the Console. To exclude files in iway7/lib from being in class path, move the files to another directory or rename them so that they do not end in *.jar* or *.zip* (a file with an extension such as .jarold would be included).

When you access the Service Manager console in a web browser, the first window displays a class path drop-down list containing all files in the class path. When you register a library or add files to the CLASSPATH variable, you should ensure that the files appear in this drop-down list after you stop and then restart Service Manager.

Trace Level Settings

Trace level settings (for example, debug, deep, external) can be changed using the console or the command line. When setting trace levels, it is not necessary to restart your iSM instance. Trace level settings are applied automatically to the running iSM instance.

Restarting Service Manager

You can restart Service Manager using one of the following methods:

  • Full Restart

    A full restart (stopping and starting Service Manager) ensures all changes are applied and a completely new Java Runtime Environment (JRE) is used when Service Manager restarts. This is required for any changes that affect the JRE. You must perform a full restart if you change register libraries, providers, and Java Virtual Machine (JVM) options. In addition, a full restart is also required if you add new files to the iway7/lib directory or add files to the CLASSPATH variable.

    The following image shows the Start and Stop options for Service Manager running on Windows.

    For more information, refer to the procedures appropriate for your platform and the mode in which Service Manager runs (for example, service or non-service).

  • Console Restart

    A console restart ensures that changes made to special register settings are applied. It does not apply any system level changes, as described by the full restart method.

    The following image shows the Restart link in Service Manager that is used to restart the iWay Service Manager Administration Console.

    When you click Restart, the following dialog is displayed:

    Click OK to restart. After the console restarts, you are returned to the General Properties page in the iWay Service Manager Administration Console.