Test for production readiness

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

To test for production readiness

  1. Create a test phone book, add one or more POPs, and then publish the phone book.

  2. On the Phone Book Service (PBS) host, browse to \Program Files\Phone Book Service\Data and verify the presence of a new data folder named for the phone book and containing a .cab file.

  3. Using the Connection Manager Administration Kit, create a service profile that is set to download this phone book from the correct PBS host. Do not include the phone book files when you create this profile.

  4. Install the new service profile on your test client computer.

  5. Edit the Connection Manager service provider (.cms) file to prevent automatic deletion of the .tmp file created during a phone book download:

    1. Using Notepad on the test client computer, open the .cms file.

    2. Edit the key 0=cmdl32.exe %profile% located in the [Connect Actions] section by typing /no_delete. After editing, the section should appear as follows:

      [Connect Actions]
0=cmdl32.exe %profile% /no_delete

    3. Save the edited .cms file, and use the profile to connect Connection Manager to Connection Point Services.

    4. Once a connection is established and information is downloaded, disconnect from the server.

  6. Using Notepad on the client computer, open the .tmp file and verify that PBS is working properly. The name of the .tmp file varies, but it is located in the same directory as the .cmp file of the service profile. The directory will likely contain more than one .tmp file. The .tmp file created by a successful phone book download should contain control characters and file names such as [phone_book].pbk. If PBS is not working properly, all the .tmp files will contain error messages.

  7. Open Connection Manager and verify whether the phone book appears when you click Phone Book.

Notes

  • You must be logged on as a member of the Administrators or the Power Users group to complete this procedure. If your computer is connected to a network, network policy settings might also prevent you from completing this procedure.

  • Do not open your .tmp file before disconnecting from the server. Doing so could prevent a proper phone book update.

  • You can simulate a client request by typing the following in the browser Address box on the test client computer and then pressing ENTER:

    https://localhost/pbserver/pbserver.dll?osarch=0&ostype=0&osver=1&cmver=1&lcid=1033&pbver=0&pb=[phone_book_name]

    For example, if the phone book name is Awesome, you would type:

    https://localhost/pbserver/pbserver.dll?osarch=0&ostype=0&osver=1&cmver=1&lcid=1033&pbver=0&pb=Awesome

    If you want to see Phone Book Service error messages while you simulate client requests, you must turn off the display of friendly HTTP error messages in Internet Explorer. On the Tools menu, click Internet Options, and click the Advanced tab. Clear the Show friendly HTTP error messages check box.

  • If your .tmp file does not contain a phone book, the following list might help you identify areas for further investigation.

    • An empty .tmp file indicates that the phone book request did not generate a response from the PBS host.

    • An error number of 5xx typically indicates that PBS is not installed or is not running.

    • An error number of 4xx typically indicates that you requested a phone book that did not exist in the PBS database.

    • An error number of 204 indicates that the client phone book version number is high enough that you do not need a phone book update.

Information about functional differences

  • Your server might function differently based on the version and edition of the operating system that is installed, your account permissions, and your menu settings. For more information, see Viewing Help on the Web.

See Also

Concepts

Add or edit a POP
Add a new phone book by command line
Set or edit phone book options by command line
Add, edit, or delete POPs by command line
Publish a phone book
Publish a phone book by command line
Set permissions early
Safeguard your files
Major components and their roles
Administer phone books
Connection Point Services Troubleshooting
Connection Manager Administration Kit