Sourcing the psft_env.sh Script

When you use the DPK setup script with the default initialization, the script installs, configures and starts a single Application Server, a single Process Scheduler, and a single PIA domain.

When a non-root user deploys the PeopleSoft environment, as part of the deployment, the DPK setup script sources a shell script that sets environment variables, such as TUXDIR, PATH, and LD_LIBRARY_PATH, which are needed to run PeopleSoft utilities and programs.

See PeopleTools: System and Server Administration for information on working with PeopleSoft domains.

After the non-root user completes the deployment of the PeopleSoft environment using the DPK setup script DPK_INSTALL/setup/psft-dpk-setup.sh, in order to carry out operations on the PeopleSoft environment such as stopping and starting the DPK-created domains, creating additional domains with PSADMIN, or running Application Engine programs, the non-root user must source the script BASE_DIR/pt/psft_env.sh. For example, use the following command: 

source BASE_DIR/pt/psft_env.sh

Note:

If you are performing a deployment using the deploy_only option, see the next section.

Note that it is important to source the shell script (source BASE_DIR/pt/psft_env.sh), rather than simply running it (BASE_DIR/pt/psft_env.sh) in order for the environment variables to persist in the current shell. See your operating system documentation for the correct command to source the script.

Sourcing the psft_env.sh script sets the environment variables for the current session in the current shell, so that the programs and utilities you run in that shell inherit the environment variables. You must source the script and run the PeopleSoft utilities and programs from the same BASE_DIR. That is, the environment variables apply only to the programs in the PS_HOME installed under the BASE_DIR from which you run the script.

If your environment includes more than one deployment, be sure to source BASE_DIR/pt/psft_env.sh as needed in separate shells for each BASE_DIR.

The psft_env.sh script points to default or user-specified installation locations as set up by the DPK setup script. See Reviewing the Deployment File System for default locations. Here is a summary of the environment variables set by the BASE_DIR/pt/psft_env.sh script:

  • The script sets a pseudo random number generator to avoid getting stuck in entropy collection for the default random number generation.

  • The script sets the TUXDIR, PATH, and LD_LIBRARY_PATH environment variables to point to the Tuxedo installation.

  • The script sets the TNS_ADMIN, ORACLE_HOME, and LD_LIBRARY_PATH environment variables to point to the installations of the Oracle database and Oracle database client.

  • The script sets language/locale.

  • The script sets PS_CFG_HOME.

  • The script adds the PS_HOME/appserv and PS_HOME/setup directories to the PATH.

  • The script sources the PS_HOME/psconfig.sh script.

    The psconfig.sh script was used previously to set environment variables for non-DPK installations. Because it is included in the BASE_DIR/pt/psft_env.sh script, you do not need to source psconfig.sh separately.