Upgrade P4 Search

You can upgrade P4 Search to a newer release. This gives you support for new features in other Perforce products and security fixes.

P4 Search 2024.2 or earlier: When you upgrade, P4 Search automatically migrates your index to the new index structure. The time taken for the migration depends on the size of your index. It can be as short as a few minutes for a small index and several hours for a large index. You can check the migration by going to the Elasticsearch Hosts service status on the P4 Search Service Status page. See Check the status of P4 Search.

During the upgrade, if you add a self-signed certificate into the Java Runtime Environment (JRE), the following JRE directory gets overwritten:

/opt/perforce/helix-p4search/jre

Before you begin

  • Upgrade the P4 Plugin Filter to the same version as P4 Search and then restart Elasticsearch. See Upgrade Elasticsearch.

  • Check the requirements for P4 Render and P4 DAM:

    • If you upgrade P4 Search, you must upgrade P4 Render to the same version..

    • If you upgrade to P4 Search 2024.3, you must also upgrade to P4 DAM 2024.5 or later. See Upgrades in the P4 DAM Documentation. If you upgrade to P4 Search 2024.2 or earlier, only P4 DAM 2024.4 or earlier is supported.

Upgrade P4 Search on Linux

Consider backing up your existing P4 Search installation before upgrading.

  1. Install the P4 Search package on the server hosting P4 Search.

    Follow the instructions for your OS distribution:

    sudo apt-get update
    sudo apt-get install helix-p4search

    sudo yum update helix-p4search

  2. Restart the P4 Search service.

    Follow the instructions for your OS distribution:

    sudo service p4search restart

    sudo systemctl restart p4search.service

  3. Check that everything is working as expected from the Service Status page. See Check the status of P4 Search. You might need to log in to view the page.

Upgrade P4 Search on Windows

To learn how to upgrade the P4 Search, P4 Server, and Elasticsearch services, watch the following video or review the instructions that come after it.

Consider backing up your existing P4 Search installation before upgrading.
  1. Download the P4 Search installer from the P4 Search download page on the Perforce website.
  2. Double click the installer to start it. When prompted, confirm that you want the installer to make changes to your computer.
  3. Select the option to update the existing installation and click Next.
  4. Accept the license agreement to continue with the upgrade and click Next.

    P4 Search is installed at the location of the existing installation.

  5. When prompted, click Yes to All to overwrite the existing setup files and retain your existing configuration.
  6. To complete the upgrade, click Finish.

  7. Check that everything is working as expected from the Service Status page. See Check the status of P4 Search. You might need to log in to view the page.