Appendix A - CBS Registry Password Utility

This new release of CBS no longer uses the IFS Gateway for its connection to the database. As a result the security information that was required for IFS Gateway has changed. A new feature of this release is the ability to store the database logon information in an encrypted form in the registry. There is also an option to store the logon information in clear text if security is not an issue or is inconvenient as the case may be for test environments.

The CBS Server installation program will store the logon information in an encrypted format in the registry by default, but also provides an option to use unencrypted passwords. Should you have the need to change the username or password in the future, the CBS Registry Password Utility should be used. This utility is installed in the same directory as the Scheduling Server or Bridge. This utility locates the registry keys associated with a previously installed Scheduling Server or Communication Bridge and writes new values for the username and password to the registry in either clear text or encrypted form (Figure A-1).

Run the utility by double clicking on PasswordUtility.exe in Windows Explorer. You will see the following dialog:

Figure A-1 CBS Registry Password Utility

This utility works for both the Scheduling Server and Communication Bridge. The first edit field allows you to specify the name of the CBS server executable as it was installed by the setup program. The second edit field is for entering the name of a previously installed Communication Bridge.

Note: you will only use one of these fields at a time. The utility cannot modify values for both a CBS Server and a Communication Bridge at the same time.

If you wish to change the logon information for a previously installed CBS Server, enter the name here, which will be in the format CBS_<DATABASE>_<SITE>, where <DATABASE> is the alias for the database to which the scheduling server connects and the <SITE> is the name of the site for which the CBS Server is running.

If you wish to change the logon information for a previously installed Communication Bridge, enter the name of the database that the bridge services in the second edit field.

Note: that the text below the first two edit fields will change as you enter text. When the utility starts the first edit field caption says “Enter a server name”. As you type, it attempts to locate the registry entries for the name you are entering and if it does not find any, the text will say “Registry entries do not exist for given server name.” Once you have entered the complete name of a valid CBS database and site configuration, you should see the text state “Server name verified”. Now the registry keys have been found for your entry and you may update the logon information in the last two edit fields. Similarly for the Bridge, the initial text will say “Enter database name for desired Bridge settings”. As you begin to type the name of the database the utility will attempt to locate the associated Bridge keys in the registry and the text will say “Registry entries do not exist for given bridge” until you enter a valid name for the database when the text will change to “Bridge name verified”. Then it is ready to write new logon information for the given Bridge.

Enter the database logon name in the third edit field which is labeled Logon name for CBS Server to use to connect to the database and the corresponding password in the last edit field labeled Password for CBS Server to use to connect to the database. Enable the check box for Encrypt Logon Information if you want the new logon information to be encrypted in the registry, and then click on OK. The utility will update the values in the registry.