4.7 Changing the Agent User Password

When the Messaging Agent and Archive Agent are installed, the user’s eDirectory password that is used to read the configuration that starts the agents is stored in the startup file for each agent. Prior to Messenger 2.0.2 Hot Patch 1, this password was stored in plain text. By default in Messenger 2.0.2 Hot Patch 1, the password is obfuscated to prevent the password from being read.

If you want to check whether the password has been obfuscated, look in the startup files. The password is prepended with $$: if it has been obfuscated.

The NMPassword utility is used to change the password in the startup file for both the Messaging Agent and the Archive Agent.

For additional information on how to use NMPassword, see Section 2.4, Changing the Agent User Password.

4.7.1 Changing the Agent User Password on NetWare or Windows

Before starting to use the utility, you must verify the following prerequisites:

  • If you are changing the password on a NetWare server, a drive must be mapped to the location of the startup file.

  • If you are using the utility on a workstation and changing the password on a Windows server, a drive must be mapped to the location of the startup file.

To change the password:

  1. In Windows, click Start > Run, then enter cmd to open a command window.

  2. Use the following command to change the password:

    c:\gwm202\server\utility\nmpwd\nmpwd.exe --startup=<path to startup file> --password=<new password>

    Replace c:\gwm202 with the location where the hot patch files extracted.

4.7.2 Changing the Agent User Password on Linux

  1. After installing Messenger 2.0.2 Hot Patch 1, change to the /opt/novell/messenger/bin/ directory.

    For complete instructions on installing Messenger 2.0.2 Hot Patch 1, see the Messenger 2.0.2 Readme file located on the Novell Messenger 2.1 Web site.

  2. Become root by entering sux and the root password.

  3. Use the following command to change the password:

    ./nmpwd --startup=<path to startup file> --password=<new password>