Siebel Security Guide > Changing or Adding Passwords > Changing Passwords in the Siebel Management Framework >

Changing a Siebel User Account Password in the Siebel Management Framework

This topic describes additional steps that you must take if you change the password of a Siebel user account that accesses the Siebel Management Server or the Siebel Management Agent. These entities authenticate the Siebel user account when a Siebel user attempts to execute the Siebel Management Server or Siebel Management Agent.

If you change the password of a Siebel user as described elsewhere in Siebel Bookshelf, or if you change the Siebel administrator password as described in Changing System Administrator Passwords on Microsoft Windows or Changing the Siebel Administrator Password on UNIX, then this password change takes effect in the Siebel Enterprise only. In order for the Siebel Management Framework to authenticate the new password, you must replicate the password change in the Siebel Management Framework.

The following procedures describe how you replicate the password change in the Siebel Management Framework. Use the appropriate procedure:

• If, during the configuration of the Siebel Management Server or Siebel Management Agent, you selected RC2 encryption to encrypt the Siebel user's password, use the procedure that describes how to change RC2-encrypted passwords.
• If you did not select RC2 encryption to encrypt the Siebel user's password during configuration of the Siebel Management Server or Siebel Management Agent, use the procedure that describes how to change non-encrypted passwords.

  NOTE:  If you did not select RC2 encryption, the password that you specified during configuration of the Siebel Management Server or Siebel Management Agent was encoded using Base64 Content-Transfer-Encoding. For this reason, you must convert the plaintext of the new password to Base64 Content-Transfer-Encoding before you change it in the Siebel Management Framework.

See the Siebel Installation Guide for the operating system you are using for information about installing and configuring the Siebel Management Server or Siebel Management Agent.

To change an RC2-encrypted password in the Siebel Management Framework

1. Change the Siebel user account password. If you are changing the Siebel administrator password, see Changing System Administrator Passwords on Microsoft Windows or Changing the Siebel Administrator Password on UNIX.
2. Stop the Siebel Management Server or Siebel Management Agent for which you are going to change the password.
3. Open a command window and execute the following command:

   JRE_HOME\bin\java -cp MGTINSTALL_ROOT\lib\siebelmgr.jar com.siebel.management.util.Decoder MGTINSTALL_ROOT\security rc2_key_file_name new_password -write-properties

   where:

   • JRE_HOME is the location of the JRE home directory
   • MGTINSTALL_ROOT is the installation directory for the Siebel Management Server or the Siebel Management Agent
   • rc2_key_file_name is the location of the RC2 key file
   • new_password is the new password that you specified in Step 1

     This updates the Siebel user account password that is used to access the Siebel Management Server or the Siebel Management Agent.

     NOTE:  Siebel Management Server runs only on Microsoft Windows but Siebel Management Agent can run on either Microsoft Windows or supported UNIX operating systems.

4. Repeat Step 2 and Step 3 for all installed instances of the Siebel Management Server or Siebel Management Agents.
5. Restart the Siebel Management Server or Siebel Management Agent.

   For details, see Siebel System Administration Guide.

To change a non-encrypted password in the Siebel Management Framework

1. Change the Siebel user account password. If you are changing the Siebel administrator password, see Changing System Administrator Passwords on Microsoft Windows or Changing the Siebel Administrator Password on UNIX.
2. Stop the Siebel Management Server or Siebel Management Agent for which you are going to change the password.
3. Open a command window and execute the following command:

   JRE_HOME\bin\java -cp MGTINSTALL_ROOT\lib\siebelmgr.jar com.siebel.management.util.Base64 newPassword

   where:

   • JRE_HOME is the location of the JRE home directory
   • MGTINSTALL_ROOT is the installation directory for the Siebel Management Server or the Siebel Management Agent
   • newPassword is the plaintext of the password that you created in Step 1.

     This command converts the plaintext of the password to Base64 encoding.

     NOTE:  Siebel Management Server runs only on Microsoft Windows but Siebel Management Agent can run on either Microsoft Windows or supported UNIX operating systems.

4. Save the output of Step 3.
5. Stop the Siebel Management Server or Siebel Management Agent for which you are going to change the password.

   For details, see Siebel System Administration Guide.

6. Navigate to the MGTINSTALL_ROOT\security directory where MGTINSTALL_ROOT is the installation directory of the Siebel Management Server or Siebel Management Agent.
7. Open the security.properties file and change the value of the com.siebel.management.security.password parameter to the value that you saved in Step 4.
8. Save and close security.properties file.
9. Repeat Step 5 to Step 8 for all installed instances of the Siebel Management Server or Siebel Management Agents.
10. Restart the Siebel Management Server or Siebel Management Agent.

    For details, see Siebel System Administration Guide.