Adding a Remote Server Instance

The iPlanet Application Server Integration tool enables you to deploy to your application to one or more iPlanet Application Server instance. Setup a local or remote server instance prior to performing local or remote debugging.

To create a remote server instance:

  1. From the Explorer window Runtime tab, select iPlanet Application Server Instances node.

    If the iPlanet Application Server node is not displayed, then the iPlanet integration tool is not installed or it is not enabled.

  2. Right click to select Add an iPlanet Application Server Instance menu option.

    The iPlanet Application Server Properties window appears allowing you to create a new server instance.

  3. Select each field to edit all the properties to match your remote server settings.

    Admin Port Number Enter the port number of the remote Administrative Server. During installation of the iPlanet Application Server this is set by default to port number 10817.

    If you are unsure of the port number, perform the following steps:

    1. From your remote server open a command tool, type kregedit, to launch the iPlanet Application Server Registration Editor.

      A treeview of the iPlanet Application Server directory structure appears.

    2. Locate the SOFTWARE\iPlanet\Application Server\6.0\Admin\Port<PortNumber>
    3. Enter the port number in the Properties window Admin Port Number field.

    Admin User name Enter the username for the iPlanet Administration KAS Server on the remote machine. By defualt the local server settings are displayed.

    Admin User Password Enter the password for the remote iPlanet Administrative KAS Server on the remote machine. By default the local server settings are displayed.

    If you registered the Application Server instance through the AdminTool, the Integration Tool polls the AdminTool registration to obtain the username and password and displays it here as the default entry for you. If you haven't registered the server, a message appears in the Status bar prompting you to identify the Admin username and password.

    Connector URL Enter this URL http://<RemoteHostName>:<RemoteHostPortNumber>/<AppServerPrefix>

    If you are unsure of the remote server port number and prefix, perform the following steps:

    1. From your remote server open a command tool and type kregedit, to launch the iPlanet Application Server Registration Editor.

      A treeview of the iPlanet Application Server directory structure appears.

    2. Locate the SOFTWARE\iPlanet\Application Server\6.0\CCS0\HTTPAPI\HTTPPort<PortNumber>
    3. Note the port number.
    4. Scroll down to locate the SSPL_APP_PREFIX=<AppServerPrefix>
    5. Note the Prefix. By default the iPlanet Application Server prefix is NASApp.

    Host Name Identify the remote hostname.

  4. Close the property window.

    A node representing your remote server appears under the iPlanet Application Server Instances node.

  5. Right click on the remote server instance.

    Both the Start Server Engines and Stop Server Engines menu are enabled if your remote Administrative KAS Server is running.

    As long as the Administrative KAS server engine is running on the remote server, the Start Remote Server Engines/Stop Remote Server Engines menu items are active and allow you to start/stop the Executive KXS Server engine, the Java KJS engine, and the C++ Server engine.

    The Start Remote Server Engines/Stop Remote Server Engines menu items are disabled as long as the Administrative KAS Server engine on the remote server is not running.

    If the remote Administrative KAS Server is down, a red arrow on the instance node icon is displayed indicating the KAS is not running. A green arrow indicates the Administrative KAS server is running.

    When the remote server is stopped and started, there is a delay for Forte to detect it. Also, the iPlanet Integration tool does not poll the server continuously, so the server instance node display does not change until the next time the node is selected.

  6. Right click on the remote server instance and select Set as Default.

    The Set as Default menu option is disabled if the server is already set as the default.

    The remote server instance context menu can take a few moments to display since it is polling the remote server.

    Notice that the iPlanet Application Server Instances node changes to identify your remote server as the default.

See also
  Creating a Local Server Instance
About the iPlanet Application Server Engines

Legal Notices