Preparing to run the CMAK wizard

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

Preparing to run the CMAK wizard

You run the Connection Manager Administration Kit (CMAK) wizard to create a service profile. As you step through the wizard, you are prompted to select customizable options and type the location of customized elements that you have prepared. Before you can run the wizard, you must set it up on your computer and ensure that all custom elements are available. To help prepare for creating a service profile, you can complete the planning worksheet that is available in the Microsoft Windows Server 2003 Resource Kit. For more information about Connection Manager, see "Deploying Remote Access Clients Using Connection Manager" at the Microsoft Windows Resource Kits Web site.

Setting up the CMAK wizard

No set up of the CMAK wizard is required once it is installed, but before running the CMAK wizard, make sure that you have read the information in the readme file (CMAKRead.htm) to ensure that you understand any restrictions on how to use the CMAK wizard to set up your service profile. For more information, see The Connection Manager Administration Kit Wizard.

Editing the templates

Before you use the CMAK wizard to build a service profile, locate the advanced customization information provided by the network administrator or other technical lead. Advanced customization of the templates must be done before you run the wizard. For more information on editing the template files, see Advanced Customization.

Setting up a folder for custom elements

All custom elements prepared by you and other members of your team must be accessible as you run the CMAK wizard. Create a folder in which to place all custom files to be incorporated into the service profile. Using a single location for custom elements makes it easier to build profiles when you run the CMAK wizard. You might want to set up a folder at a network location so your team can share a common location to save and access files as they develop the custom elements.

Creating multiple customized versions

To build multiple service profiles, you should create a separate worksheet for each profile to be built. To simplify building a service profile similar to one you already have, you can duplicate the existing service profile and edit it as appropriate.

To build a new service profile from an existing profile
  1. In the Service Profile Selection pane, click Existing profile, and then select the appropriate existing profile from the drop-down list.

  2. In the Service and File Names pane, specify a new service name and file name for the new profile.

  3. Proceed through the wizard, changing any specific options as appropriate, to build the new service profile.

Important

  • The existing service profile is not affected, as long as you specify a different service name and file name for the service profile you are building. If you do not specify a new file name, the CMAK wizard will prompt you that you want to overwrite the existing service profile. If you specify a new file name but do not specify a new service name, users who have the existing service profile installed and then install the new service profile will experience problems in connecting using the service profile.

Updating and editing existing service profiles

When you create a service profile, the CMAK wizard copies all incorporated files into the CMAK folder for that service profile (Program Files\CMAK\Profiles\ServiceProfileFileName). When you edit an existing profile, the wizard always pulls the incorporated files from this CMAK folder. To make changes to the incorporated files, you can either edit the incorporated file in this CMAK folder and then run the wizard again to update the service profile, or you can start the wizard, delete the referenced files, add the updated file by browsing to it, and then finish running the wizard.

Notes

  • When you edit an existing service profile created with a previous version of the Connection Manager Administration Kit, the CMAK wizard automatically updates the profile. Any changes you have made manually to the .inf file (using advanced customization techniques) will not be retained in the upgraded file. However, the CMAK wizard creates a backup of the old .inf file before creating the updated file.

  • When you use the CMAK wizard to edit a top-level service profile, the wizard attempts to use the latest version of the merged service profile. If the CMAK wizard cannot find the merged service profile in the \Program Files\CMAK\Profiles\ServiceProfileFileName folder, it defaults to the current version of the merged service profile, originally stored with the service profile that you are editing.