Installing and configuring the pdpr script

If you are migrating from InfoPrint Manager and you use the pdpr command to submit jobs, you can install the RICOH ProcessDirector pdpr script on the computers that submit jobs and use the same command to send jobs to RICOH ProcessDirector.
The installation package for the pdpr script is copied to the primary computer when you install the base product. You can copy the installation package and install it on computers that submit jobs running these operating systems:
  • AIX 6.1 or 7.1
  • Sun Solaris 9 and 10
  • Windows 7
      Note:
    • To install the pdpr script on a different operating system, contact your Ricoh support representative.
The pdpr script requires Perl to run. Before you install the pdpr script, make sure that a Perl interpreter is installed on the client systems.

The pdpr script uses a control file named pdpr.cfg to determine whether jobs are sent to InfoPrint Manager or to RICOH ProcessDirector. You can either store the control file on the same computer that you install the pdpr script on, or you can store it in a central location and let the pdpr script access it using FTP. The pdpr script uses an anonymous login to the FTP server, so the anonymous user must have read permission for the control file.

To get the most recent pdpr script, contact your Ricoh support representative.

To install and configure the pdpr script:

  1. Log in to the primary computer as the RICOH ProcessDirector system user (aiw1 is the default), or with a user ID that is a member of the RICOH ProcessDirector group (aiwgrp1 is the default).
  2. Find the pdpr installer file: /aiw/aiw1/samples/pdpr/pdpr_installer.
  3. Copy the file to a temporary directory on the computer that runs the pdpr command.
  4. Log in to a client computer:
    • On an AIX or UNIX-based client, log in as the root user and open a command prompt.
    • On a Windows client, log in as a user with administrator permission and open a command prompt.
  5. Change directories to the directory that contains pdpr_installer.
  6. Type: perl pdpr_installer
    The installer interface runs in the command prompt window.
  7. When the installer asks where you want to install the program, choose a different directory than the temporary directory that the pdpr_installer was copied in to.
      Important:
    • If you install into the temporary directory, the installation fails. You get an incomplete installation that has a pdpr directory instead of the pdpr script.
  8. Respond to the questions in the installer according to these definitions:
    Hostname or IP address of RICOH ProcessDirector server
    Fully qualified hostname or IP address of the computer that the primary server is installed on.
    Full FTP path for pdpr.cfg file
    If you want to store the pdpr.cfg file in a central location, the full path to the pdpr.cfg file. The value must end with the file name pdpr.cfg.

    If you plan to store the pdpr.cfg file on the same system as the pdpr script, do not type anything; press Enter and continue with the installer.

  9. Finalize the installation process:
    • If you are installing on an AIX or Sun Solaris client, log out and log back in so the changes can take effect.
    • If you are installing on a Windows client, restart the computer so the changes can take effect.
  10. To define rules for parsing the pdpr command and submitting jobs to RICOH ProcessDirector, edit the pdpr.cfg file.
    The file must contain one line for each rule that you define. Jobs are sent to an input device based on the last rule that they match. If the job does not meet the conditions of any of the rules, it is sent to InfoPrint Manager.

    Each line of the file follows this syntax:

    • FileName | LDName,regular_expression, input_device_name, [BOTH]

    Use FileName if you want to parse the file name of the input file to determine where to send the job. Use LDName to parse the value of the -d (InfoPrint Manager logical destination) option on the pdpr command to determine where to send the job.

    For example, the file might contain these lines:

    LDName, .*\.[Pp][Ss], InputPS
    FileName, .*\.[Aa][Ff][Pp], InputAFP

    The first line instructs the script to look at the -d option on the pdpr command. If the value specified for that option ends with .ps or .PS, the job is sent to the input device named InputPS. The second line instructs the script to look at the file name of the input file. If the file name ends with .afp or .AFP, the job is sent to the input device named InputAFP.

    If neither condition is met, the job is sent to InfoPrint Manager using the value stored in the PDHOST environment variable on the system.

    Add the BOTH parameter to the end of an entry to indicate that if the condition is satisfied, the job should be sent to both InfoPrint Manager and RICOH ProcessDirector. This is useful when you are initially configuring RICOH ProcessDirector to receive jobs from pdpr because you can test the RICOH ProcessDirector configuration while continuing to use InfoPrint Manager in your production environment.

Now you can configure RICOH ProcessDirector to receive jobs submitted with the pdpr script from all the client systems.