Upgrading to a New Revision on Linux Interactively

Use this process to upgrade an existing installation of OpenSearch and OpenSearch Dashboards to a later OSK DPK revision using the DPK setup script interactively. For example, if you installed using OSK-DPK-LNX-3.2.0.863_01.zip, you can upgrade to OSK-DPK-LNX-3.2.0.863_02.zip or later.

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

  2. Open a terminal window.

  3. Change directory to OSK_INSTALL.

    cd OSK_INSTALL
    
  4. 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

  5. Open a command prompt.

  6. Change directory to OSK_INSTALL/setup.

  7. Run the DPK setup script with these options:

    ./psft-dpk-setup.sh --upgrade --install_base_dir BASE_DIR
    
    • For the install_base_dir option, specify the full path to the existing OpenSearch installation. The installation directory is referred to in this documentation as BASE_DIR; for example:

      ./psft-dpk-setup.sh --upgrade --install_base_dir /home/opensearch
    • Use double-dashes when specifying the script options; for example, --upgrade.

  8. 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
    
  9. Review the status messages as the script stops and upgrades the existing OpenSearch.

    Stopping Opensearch server....................[OK]
    Extracting the new Opensearch Binary..........[OK]
    Upgrade in process............................[OK]
    Cleaning up...................................[OK]
    Starting Opensearch server....................[OK]
    
    Opensearch Upgrade Completed.
  10. Answer y (yes) to upgrade OpenSearch Dashboards, or n (no) to exit.

    Do you want to upgrade Opensearch-dashboards: (y/n): y
    

    The script displays progress messages.

    Opensearch service is running. 
    Proceeding with the Opensearch-dashboards installation.
    Extracting the new Opensearch-dashboards Binary .......[OK]
    Upgrade in process.....................................[OK]
    Opensearch-dashboards Upgrade Completed.