Running the DPK Setup Script for the Application Server Domain Deployment on Linux as the Root User

This procedure to deploy an application server domain assumes you have obtained the four PeopleSoft PeopleTools DPK zip files and saved them in DPK_INSTALL.

If you are installing the PeopleSoft environment as a non-root user, see the section Running the DPK Setup Script for the Application Server Domain Deployment on Linux as a Non-Root User.

Note:

Some of the informational script messages have been omitted for brevity.

To deploy the domain:

Extract the first zip file (FILENAME_1ofn.zip).

Note:

It is a good idea to extract into the same directory where you downloaded the zip files, DPK_INSTALL.

Note:

It is important that you retain the DPK_INSTALL/setup directory, even after deploying, because it holds the DPK setup script, which must be used for both deploying an environment and cleanup of deployed environment.

The extraction creates the DPK_INSTALL/setup directory and other files.
Open a terminal window as root.
Change directory to DPK_INSTALL/setup.
Run the script as follows:
- If you extracted the first zip file into the same directory where you downloaded the zip files, use this command:
```
./psft-dpk-setup.sh --env_type midtier --domain_type appserver
```
- If you extracted the first zip file into a different directory, include the option dpk_src_dir to specify the location of the downloaded zip files, such as DPK_INSTALL, as follows:
```
./psft-dpk-setup.sh --dpk_src_dir DPK_INSTALL --env_type midtier ⇒
--domain_type appserver
```
At the following prompt, enter the full path to a location that is accessible to the host to be used as the PeopleSoft base directory, referred to here as BASE_DIR.

The base directory is used to extract the DPKs as well as for deploying PeopleSoft components. The script creates the base directory if it does not exist.

Use forward slashes only (/) when specifying the base directory; for example, /home/psft. Do not use a base directory name that begins with a number. Do not end the base directory name with a forward slash (for example, do not enter /ds1/psft/).
```
The base directory is used to extract the PeopleSoft DPKs. It is also
used to deploy the PeopleSoft components. This directory should be
accessible, must have write permission and should have enough 
free space.

Enter the full path for the PeopleSoft Base Directory: 
Are you happy with your answer? [Y|n|q]:     
```
The script installs Puppet software and validates if there is enough free space available under the specified base directory for the PeopleSoft environment. The PeopleSoft environment setup is aborted if there is not enough free space.

Note:

A mid-tier setup of a PeopleSoft environment requires about 25 GB of disk space.
Specify a writable directory for the user home directory at the following prompt.

The PeopleSoft environment setup using DPKs creates local users on the host. These users deploy the PeopleSoft components and own the PeopleSoft runtime domains. Enter a new location to be used for creating the home directories for these local users, or specify the default home directory, /home. Enter the full path, and ensure that the directory is writable.
```
Enter the full path for the User Home directory 
that is writable [/home]: /ds1
Are you happy with your answer? [y|n|q]:
```
If the script finds that the location you enter (either a new location or the default) is not writable, it exits with the following message.
```
The User does not have write permission to create the user's home
directory under [<user input>] on the Linux VM.
Exiting the PeopleSoft environment setup process.
```
Specify the type of database platform.

Press ENTER to accept ORACLE.
```
Enter the PeopleSoft database platform [ORACLE]: 
```
Specify whether you want a Unicode database.
```
Is the PeopleSoft database unicode? [Y|n]:
```
Enter the database name.
```
Enter the PeopleSoft database name:
```
If your database platform is Oracle, enter the database service name.

The default is the same as the database name. Do not enter an IP address.
```
Enter the PeopleSoft database service name [PSFT92DB]:
```
Enter the name of the host where the database is installed.

Do not enter an IP address.
```
Enter the PeopleSoft database host name:
```
If your database platform is Oracle, enter the database listener port number:
```
Enter the PeopleSoft database port [1521]:
```
Enter the PeopleSoft Connect ID at the following prompt:

The default is people.
```
Enter the PeopleSoft database Connect ID [people]:
```
Enter a password for the PeopleSoft Connect ID, and enter again on the next line, at the following prompt.

See E-DPK - PeopleTools 8.59 and later - DPK setup does not support some special characters for passwords (My Oracle Support, Article ID KB300834).
```
Enter the PeopleSoft database Connect ID [people] password.
Ensure that the password meets the length and complexity requirements
for your database platform:
Re-Enter the PeopleSoft database Connect ID password:
```
Enter the PeopleSoft user ID (operator ID), such as PS or VP1.
```
Enter the PeopleSoft database Operator ID [VP1]:
```

Enter the password twice for the PeopleSoft operator ID.

Enter the PeopleSoft database Operator ID [VP1] password.
Ensure that the password is between 1 and 32 characters in length.
You may include these special characters !@#$%^& :
Re-Enter the PeopleSoft database Operator ID password:

Enter the Application Server Domain Connection password, following the guidelines in the prompt.

Note:

This is an optional password. If no password is entered, the connection between Web Server and Application Server will not be password protected.

[Optional] Enter a new Application Server Domain connection password.
Ensure that the password is between 8 and 30 characters in length.
You may include these special characters !@#$%^& :
Re-Enter the Application Server Domain connection password:

Enter y to continue with the script.

Are you happy with your answers? [y|n]: y
Encrypting the Passwords in the User Data:                  [  OK  ]
Updating the Puppet Hiera YAML Files with User Data:        [  OK  ]

If you want to continue running the initialization script using the default configuration, answer y (yes) to the following prompt, and continue with the next step.

If you want to customize the PeopleSoft environment using the Puppet YAML files, answer n (no) to stop the script.

The bootstrap script is ready to deploy and configure the PeopleSoft
environment using the default configuration defined in the Puppet
Hiera YAML files. You can proceed by answering 'y' at the following
prompt. And, if you want to customize the environment by overriding
the default configuration, you can answer 'n'. If you answer 'n', you
should follow the instructions in the PeopleSoft Installation Guide
for creating the Hiera YAML file 'psft_customizations.yaml' 
and running the psft_puppet_apply script to continue with 
the setup of the PeopleSoft environment.

Do you want to continue with the default initialization process? [y|n]:

Review the status messages as the script runs Puppet profiles to set up the PeopleSoft environment.

A message of [ OK ] indicates that the profile has been applied successfully while a message [FAILED] indicates that the profile application failed.

Upon successful completion, the DPK setup script displays the following message:
```
The PeopleSoft Environment Setup Process Ended.
```
The complete setup log is written to the file psft_dpk_setup.log in the same location as the DPK setup script.