Guest

Support

Automatically Populating the Cisco Unified Communications Manager Server Address and Username

  • Viewing Options

  • PDF (116.1 KB)
  • Feedback
Automatically Populating the Cisco Unified Communications Manager Server Address and Username

Table Of Contents

Automatically Populating the Cisco Unified Communications Manager Server Address and Username

Distributing the Server Address Using a Self-Extracting Installer File

Distributing the Server Address Using Registry Key Push

Distributing the Server Address Using the Group Policy Feature on Microsoft Active Directory


Automatically Populating the Cisco Unified Communications Manager Server Address and Username


August 14, 2008

You can distribute the Cisco Unified Communications Manager server address to your Phone Designer user base using one of the following options:

1. Create a registry file that contains the Cisco Unified Communications Manager CCMCIP service address. Then create a self-extracting application installer file containing the registry file and the setup installer file, and provide this (local) installer file to the Phone Designer user base associated with this Cisco Unified Communications Manager server. When your users install the application using the (local) installer file, the Cisco Unified Communications Manager server address automatically populates.

2. Create a registry file that contains the Cisco Unified Communications Manager CCMCIP service address, and push this registry file to the Phone Designer user base using a remote desktop management tool.


Note In the registry file, in addition to configuring CCMCIP service address, you can also enable the discovery of the Phone Designer username value from the client PC.


3. Use the group policy functionality on Microsoft Active Directory to automatically configure the Cisco Unified Communications Manager server address for the end user on the Phone Designer application.


Note CCMCIP is a service that runs on all Cisco Unified Communications Manager nodes in a cluster. The CCMCIP service address that you configure can be the IP address of any Cisco Unified Communications Manager node in a cluster.


Alternatively you can provide your end users with their Cisco Unified Communications Manager server address information, and each user must manually enter their Cisco Unified Communications Manager server address in the Settings screen on Phone Designer after they install the application.

Distributing the Server Address Using a Self-Extracting Installer File

Distributing the Server Address Using Registry Key Push

Distributing the Server Address Using the Group Policy Feature on Microsoft Active Directory

Distributing the Server Address Using a Self-Extracting Installer File

Before You Begin

Download the application installer file.

For this procedure you will require a zip program that can run a setup exe after unzipping.

If you are administering more than one Cisco Unified Communications Manager server, you will need to create one self-extracting installer file for each Cisco Unified Communications Manager server, and distribute each installer file to the appropriate Cisco Unified Communications Manager user base.

Procedure


Step 1 Using a text editor, create a registry file called CiscoUnifiedCommunicationsWidgetsConfig.reg.

Step 2 Add the following text to CiscoUnifiedCommunicationsWidgetsConfig.reg:

Windows Registry Editor Version 5.00
 
[HKEY_CURRENT_USER\Software\Policies\Cisco]
 
[HKEY_CURRENT_USER\Software\Policies\Cisco\Unified Communications]
"CCMCIPServer"="NY CUCM"
"OverrideLocalCCMCIPServerSetting"=dword:00000000
"UseDefaultWindowsUserName"=dword:00000001


Note Keep the line space above the first two lines.


Step 3 For the CCMCIPServer parameter value, enter the Cisco Unified Communications Manager IP address or server name. In the example file above, the server name of the Cisco Unified Communications Manager is "NY CUCM".

Step 4 To enable or disable the discovery of the Phone Designer username value from the client PC, edit the UseDefaultWindowsUserName parameter as follows:

If this parameter is set to 1, the Phone Designer username is discovered from the client PC and populated in the Settings screen of the Phone Designer application.

If this parameter is set to 0, the Phone Designer username is not populated.

Step 5 To allow the end user to edit the CCMCIP server address field on the application, edit the OverrideLocalCCMCIPServerSetting parameter as follows:

If this parameter is set to 1, the CCMCIP server address field is not editable on the application.

If this parameter is set to 0, the CCMCIP server address field is editable on the application.

Step 6 Save the CiscoUnifiedCommunicationsWidgetsConfig.reg file.

Step 7 Create a .zip file called PhoneDesigner.zip that contains the following files:

PhoneDesignerSetup.exe (the application installer)

CiscoUnifiedCommunicationsWidgetsConfig.reg

Step 8 Using the self-extracting zip program, create a self extracting EXE from the PhoneDesigner.zip file. Assign a name to the new exe file that identifies the Cisco Unified Communications Manager server, for example, Phone Designer_NY.exe.

Step 9 Verify that the new application installer file, for example Phone Designer_NY.exe, has been created.

Step 10 Run the Phone Designer_NY.exe file and verify that the Cisco Unified Communications Manager server address is populated on the Settings screen of the Phone Designer application.

Step 11 Distribute the installer file to the appropriate Phone Designer user base for that Cisco Unified Communications Manager server.

Step 12 Repeat this procedure for each Cisco Unified Communications Manager server that you administer.


Related Topics

Downloading the Installer Package, page 3-13

What To Do Next

Distributing the Installer Package, page 3-13

Distributing the Server Address Using Registry Key Push

Before You Begin

For this procedure you will require a remote desktop management tool to push the registry key to your Phone Designer user base.

Procedure


Step 1 Using a text editor, create a registry file called CiscoUnifiedCommunicationsWidgetsConfig.reg.

Step 2 Add the following text to CiscoUnifiedCommunicationsWidgetsConfig.reg:

Windows Registry Editor Version 5.00
 
[HKEY_CURRENT_USER\Software\Policies\Cisco]
 
[HKEY_CURRENT_USER\Software\Policies\Cisco\Unified Communications]
"CCMCIPServer"="NY CUCM"
"OverrideLocalCCMCIPServerSetting"=dword:00000000
"UseDefaultWindowsUserName"=dword:00000001


Note Keep the line space above the first two lines.


Step 3 For the CCMCIPServer parameter value, enter the Cisco Unified Communications Manager IP address or server name. In the example file above, the server name of the Cisco Unified Communications Manager is "NY CUCM".

Step 4 To enable or disable the discovery of the Phone Designer username value from the client PC, edit the UseDefaultWindowsUserName parameter as follows:

If this parameter is set to 1, the Phone Designer username is discovered from the client PC and populated in the Settings screen of the Phone Designer application.

If this parameter is set to 0, the Phone Designer username is not populated.

Step 5 To allow the end user to edit the CCMCIP server address field on the application, edit the OverrideLocalCCMCIPServerSetting parameter as follows:

If this parameter is set to 1, the CCMCIP server address field is not editable on the application.

If this parameter is set to 0, the CCMCIP server address field is editable on the application.

Step 6 Save the CiscoUnifiedCommunicationsWidgetsConfig.reg file.

Step 7 Use a remote desktop management tool to push the CiscoUnifiedCommunicationsWidgetsConfig.reg to your Phone Designer user base.

Step 8 Repeat this procedure for each Cisco Unified Communications Manager server that you administer.


What To Do Next

Downloading the Installer Package, page 3-13

Distributing the Server Address Using the Group Policy Feature on Microsoft Active Directory

You can use the group policy functionality on Microsoft Active Directory to automatically configure the Cisco Unified Communications Manager server address for the end user on the Phone Designer application. The group policy functionality allows you to create a Group Policy Object (GPO) that contains registry settings that are written to the registry on the local machine of the end user. Microsoft Active Directory will automatically distribute this GPO to the organizational unit(s) or domain that are associated with the GPO.

In the case of the Phone Designer application, you create a GPO that contains the Cisco Unified Communications Manager server address settings. When this GPO is automatically distributed, the Cisco Unified Communications Manager server address is written to the registry on local machine of the end user. The server address is automatically configured at user login, or when the user receives the next automatic update from Microsoft Active Directory.

This section only provides a high level overview of the tasks required to configure the GPO for the Phone Designer application. We assume that you have prerequisite knowledge of configuring GPO on Microsoft Active Directory.

If you are have no prior knowledge of configuring a GPO on Active Directory, please refer to the Active Directory documentation at the following URLs:

Active Directory 2003: http://technet2.microsoft.com/windowsserver/en/technologies/featured/ad/default.mspx

Active Directory 2008: http://technet2.microsoft.com/windowsserver2008/en/library/


Note The GUI for configuring a GPO differs between Active Directory version 2003 and version 2008.


Before You Begin

Locate the administrative template file called Cisco Phone Designer.adm that was supplied as part of the application installer download. If you are missing the file please request it from your Cisco representative.

Procedure


Step 1 Create a GPO for the Phone Designer application, called for example `PhoneDesigner.' You need to create a unique GPO for each Cisco Unified Communications Manager server (if you are administering more than one server).

Step 2 Open the PhoneDesigner GPO in the Group Policy Object Editor.

Step 3 Add the Administrative Template Cisco Phone Designer.adm (supplied to you at application installer download) to the PhoneDesigner GPO.

Step 4 Select the Cisco Unified Communications Manager group policy item under the Cisco Unified Communications folder in the location where the administrative templates are stored (this location varies depending on which Active Directory version you are using).

Step 5 Enable the Cisco Unified Communications Manager group policy item by clicking the Enabled option.

Step 6 Configure the following properties for the Cisco Unified Communications Manager group policy item:

Enter the Cisco Unified Communications Manager server name or IP address.

Check Override local setting. This setting is used to override any previous Cisco Unified Communications Manager server name or IP address value that has been manually configured on the local machine of the end user.

Step 7 Apply the PhoneDesigner GPO to the highest organization unit, or organization units, or domain that includes your entire Phone Designer user base.

Step 8 If required, refine the PhoneDesigner GPO association to a sub-set of users within the organization unit, or organization units, or domain based using the security group filtering feature.


What To Do Next

Downloading the Installer Package, page 3-13