The PingAccess configuration database is protected by a file password and a user password. These passwords both default to 2Access, but should be changed for production environments.

Note:

To change either password, stop PingAccess.

  1. Open a terminal window and change to the <PA_HOME>/bin directory.
  2. To ensure the JAVA_HOME environment variable is set correctly, enter the command echo $JAVA_HOME.
  3. To ensure the proper Oracle Java executable is in your path, enter the command java -version.
    Note:

    If this command returns a value indicating that the Java executable is not a supported version of Oracle Java, correct this issue before continuing.

  4. Stop PingAccess.
  5. Optional: Change the database file password:
    • If you are using Windows, run this command and note the output: dbfilepasswd.bat <old_password> <new_password>.
    • If you are using Linux, run this command and note the output: ./dbfilepasswd.sh <old_password> <new_password>.
    1. On all operating systems, update the pa.jdbc.filepassword property in <PA_HOME>/conf/run.properties with the obfuscated password output from the command given above.
  6. Optional: To change the database user password:
    • If you are using Windows, run this command and note the output: dbuserpasswd.bat <file_password> <old_password> <new_password>
    • If you are using Linux, run this command and note the output: ./dbuserpasswd.sh <file_password> <old_password> <new_password>
    1. On all operating systems, update the pa.jdbc.password property in <PA_HOME>/conf/run.properties with the obfuscated password output from the command given above.
  7. Restart PingAccess.