Preparing the Customization File for Unicode

Use these instructions if you want to change the Unicode designation for your database.

Note:

Do not try to set up a non-Unicode environment if you are deploying the PeopleSoft Update Image DPKs for use with PeopleSoft Update Manager. The environments for the PeopleSoft Updates Images are required to be Unicode.

Note:

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

  1. Locate the psft_deployment.yaml file.

    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.

    By default, the DPK setup script installs the YAML files in BASE_DIR/dpk/puppet/production/data.

    The unicode_db parameter is part of the ps_home section.

    ps_home:
      db_type:    "%{lookup('db_platform')}"
      unicode_db: "%{lookup('unicode_db')}"
      location:   "%{lookup('ps_home_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. Copy the entire ps_home section from psft_deployment.yaml, maintaining the indentation, into the psft_customizations.yaml file.

    For a Unicode database, set the value for unicode_db to true:

    ---
    ps_home:
      db_type:    "%{lookup('db_platform')}"
      unicode_db: true
      location:   "%{lookup('ps_home_location')}"

    For a non-Unicode database, set the value for unicode_db to false:

    ---
    ps_home:
      db_type:    "%{lookup('db_platform')}"
      unicode_db: false
      location:   "%{lookup('ps_home_location')}"
  4. Save the file.

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