Preparing to Run the CMAK Wizard
Updated: April 8, 2009
Applies To: Windows 7, Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server 2008 Foundation, Windows Server 2008 R2, Windows Server 2012, Windows Vista
You run the CMAK wizard to create a connection 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.
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 connection profile. For more information, see Installing and Starting the Connection Manager Administration Kit Wizard.
Editing the templates
Before you use the CMAK wizard to build a connection 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 connection 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 connection profiles, you should create a separate worksheet for each profile to be built. To simplify building a connection profile similar to one you already have, you can duplicate the existing connection profile and edit it as appropriate.
To build a new connection profile from an existing profile
On the Create or Modify a Connection Manager Profile page, click Existing profile, and then select the appropriate existing profile from the drop-down list.
On the Service and File Names page, specify a new service name and file name for the new profile.
Proceed through the wizard, changing any specific options as appropriate, to build the new connection profile.
The existing connection profile is not affected, as long as you specify a different service name and file name for the connection 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 connection profile. If you specify a new file name but do not specify a new service name, users who have the existing connection profile installed and then install the new connection profile will experience problems in connecting using the connection profile.
Updating and editing existing connection profiles
When you create a connection profile, the CMAK wizard copies all incorporated files into the CMAK folder for that connection profile (Program Files\CMAK\Profiles\OperatingSystemType\ProfileFileName). 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 folder and then run the wizard again to update the connection 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.
When you edit an existing connection profile that was created with an earlier version of the Connection Manager Administration Kit, the CMAK wizard automatically updates the profile to the newer version. 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 connection profile, the wizard attempts to use the latest version of the merged connection profile. If the CMAK wizard cannot find the merged connection profile in the \Program Files\CMAK\Profiles<EM>OperatingSystemType<EM>ProfileFileName folder, it defaults to the current version of the merged connection profile, originally stored with the connection profile that you are editing.