Using the PeopleTools Middleware DPK when Installing OpenSearch and OpenSearch Dashboards on Linux

Use the PeopleTools Middleware DPK along with the installation to apply up-to-date JDK.

Use this procedure on physical or virtual Linux hosts. Ensure that there is enough space on the host for the OpenSearch installation and your estimated indexing requirements.

Make a note of the values you supply for ports, passwords, and so on. When you configure the OpenSearch instance for PeopleSoft, the values must match those specified here.

Download the required OSK DPK for Linux, OSK_FILENAME.zip, and saved it in a newly created directory accessible to the Linux host, referred to as OSK_INSTALL

Extract the opensearch-manifest from the OSK DPK.

See Obtaining the OSK DPK.
Download the latest PeopleTools Middleware DPK for Linux, and save it in the same OSK_INSTALL.

For the OpenSearch installation you need only the first PeopleTools Middleware DPK, PT-MW-DPK-LNX-8.63-<DATE>_1of2.zip.

Extract the ptmw-manifest and compare it with the opensearch-manifest to determine whether to continue with this procedure. Use the information in the PeopleTools Middleware DPK installation guide.

See PeopleTools Middleware Deployment Package Installation (PeopleSoft PeopleTools 8.63), PeopleSoft PeopleTools on the Oracle Help Center, Install and Upgrade, https://docs.oracle.com/en/applications/peoplesoft/peopletools/index.html
Open a terminal window.
Go to OSK_INSTALL.
Extract the entire contents of OSK_FILENAME.zip into the same directory, OSK_INSTALL.

It is a good idea to extract into the same directory where you downloaded the zip files, and to extract into an empty directory for each new installation. The extracted directories and files are:
- setup directory — includes the setup script and a silent installation sample
- archives directory — includes archives for deployment
- readme.txt file
- opensearch–manifest — lists the versions of OpenSearch and JDK
Verify that OSK_INSTALL contains the extracted files and PT-MW-DPK-LNX-8.63-<DATE>_1of2.zip file.
```
setup/
archives/
readme.txt
opensearch-manifest
PT-MW-DPK-LNX-8.63-<DATE>_1of2.zip
```
Note:

After you have extracted the OSK_FILENAME.zip you can delete it, move it, or leave it in OSK_INSTALL. Ensure that the intact PT-MW-DPK-LNX-8.63-<DATE>_1of2.zip is present as shown here.
Change directory to OSK_INSTALL/setup.
Run the DPK setup script with these options:
```
./psft-dpk-setup.sh --install --install_base_dir BASE_DIR
```
- For the install_base_dir option, specify the full path where you want OpenSearch installed. The installation directory is referred to in this documentation as BASE_DIR; for example:
```
./psft-dpk-setup.sh --install --install_base_dir /home/opensearch
```
- Use double-dashes when specifying the script options; for example, --install.

Answer y (yes) to install OpenSearch, or n (no) to exit.

You've chosen to do a fresh installation of Opensearch, Logstash 
and Opensearch-dashboards. 
Do you want to install Opensearch? (y/n): y

Verify that you see the progress message for the PeopleTools Middleware DPK:
```
Extracting PTMW DPK
[OK]
```
Answer the remainder of the prompts as mentioned in the previous section, Installing OpenSearch and OpenSearch Dashboards on Linux Interactively.

Wait until the installation is complete.

Checking whether OpenSearch service is running.......
Extracting the new OpenSearch Dashboards Binary........[OK]
Configuring OpenSearch Dashboards......
OpenSearch Dashboards Keystore updated.................[OK]
OpenSearch Dashboards installation is completed.

After you complete the OpenSearch and OpenSearch Dashboards installation, you must configure the integration with the PeopleSoft environment.

See "Integrating OpenSearch with the PeopleSoft Environment."
To start and use OpenSearch Dashboards, see the Search Technology product documentation.

See PeopleTools: Search Technology, "Working with Insights Dashboards for PeopleSoft Application Data."

A successful deployment includes the following:

The OpenSearch home directory is found in BASE_DIR/pt/opensearch–3.2.0.
The OpenSearch data and logs directories are installed to the locations you specified.
The OpenSearch Dashboards home directory is found in BASE_DIR/pt/opensearch-dashboards-3.2.0
Java is installed to BASE_DIR/pt/os_jdk21.0.yy, where yy is the JDK version.

The JDK is the version supplied by the PeopleTools Middleware DPK.
The JAVA_HOME environment variable is set to BASE_DIR/pt/os_jdk21.0.yy.

This environment variable is set at the system level.