Upgrading Interactively on Microsoft Windows

Use this process to upgrade an existing installation of OpenSearch 2.3.0 or 2.11.0 to OpenSearch 3.2.0 using the OSK DPK setup script interactively.

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.

1. Download the current OSK DPK and save it in a newly created directory, referred to here as OSK_INSTALL.

2. Go to OSK_INSTALL.

3. 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

4. Open a command prompt.

5. Change directory to OSK_INSTALL/setup.

6. Run the DPK setup script with these options:

   psft-dpk-setup.bat --full_upgrade --install_base_dir OSK_BASE_DIR
   

   • For the install_base_dir option, specify the full path to where you want OpenSearch installed. For example:

     psft-dpk-setup.bat --full_upgrade --install_base_dir C:\opensearch

   • Use double-dashes when specifying the script options; for example, --full_upgrade.

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

   You've chosen to do an upgrade, it'll bring down the opensearch for a while, do you still want to continue with the ugprade? (y/n): y
   

8. Enter the path to the current OS_HOME, such as C:\opensearch2110\pt\opensearch–2.11.0:

   Enter the path to current OS_HOME[<base_dir>/pt/opensearch-2.11.0]: C:\opensearch2110\pt\opensearch-2.11.0

9. Enter the current OpenSearch user name, such as osadmin:

   Enter the current OpenSearch username: osadmin
   

10. Review the status messages as the script stops and upgrades the existing OpenSearch.

    
    Cleaning up security cache
    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]
    SUCCESS: Specified value was saved................[OK]
    Starting OpnSearch Server..........................[OK]
    Checking whether OpenSearch service is running.....[OK]
    OpenSearch service is running......................[OK]
    Registering and Deploying models...................[OK]
    Cluster is ready...................................[OK]
    ml_backup_repo created successfully................[OK]
    Smapshot restore completed successfully............[OK]
    ML index ready.....................................[OK]
    All model deployment completed.....................[OK]
    Mapping updates for all eligible indices...........[OK]
    Opensearch Upgrade Completed.......................[OK]