Preparing the Customization File for Component Software Locations

Use the information in this section if you want to customize an installation location, for example to use an existing installation of Oracle Tuxedo or Oracle WebLogic.

Note:

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

Use this information to customize the installation location for the Oracle database client. For example, if you carried out a full-tier DPK deployment, the DPK setup script installed the Oracle database server software. You can specify that location instead of using the separate Oracle database client. Also, if you installed the Oracle database software separate from the DPK deployment, you can specify that installation location.

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 installation locations for Oracle Tuxedo, Oracle WebLogic, JDK, and Oracle database client are defined in the psft_deployment.yaml file that is installed with the deployment.
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 necessary, create a psft_customizations.yaml using a standard editing tool such as Notepad and save it in the same location as the psft_configuration.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.
Select one or more of the sections corresponding to the components that you want to customize, and copy them to the psft_customizations.yaml file.

As previously mentioned, setting the optional attribute remove: false means that the parameters in this section will not be deleted when the deployed environment is removed.

Note:

This applies only for customized location for new installation of component software: 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.
- For JDK, copy the jdk_location scalar parameter, and the entire jdk collection-type section (comprised of two lines) from the psft_deployment.yaml file into the psft_customizations.yaml file. Be sure to set the locations to the same value. Retain the indentation as given in the delivered YAML file.
```
---
jdk_location:    C:/jdk
jdk:
  location:  C:/jdk
  remove:        false
```
- For Oracle Tuxedo, copy both the tuxedo_location scalar parameter and the entire tuxedo collection-type section (comprised of two lines) from the psft_deployment.yaml file into the psft_customizations.yaml file. Be sure to set the locations to the same value. Retain the indentation as given in the delivered YAML file.
```
---
tuxedo_location:   C:/psft/tuxedo
tuxedo:
  location:      C:/psft/tuxedo
  remove:        false
```
- For Oracle WebLogic, copy both the weblogic_location scalar parameter and the entire weblogic collection-type section (comprised of two lines) from the psft_deployment.yaml file into the psft_customizations.yaml file. Be sure to set the locations to the same value. Retain the indentation as given in the delivered YAML file.
```
---
weblogic_location:  C:/psft/weblogic
weblogic:
  location:         C:/psft/weblogic
  remove:           false
```
- For Oracle Client, copy both the oracle_client_location scalar parameter and the entire oracle_client collection-type section (comprised of two lines) from the psft_deployment.yaml file into the psft_customizations.yaml file. Be sure to set the locations to the same value. Retain the indentation as given in the delivered YAML file.
```
---
oracle_client_location: <Oracle_Home>
oracle_client:
  location: <Oracle_Home>
                  
```
  For example, to specify the location of pre-existing Oracle database client software:
```
---
oracle_client_location:  C:/oracle/product/19.3.0.0/dbhome_1
oracle_client:
  location:  C:/oracle/product/19.3.0.0/dbhome_1
```
- If you want to customize JDK, Oracle Tuxedo, and Oracle WebLogic, add all three entries to psft_customizations.yaml; for example:
```
---
jdk_location:    C:/jdk
jdk:
  location:      C:/jdk
  remove:        false

tuxedo_location:   C:/psft/tuxedo
tuxedo:
  location:      C:/psft/tuxedo
  remove:        false

weblogic_location:  C:/psft/weblogic
weblogic:
  location:         C:/psft/weblogic
  remove:           false
```
Save the file.
Continue with the steps in Completing the Customized Deployment.