Change the EnterWorks System Account Password - Precisely_EnterWorks - EnterWorks - 11.0

EnterWorks Guide

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks
Precisely EnterWorks > EnterWorks
Version
11.0
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Guide
Copyright
2024
First publish date
2007
Last updated
2025-01-07
Published on
2025-01-07T07:44:20.997000
Warning: Do not change the EnterWorks or the EPX system usernames. There are many EnterWorks functions that reference these names. If you change the system usernames, these functions may become inoperable.

There are two "system" users in EnterWorks:

  • The admin user for EnterWorks (commonly called "the system user").

  • The admin user for EPX.

When EnterWorks is installed, passwords for both accounts are the same. It is a good practice to keep the passwords the same. If you change one of them, change the other to match.

To change the EnterWorks system user password:

  1. Change the password using the UI.

    If you are unable to log into the UI, change the password directly in the EPIM database:

    1. Encrypt the password using EPIM encryption.
    2. Update the B_USER table using the following SQL:
    UPDATE B_USER SET PSWD='<encryptedPassword>' WHERE LOGIN = 'system'
  2. Change the password in the affected microservices:
    Note:

    To list a microservice's parameters, run the executable with the -h option as shown in the example below.

    
            <drive>:\EnterWorks\enable2020\services\bin\<service-name>.exe -h
    1. Use File Explorer to move to:
      <drive>:\Enterworks\enable2020\services\install 
    2. Search the folder to find the create-<service-name>-service.cmd scripts that contain the setting:
      -systemPassword=<system-password>
    3. In each of the files that contain the system login setting:
      1. If -encryptedMode=true, the microservice is encrypted:
        1. Encrypt the new system password using EnterWorks encryption.
        2. Set:
          -systemPassword=<new-encrypted-system-password>
      2. Else, if -encryptedMode=false, the microservice is not encrypted. Set:
        -systemPassword=<new-unencrypted-system-password>
      3. Use each of the modified create-<service>-scripts:
    4. Configure the Utilities with the new password. For each of the files:
      • <drive>:\Enterworks\Utilities\RegenerateDAMVariant\RegenerateDAMVariant-config.json

      • <drive>:\Enterworks\Utilities\MonitorDAMDrop\MonitorDAMDrop-config.json

      • <drive>:\Enterworks\Utilities\DAMReportUtility\DamReportUtility-config.json

      edit the file:
      1. If "encryptedMode": "true", the utility is encrypted:
        1. Encrypt the new system password using EnterWorks encryption.
        2. Set:
          "systemPassword": "<new-encrypted-system-password>" 
      2. Else, if "encryptedMode": "false", the utility is not encrypted. Set:
        "systemPassword": "<new-unencrypted-system-password>" 
      3. Save and exit the file.
  3. Change the EPX-encrypted system password in the Enterworks.properties files.
    1. Open a command prompt and change the current directory to drive:\Enterworks\EPX\bin.
    2. Enter the command getEncryptedString systemPassword, where systemPassword is the new password for the system user.
    3. Copy the value returned by the command.
    4. Edit all copies of the Enterworks.properties file and set the property epx.server.systemPassword to the encrypted value copied in the Step 3d.
  4. Change the EPX System Password
  5. Restart all services.