Preparing the Customization File for the PS_APP_HOME Location

By default, the DPK setup script creates the PS_APP_HOME directory in BASE_DIR/pt/<Product>_app_home, where <Product> is the abbreviation for the PeopleSoft application, such as fscm for PeopleSoft Financials and Supply Chain Management.

Note:

Review the requirements in Understanding PeopleSoft Environment Customizations before preparing the customization file.

Here are two scenarios where you might use this customization:

• If you are performing a new installation using the PeopleSoft DPKs, and you do not want to use the default PS_APP_HOME location created by the DPK setup script, use this customization to specify and create the desired PS_APP_HOME directory.

• If you are performing a mid-tier deployment to connect to an existing environment, use this customization to specify the existing PS_APP_HOME.

Note:

This applies only for customized location for new installation of PeopleSoft homes: Before you run the psft_puppet_apply.<ext> command, ensure the customized location given in the psft_customizations.yaml file does not contain any files or directories.

Use these steps to specify the PS_APP_HOME location.

1. Locate the psft_deployment.yaml file in BASE_DIR/dpk/puppet/production/data.

   Note:

   The code examples in this topic are for illustrative purposes only. Remember to use the text from the YAML files you install with each new deployment as the basis for your psft_customizations.yaml file.

   The PS_APP_HOME installation location is specified by the ps_app_home section.

   ps_apphome_location:  "%{lookup('pt_location')}/hcm_app_home"
   ps_app_home:
     db_type: "%{lookup('db_platform')}"
     include_ml_files: false
     location: "%{lookup('ps_apphome_location')}"
   

2. If necessary, create a psft_customizations.yaml using a standard editing tool, such as Notepad on Microsoft Windows or vi on Linux, and save it in the same location as the psft_deployment.yaml file.

   If this is the first entry in the psft_customizations.yaml file, ensure that there are three dashes (---) on the first line of the file. Do not indent the dashes.

3. To override the location, copy the entire section from the psft_deployment.yaml file into the psft_customizations.yaml file and modify the location value as needed.

   Retain the indentation as given in the delivered YAML file.

   For example, on Linux:

   ---
   ps_apphome_location:  "/home/hcm92_home"
   ps_app_home:
     db_type: "%{lookup('db_platform')}"
     include_ml_files: false
     location: "/home/hcm92_home"

   For example, on Microsoft Windows:

   ---
   ps_apphome_location:  "C:/hcm92_home"
   ps_app_home:
     db_type: "%{lookup('db_platform')}"
     include_ml_files: false
     location: "C:/hcm92_home"

4. Save the file.

5. Continue with the steps in Completing the Customized Deployment.