Change EnterWorks System Password After Installation

There are two “system” users in EnterWorks:

  • The admin user for the EnterWorks UI.

  • The admin user for EPX.

Both default to the system password.

In the following steps, if any of the passwords you are replacing are encrypted, use the following script to encrypt the new passwords.

<drive>:\Enterworks\EnableServer\bin\getEncryptedString.bat

To change the EnterWorks UI system password:

  1. Change the password using the New UI.

  2. Change the password in the affected micro-services.

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

    <install-drive>:\EnterWorks\enable2020\services\bin\<service-name>.exe -h
    1. The create-<service-name>-service.cmd scripts should exist in the following folder. If they do not, create the create-service scripts.

      <drive>:\Enterworks\enable2020\services\install
    2. Edit create-enable-channel-readiness-service.cmd. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

      -systemLogin=
      -systemPassword=
    3. Edit create-enable-web-server-service.cmd. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

      -systemLogin=
      -systemPassword=
    4. Edit create-enable-dam-manager-service.cmd. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

      -systemLogin=
      -systemPassword=
    5. Edit create-enable-monitor-dam-drop-service.cmd. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

      -systemLogin=
      -systemPassword=
  3. Configure the Utilities with the new passwords:

    1. Set the passwords for RegenerateDAMVariant.

      1. Open for editing:

        <drive>:\Enterworks\Utilities\RegenerateDAMVariant\regenerate-variant-config.json
      2. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

        systemLogin
        systemPassword
    2. Set the passwords for MonitorDAMDrop:

      1. Open for editing:

        <drive>:\Enterworks\Utilities\MonitorDAMDrop\MonitorDAMDrop-config.json
      2. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

        systemLogin
        systemPassword
    3. Set the passwords for DAMReportUtility:

      1. Open for editing:

        <drive>:\Enterworks\Utilities\DAMReportUtility\DamReportUtility-config.json
      2. Set the values of the following parameters to the new password. (If the parameters don't exist, add them.)

        systemLogin
        systemPassword
  4. Changing the password for EPX.

    There should be no need to change the EPX system user password since no one has direct access to EPX. If a security audit is done, it may show an HTML login page for EPX that allows access as user system, but this particular page is normally not needed and can be removed or moved, (as it is for the EPX web interface). If the EPX web interface is needed for troubleshooting purposes, it can be moved back into place for the duration of that activity and then re-removed.

    If the password for EPX does need to be changed, perform the following:

    1. Open the file:

      <drive>:\Enterworks\EPX\bin\conf\Enterworks.properties
    2. Assign the value of the following settings to the new password:

      epim.userName=
      epx.server.systemPassword=
    3. Open Design Console on the server hosting the EPX services.

    4. For each workflow, edit any Purge Completed Workitems BIC activity by double-clicking it or right-clicking it and selecting Properties.

      1. Open the Settings tab.

      2. Enter the new password in the Purge user password field

      3. Click OK.

    5. When you are done editing the workflow, click OK.

    6. Repeat for each workflow.

  5. Stop all services.

  6. Move to:

    <drive>:\Enterworks\enable2020\services\bin

    and run the create-service scripts as an administrator:

    • create-enable-channel-readiness-service.cmd

    • create-enable-web-server-service.cmd

    • create-enable-dam-manager-service.cmd

    • create-enable-monitor-dam-drop-service.cmd

  7. Start all services.