4.3 Installing the Event Server

Typically, the Event Server is installed when you run the installation program. If either of the following has occurred, manually install or configure the desktop shortcut for the Event Server:

4.3.1 Installing the Event Server

The following steps assume that eDirectory has been installed on drive C: of the server in the \novell\remoteloader\ directory.

  1. Copy the following to the c:\novell\nds directory.

    • NPS75EventServer.exe for PeopleSoft 7.5

    • NPS81EventServer.exe for PeopleSoft 8.1

  2. Create a shortcut for the Event Server application on the desktop.

    IMPORTANT:If you are running multiple PeopleSoft drivers, create one shortcut for each Event Server.

  3. Edit the command line in the Target field.

    The following graphic illustrates this field:

    The Target Field for Desktop Shortcuts

    Right-click the shortcut, then click Properties > Shortcut.

    Enter parameters for the shortcut. In the following table, {PS_Home} is the root of the PeopleSoft directory structure.

    PeopleSoft Platform

    Parameters

    PeopleSoft 7.5

    C:\Novell\NDS\NPS75EventServer.exe -c -s:16386 ‑p: PS_Home\bin\client\winx86

    PeopleSoft 8.1

    C:\Novell\NDS\NPS81EventServer.exe -c -s:16394 ‑p: PS_Home\bin\client\winx86

    The -c parameter configures the Event Server so that it runs as a console application. When you use this parameter, configure the DOS window properties with the following:

    • A scroll bar

    • A different color layout

    The Event Server communicates with the driver using a Windows* sockets interface or listening port. The following table lists the suggested socket number for each Event Server. If these numbers conflict with sockets already being used in your organization, use a different port set.

    Event Server

    Port

    PeopleSoft 7.5 Event Server

    16386

    PeopleSoft 8.1 Event Server

    16394

    Because each Event Server requires four consecutive sockets or ports, socket numbers for multiple Event Servers must be at least four digits apart.

    The Event Server must establish communications with the PeopleSoft Message Agent. It does this by connecting to the PeopleSoft Message Agent DLL files.

    These DLL files are typically located in the PS_HOME\BIN\CLIENT\WINX86 directory.

    For the NPS75EventServer shortcut, an example path to the PeopleSoft Message DLLs is -p:d:\psoft\hr757\bin\client\winX86. In this example, PS_HOME is equal to d:\psoft\hr757.

  4. Type the following in the Start In field:

    c:\Novell\NDS

    This is the directory where eDirectory is installed. The following figure illustrates this field:

    The Start In Field

  5. Select Apply, then click OK.

  6. Open the application via the shortcut.

You can customize the scroll bar and color changes by customizing the Property tab on the window.

Stopping the Event Server

You might need to stop the Event Server to refresh PeopleSoft connectivity, recycle the server, or debug. When you stop the Event Server, the Event Server sends a stop command to the driver shim. This command shuts down the driver shim before the Event Server exits.

To stop the Event Server from a console window:

  1. Select the Event Server window.

  2. Enter Q.

IMPORTANT:You can stop the Event Server by clicking the Exit icon in the window. However, do this only if the driver shim is not running. Before clicking the icon, shut down the driver shim. Do this from the DirXML* Driver Set Properties menu.

Installing the Event Server as a Service

You can install the Event Server as a Windows NT or Windows 2000 service. Normally, the Event Server is installed during the driver installation.

Two additional shortcuts are placed on the desktop during the installation process. These shortcuts enable you to create or remove the Event Server as a service.

To install the Event Server as a service:

  1. Ensure that the Event Server program is available.

    • On a local machine, verify that NPS x Event Server.exe is saved locally to the machine.

    • If you are installing the Event Server on a remote server where eDirectory is not installed, copy dirxmllib.dll and expat.dll from the novell\nds directory to the directory that the Event Server will run from.

      NOTE:The PeopleSoft client must always be installed on the server where the Event Server is going to run.

      The remote server’s IP address is used when configuring the Event Server in the driver parameters.

  2. At the command prompt, go to the directory where the executable file is stored, then enter the following:

    NPS75EventServer.exe -i -s:16386 ‑p: PS_HOME\bin\client\winx86

    The socket number and the path to the PeopleSoft Psmsg.dll might be different, based on your environment and driver configuration.

  3. From the Start menu, click Settings > Control Panel > Services > DirXML Event Server for PS 7.5 (or the appropriate release).

  4. Click Startup > select the Automatic option button to automatically start the Event Server at login, then click Start.

To stop the service:

  1. From the Start menu, click Settings > Control Panel > Services.

  2. Select the service, then click Stop.

Manually Uninstalling the Event Server As a Service

You can uninstall or remove the Event Server as a service. Follow the same steps as for installing the Event Server. However, in Step 2, substitute the -u parameter for the -i parameter.

For example, enter the following:

NPS75EventServer.exe -u -s:16386 ‑p: PS_HOME\bin\client\winx86

NOTE:When the Event Server runs as a service, there is no console window. All debug information is only available in the DSTRACE log.