Applicable Product:

Peoplefluent Learning

Applicable Version:

All Versions


Summary:

When a new LMS license is applied, all encrypted passwords configured in ekp.properties must be temporarily reverted to non-encrypted (plain text) values. This is required because encrypted passwords in the LMS are license-dependent. Once the system initializes successfully with the new license, administrators can regenerate the encrypted values using the built-in encryption tool.

This article explains why this is required and provides step-by-step instructions to safely complete the process.

Why Is This Required?

Encrypted passwords in the LMS are generated using an encryption mechanism that is tied to the active license. When the license changes:

• Previously encrypted passwords become invalid

• The system may fail to initialize or connect to required services

• Configuration errors may occur if encrypted values are left unchanged

To prevent these issues, passwords must be temporarily stored in plain text during license application and then re-encrypted afterward.

When Should This Be Done?

This process must be followed every time:

• A new license is applied

• A license is renewed or replaced

• The LMS license key is changed in any way

Step 1: Update ekp.properties with Plain Text Passwords

1. Locate the ekp.properties file on the LMS server.

2. Identify all properties that currently contain encrypted passwords.

3. Replace each encrypted value with its corresponding plain text password.

4. Save the file.

⚠️ Important:
Ensure this file is handled securely and access is restricted, as it temporarily contains sensitive credentials.

Step 2: Apply the New License

1. Apply the new LMS license according to standard procedures.

2. Start or restart the LMS service.

3. Allow the system to fully initialize.

4. Verify that the LMS starts successfully without errors.

Step 3: Re-Encrypt Passwords via the LMS UI

Once the LMS is up and running with the new license:

1. Log in as an Admin

2. Navigate to:
   Manage Center → System → Encrypt Password

3. Use the encryption tool to generate new encrypted values for each password.

4. Copy the newly generated encrypted passwords.

Step 4: Update ekp.properties with New Encrypted Values

1. Open the ekp.properties file again.

2. Replace the plain text passwords with the new encrypted values.

3. Save the file.

4. Restart the LMS service.

Step 5: Verification

After restart:

• Confirm the LMS starts normally

• Validate integrations, database connections, and scheduled jobs

• Ensure no authentication or configuration errors are reported