Skip to Main Content
Return to Navigation

Replicating PS_CFG_HOME

The application server and Process Scheduler domains exist within PS_CFG_HOME directory structure. You replicate both of these server elements by using the Replicate Config Home option in PSADMIN. The Replicate Config Home option enables you to clone a PS_CFG_HOME to a second location using PSADMIN internal functions to ensure that the environment is correct and cloned domains are readily bootable. The destination PS_CFG_HOME can reside on the same or a separate host. PSADMIN accounts for and modifies any host-specific settings and omits files that do not require cloning, such as log files.

This feature enables you to create a PS_CFG_HOME containing all the required domains that is reliable, tuned, and configured correctly for your site and deploy it to multiple locations across the enterprise. Replicating PS_CFG_HOME can be useful in a variety of scenarios, such as creating:

Note: When replicating a source PS_CFG_HOME, PSADMIN overwrites the destination PS_CFG_HOME and any domains currently existing within it. If the destination PS_CFG_HOME contains domains, PSADMIN alerts you before proceeding.

Note: PS_CFG_HOME/data is also copied from the source PS_CFG_HOME to the destination PS_CFG_HOME.

Note: File cache is also replicated in the destination PS_CFG_HOME. Consider that replicating a PS_CFG_HOME with 30 domains with file cache will take longer to copy over a network to a remote host than replicating a PS_CFG_HOME with two domains and no cache.

Important! Using the PSADMIN replication feature is not designed to support replication from one operating system to another. For example, you cannot configure a domain on UNIX and then replicate that domain on a Windows server. You can replicate between environments on the same operating system platform only.

To replicate a PS_CFG_HOME:

  1. Set PS_CFG_HOME to reflect the destination PS_CFG_HOME location.

  2. Launch PSADMIN.

  3. Select 5) Replicate Config Home from the PeopleSoft Server Administration menu.

    --------------------------------
    PeopleSoft Server Administration
    --------------------------------
    
      1) Application Server
      2) Process Scheduler
      3) Search Server
      4) Service Setup
      5) Replicate Config Home
      q) Quit
    
    Command to execute (1-5, q): 5
  4. When prompted, enter the location of the destination PS_CFG_HOME and press ENTER.

  5. When the process completes, verify the contents of the destination PS_CFG_HOME.

  6. Use PSADMIN to make any adjustments to the replicated domain environment information as needed.

    For example, consider the following items for the new host:

    • database connectivity software location.

    • port availability

    • cache location

    • file system settings

    • (if replicating to the same machine) JSL and WSL port conflicts