Update the P4 Search configuration

After you install P4 Search and complete the initial configuration, you can update the configuration by using the P4 Search UI or one of the properties files. To learn whether to set a configurable in the P4 Search web UI or in one of the local properties files, see the Configure from column in the configurable table in the P4 Search configuration reference topic.

You must have admin permissions to configure P4 Search.

Configure P4 Search from the web UI

  1. Log in to the P4 Search web UI with P4 Server credentials that are administrator level or higher.

  2. On the upper toolbar, click Account and then click Configure.

    The Configuration page opens.

  3. Choose a configurable and click the arrow Dropdown arrow to expand it.

  4. Make your changes.

    To install or delete an extension, switch the toggle on or off.

  5. Click Apply.

Configure P4 Search locally

You can check which file a configurable is stored in by checking the Configure from column in the tables in the P4 Search configuration reference page.
  1. Locate the configuration file, which is typically located in one of the following directories:

    • Linux:

      • /opt/perforce/helix-p4search/etc/service.properties

      • /opt/perforce/helix-p4search/etc/default.config.properties

    • Windows: 

      • C:\Program Files\Perforce\P4Search\service.properties

      • C:\Program Files\Perforce\P4Search\default.config.properties

    The location of the configuration file can be changed and might be different in your system environment.

  2. Choose a configurable and change its value. For example, to change the port of the P4 Server connection, you could update the following configurable:

    com.perforce.p4search.core.p4port=localhost:1666

    The updated configurable might look like this:

    com.perforce.p4search.core.p4port=perforce.com:1666

  3. Save the configuration file.

  4. Restart the P4 Search service by running the following command as root:

    sudo systemctl restart p4search.service

Related topics

For a full list of P4 Search configurables, see P4 Search configuration reference.