Upgrading OpenSearch from 2.3.0 or 2.11.0 to 3.2.0 in Silent Mode
You can use the setup script to upgrade OpenSearch in silent mode on either Microsoft Windows or Linux by preparing a text file that includes details about the current installation. It is not necessary to reindex after upgrading.
Note:
The upgrade does not include OpenSearch Dashboards or Logstash. Instead, you must perform a new installation of OpenSearch Dashboards and Logstash and start them manually.
Note:
You have the option to use the PeopleTools Middleware DPK to obtain the latest JDK when upgrading.
To upgrade in silent mode:
-
Download the current OSK DPK and save it in a newly created directory, referred to here as OSK_INSTALL.
-
Open a terminal window.
-
Change directory to OSK_INSTALL.
cd OSK_INSTALL -
Extract the entire contents of OSK_FILENAME.zip in the same directory, OSK_INSTALL.
Note:
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 extraction creates the following directories and files in OSK_INSTALL:
-
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
-
-
Change directory to OSK_INSTALL/setup.
-
Create a configuration file.
The OSK_INSTALL/setup directory includes a sample configuration file, silentinstall.config. If you want to use this file, it is a good idea to make a backup copy of the original file before you continue.
-
To indicate that you do not want to install OpenSearch, OpenSearch Dashboards, or Logstash, enter n (no) to these questions:
Note:
This sample shows only a few lines from the silentinstall.config file.
#Install opensearch Y/N is mandatory field Install opensearch?[Y/N]= n ############################################### #Install Logstash Y/N is mandatory field Install Logstash?[Y/N]= n #################################################### #Install Opensearch-dashboards Y/N is mandatory field Install opensearch-dashboards?[Y/N]= n -
Enter y (yes) to indicate you want to upgrade OpenSearch.
You must enter a value for this field.
##############Silent Upgrade Configuration Values for upgrading OpenSearch from 2.3.0/2.11.0 to 3.2.0 ################ #Upgrade OpenSearch Y/N is mandatory field Upgrade OpenSearch?[Y/N]= y -
Edit the configuration file with the location (current.os.home) and user name (current.osuer) for the current OpenSearch 2.3.0 or 2.11.0 installation.
You must enter values for both of these fields.
#Current OpenSearch home path in the format [<base_dir>/pt/opensearch-2.3.0] (mandatory) current.os.home= #CurrentOpenSsearch username (mandatory) current.osuser= -
On Microsoft Windows, in a command prompt window, run the DPK setup script from OSK_INSTALL/setup as follows:
Note:
The command here includes line feeds for readability. Do not include the line feeds when you run.
psft-dpk-setup.bat –-full_upgrade_silent --install_base_dir <OSK_BASE_DIR> --config_file <full_path_configuration_file>-
Use double-dashes when specifying the script options; for example,
--full_upgrade_silent. -
For OSK_BASE_DIR, supply the location for OpenSearch 3.2.0.
-
For the config_file option, specify the full path to the prepared configuration file. For example:
Note:
The command shown here includes line feeds for readability. Do not include the line feeds when you run.
psft-dpk-setup.bat –-full_upgrade_silent --install_base_dir C:/opensearch --config_file C:/tmp_install/silentinstall.config
-
-
On Linux, in a terminal window, run the DPK setup script from OSK_INSTALL/setup as follows:
Note:
The command shown here includes line feeds for readability. Do not include the line feeds when you run.
./psft-dpk-setup.sh –-full_upgrade_silent --install_base_dir <OSK_BASE_DIR> --config_file full_path_configuration_file-
Use double-dashes when specifying the script options; for example,
--full_upgrade_silent. -
For OSK_BASE_DIR, supply the location for OpenSearch 3.2.0
-
For the config_file option, specify the full path to the prepared configuration file. For example:
Note:
The command shown here includes line feeds for readability. Do not include the line feeds when you run.
./psft-dpk-setup.sh –-full_upgrade_silent --install_base_dir /home/opensearch --config_file /home/tmp_install/silentinstall.config
-
-
Wait until you see a message indicating the upgrade is complete.
Stopping OpenSearch server ...............[OK] Extracting the new OpenSearch Binary .....[OK] Extracting the new JDK ...................[OK] Upgrading OpenSearch .....................[OK] Configuring OpenSearch ...................[OK] Starting OpenSearch server ...............[OK] Checking if OpenSearch service is running. OpenSearch is running......................[OK] Cleaning up security cache.................[OK] OpenSsearch Upgrade Completed.