Upgrade P4 Search

This section describes how to upgrade a P4 Search installation to a newer release.

Before upgrading P4 Search:

  • Check the requirements for your current version of P4 Search and for the version you are upgrading to.

  • Consider backing up your existing P4 Search installation.

Version requirements

If you have 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 View status.

When upgrading P4 Search:

  • If you are upgrading Elasticsearch, you must upgrade the P4 Plugin Filter to the same version and then restart Elasticsearch. See Upgrade Elasticsearch.

  • If you are upgrading to P4 Search 2025.1, you must also upgrade to P4 Render 2025.1.

  • If you are upgrading to P4 Search 2024.3, you must also upgrade to P4 DAM 2024.5 or later.

  • If you are upgrading to P4 Search 2024.2 or earlier, only P4 DAM 2024.4 or earlier is supported.

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

    /opt/perforce/helix-p4search/jre

Upgrade P4 Search on Linux

To upgrade P4 Search for Linux:

  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 green by navigating to the service status page. You might need to log in to view the page:

    http://myhelixsearch.mydomain.com:1601/p4search/settings/status

    For more information about the service status page, see Check service status.

    If the service status page fails to open, see Service status page fails to open.

Upgrade P4 Search on Windows

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

  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 green by navigating to the service status page. You might need to log in to view the page:

    http://myhelixsearch.mydomain.com:1601/p4search/settings/status

    For more information about the service status page, see Check service status.

    If the service status page fails to open, see Service status page fails to open.