Steps for copying files

Before you begin
  • You need to obtain the following document:
  • You need to know the file system directory where the MVS™ programmer installed PKI Services and the runtime directory, install-dir and runtime-dir in the commands that follow. The defaults are /usr/lpp/pkiserv/ and /etc/pkiserv, in that order. The MVS programmer was asked to record any changes to these defaults; see Table 1.
  • The user ID you use for copying files must have superuser authority.
Perform the following steps to copy the files:
  1. If you are configuring PKI Services for the first time, copy the configuration file by entering the following command from the UNIX command line:
    cp -p /install-dir/samples/pkiserv.conf runtime-dir

    _______________________________________________________________

  2. If you are configuring PKI Services for the first time, copy the templates files. Do either Step 2.a or Step 2.b.
    1. If you are using REXX CGIs to implement the PKI Services web application, copy the text template file by entering the following command from the UNIX command line:
      cp -p /install-dir/samples/pkiserv.tmpl runtime-dir
    2. If you are using Java™Server pages (JSPs) to implement the PKI Services web application, copy the XML template file and the XML schema file by entering the following commands from the UNIX command line:
      cp -p /install-dir/samples/pkitmpl.xml runtime-dir
      cp -p /install-dir/samples/PKIServ.xsd runtime-dir

    _______________________________________________________________

  3. If your company is sending email notifications to users (when certificate requests are rejected or when certificates are ready for retrieval or expiring), copy the appropriate notification files from the samples directory to the runtime directory. For example:
    cp -p /install-dir/samples/rejectmsg.form runtime-dir
    cp -p /install-dir/samples/readymsg.form runtime-dir 
    cp -p /install-dir/samples/expiringmsg.form runtime-dir

    _______________________________________________________________

  4. If your company is sending email notifications to administrators when certificate requests are pending approval, copy the pendingmsg.form notification file from the samples directory to the runtime directory. For example:
    cp -p /install-dir/samples/pendingmsg.form runtime-dir

    _______________________________________________________________

  5. Start of changeIf your company is sending email notifications to administrators when certificate requests are approved with modifications, copy the pendingmsg2.form notification file from the samples directory to the runtime directory. For example:
    cp -p /install-dir/samples/pendingmsg2.form runtime-dir

    _______________________________________________________________

    End of change
  6. If your company allows users to request that PKI Services create key pairs (private key and public key) for certificate requests, copy the notification file that is used when a user requests that PKI Services recover a certificate for which it created the keys. For example:
    cp -p /install-dir/samples/recoverymsg.form runtime-dir

    _______________________________________________________________

  7. If you are configuring PKI Services for the first time, examine the values in the environment variables file (by default, pkiserv.envars). If any values need to change, copy this file by entering the following command:
    cp -p /install-dir/samples/pkiserv.envars runtime-dir

    _______________________________________________________________