PingOne

Upgrading the PingOne LDAP Gateway

Use the following information to update the PingOne LDAP Gateway, such as from version 2.3.0 to version 2.3.1. You’ll uninstall the old version before installing the new one.

Steps

  1. In the PingOne admin console, go to Integrations → Gateways.

  2. Click the appropriate gateway entry to open the details panel.

  3. Click the Download tab.

  4. Click the download link to download the ZIP archive for version 2.3.1.

  5. Extract the ZIP archive to the computer that will run the gateway.

    We recommend that you use a common location as the parent directory, such as C:\Program Files\Ping Identity.

  6. Configure the run.properties file, including providing the gateway credential information.

    The run.properties file is located in the config directory. For example: C:\Program Files\Ping Identity\pingone-ldap-gateway-2.3.1\config.

  7. Uninstall the old version of the gateway before installing the new one.

    1. Start the Services system application and find the LDAP Gateway 2.3.0 service.

    2. Right-click and select Properties.

    3. Note the Path to executable value.

      For example, if the value is C:\Program Files\Ping Identity\pingone-ldap-gateway-2.3.0\bin\windows\ldap-gateway-windows-x86-64.exe -s C:\Program Files\Ping Identity\pingone-ldap-gateway-2.3.0\bin\windows\PingOneLdapGatewayService.conf

      then you can find the uninstall-service.bat file in the C:\Program Files\Ping Identity\pingone-ldap-gateway-2.3.0\bin\windows directory.

    4. Optional: Start the Services system application and stop the LDAP Gateway 2.3.0 service.

    5. Run the uninstall-service.bat file for the LDAP Gateway 2.3.0 service, without any parameters. The underlying directories and files are not removed. Make backup copies and remove the files as needed.

  8. After you have uninstalled the old version, you can finish installing the new one.

    1. Locate the install-service.bat file for the LDAP Gateway 2.3.1 service.

    2. Run the install-service.bat file without any parameters.

      By design, the install-service.bat file does not start the service automatically after completion. However, the service is configured to start automatically at the next and subsequent restarts of the Windows operating system.

    3. In the Services system application, start the new PingOne LDAP Gateway 2.3.1 service.