Perform the following steps to deploy the EAR file to a Websphere application server.

1. Log on to the Websphere administrative console.

   _______________________________________________________

2. Create a new shared library.
   1. In the left pane, click Environment > Shared Libraries.
   2. Click New to add a shared library. The window shown in Figure 1 opens.
      Figure 1. The Websphere Shared Libraries window
   3. In the Scope field, select a scope that includes the server where you will deploy the PKI Services JSPs (PKIServ_EAR).
   4. In the Name field enter PKIServices.
   5. Optionally enter a description in the Description field; for example, Java and C code to invoke PKI Services on z/OS.
   6. In the Classpath field, enter the following two lines:

      /usr/lpp/pkiserv/lib/pki_xml.jar
      /usr/lpp/pkiserv/lib/rpkis.jar

   7. In the Native Library Path field, enter:

      /usr/lpp/pkiserv/lib/librpkisJNI.so

   8. Click OK. A message is displayed indicating that changes have been made to your local configuration. See Figure 2.
      Figure 2. Message indicating that changes have been made to your local configuration.
   9. Click Save to save the changes to the master configuration.

   _______________________________________________________

3. Deploy the enterprise archive (EAR) file.
   1. In the left pane, click Applications > Enterprise Applications.
   2. Click Install. The window shown in Figure 3 opens.
      Figure 3. Window for specifying the EAR file
   3. Click Remote file system, and click Browse.
   4. Click the icon for the z/OS® system. The root directory is displayed. Continue selecting until you reach:

      /usr/lpp/pkiserv/pkijsp/PKIServ.ear

   5. Click OK and Next. Continue clicking OK and Next or Finish until you see a message saying that the EAR was installed and the message shown in Figure 2 indicating that changes have been made to your local configuration. (If you have more than one application installed into Websphere Application server, you might see a window where you have to select a server to which you want to map modules before you click Next.)
   6. Click Save to save the changes to the master configuration.

   _______________________________________________________

4. Associate the PKI Services shared library with the PKI Services application.
   1. In the left pane, click Applications > Enterprise Applications. Click PKIServ_EAR. The window shown in Figure 4 opens.
      Figure 4. Application properties page
   2. Click Shared Library References. The window shown in Figure 5 opens.
      Figure 5. Shared library mapping for modules page
   3. Select the PKIServ_Web check box and click Reference Shared Library.
   4. Add the PKI Services shared library to the Selected list and click OK.
   5. Select the PKIServ_EAR check box and click Reference Shared Library.
   6. Add the PKI Services shared library to the Selected list and click OK.
   7. Again you see the message shown in Figure 2 indicating that changes have been made to your local configuration. Click Save to save the changes to the master configuration.

   _______________________________________________________

5. Add the PKI Services shared library's location to the server's library path.
   1. In the left pane, click Servers > Application servers > server1 > (Java™ and Process Management) > Process Definition > Servant > Environment Entries > New , where server1 is the name of your server. In the Name field enter:

      LIBPATH

      In the Value field enter:

      /usr/lpp/pkiserv/lib

      In the Description field enter:

      rpkiserv jni path

      Click Apply. See Figure 6.
      Figure 6. Adding the PKI Services shared library's location to the server's library path
   2. Again you see the message shown in Figure 2 indicating that changes have been made to your local configuration. Click Save to save the changes to the master configuration.

   _______________________________________________________