Installing and Configuring Cisco Hosted Collaboration Solution for Contact Center, Release 9.0
Clone and OS Customization
Downloads: This chapterpdf (PDF - 1.15MB) The complete bookPDF (PDF - 8.51MB) | Feedback

Clone and OS Customization

Clone and OS Customization

Clone and OS Customization Process

Figure 1. Clone and OS Customization Process

Automated Cloning and OS Customization

Download Automation Tool

The automation tool is contained in the GoldenTemplateTool_901.zip file, downloadable from Cisco.com at https://communities.cisco.com/docs/DOC-30791.

Extract the file and copy the GoldenTemplateTool_901 folder to the root of your C: drive.

Figure 2. GoldenTemplate_VMDataSheet_901.xls

This folder contains five subfolders and the GoldenTemplate_VMDataSheet_901.xls file:

  • The Archive subfolder holds any prior versions of the automation spreadsheet, saved with a date and time stamp.
  • The Log subfolder holds all log files saved with a date and time stamp.
  • The PlatformConfigRepository subfolder has three subfolders. All folders are empty until you run the automation script:
    • The CUCM folder has three XML files—one for the publisher and one for each subscriber.
    • The CUIC folder has two XML files—one for the publisher and one for the subscriber.
    • The FINESSE folder has two XML files—one for the primary node and one for the secondary node.
  • The Report subfolder holds all automation reports, saved with a date and time stamp. (This subfolder is empty until you run the automation script.)
  • The scripts subfolder holds four scripts. The file named DeployVM.PS1 is the primary script and calls the other scripts during the automation.
  • GoldenTemplate_VMDataSheet_901.xls is the spreadsheet to complete for the automation process.

Complete Automation Spreadsheet

The GoldenTemplate_VMDataSheet_901.xls automation spreadsheet contains a row for each virtual machine that will be created from the source system.

The automation script reads this spreadsheet row-by-row. For each golden template, the script clones, creates the customization file for the operating system, and deploys all virtual machines to the destination Sides A and B.

Figure 3. GoldenTemplate_VMDataSheet_901.xls Automation Spreadsheet


Note


You will require only two Unified CVP Servers for 500 agent deployment model.


Automation Spreadsheet Values

This table explains the value required in each cell of the GoldenTemplate_VMDataSheet_901.xls spreadsheet. Enter values for the Source server. Obtain and enter values for the Destination servers.


Note


The following Description column identifies any guidelines that apply to the data. For example, GOLDEN_TEMPLATE_NAME cannot contain spaces. Both the automation spreadsheet and VMWare accept names comply with these guidelines. However, the automation script fails if the template names are not in conformance with them.
Column Description Example
VM_TYPE The type of the VM, based on the Contact Center software installed. Default contents are not editable. UCCE_CallServer_SideA
OS_TYPE The type of Operating System installed on the VM. Default contents are not editable. Windows2008
CREATEVM Required. Retain the default NO to skip VM creation during automation. Change to YES to create a VM using automation. YES
SOURCE_HOST_IP Required. The IP address of the ESXi host for this golden template. xxx.xxx.xxx.xxx
SOURCE_DATASTORE_NAME Required The name of the Datastore where this golden template resides. datastore1(3)
GOLDEN_TEMPLATE_NAME Required. The name of the golden template from which the new VM is to be deployed. Cannot contain spaces and special characters /, \, ?,:,* ,.,",<,>. MyCallServer
NEW_VM_NAME Required. The name for the new VM. Cannot contain spaces or special characters. Maximum of 32 characters. CallServerSideA CallServerSideA
DEST_HOST_IP Required. The IP address of the ESXi Host for the new VM. xxx.xxx.xxx.xxx
DEST_DATASTORE_NAME Required. The name of the Datastore for the new VM. datastore2(1)
PRODUCT_VERSION Currently this field is applicable only for Cisco Unified Communications Manager, Unified Intelligence Center, and Cisco Finesse. 9.0.x
COMPUTER_NAME Required. The NET BIOS name for the new computer. 15-character maximum. Do not use the special characters /, \, ?,:,* ,.,",<,> DemoCallSrvA
WORK_GROUP Drop-down list:

YES adds the VM to a WorkGroup and enables WORK_GROUP_NAME.

NO adds the VM to a domain and enables DOMAIN_NAME, DOMAIN_USER, and DOMAIN_PASSWORD.

NO
WORK_GROUP_NAME Required. Enter the Workgroup name. Used only if WORK_GROUP is set to YES. NA
DOMAIN_NAME Required. Enter the Domain name. Used only if WORK_GROUP is set to NO. mydomain.com
TIME_ZONE_LINUX_AREA Required. Drop-down selection of the timezone area to be set Unified CM. For the United States of America, select America. America
TIME_ZONE_LINUX_LOCATION Required. Drop-down selection of the timezone location to be set for Unified CM, Unified Intelligence Center, or Cisco Finesse. Eastern
TIME_ZONE_WINDOWS Required. Drop-down selection of the timezone to be set for the Unified CVP and Unified CCE VMs. (GMT-05:00) Eastern TIme (US & Canada)
DOMAIN_USER Required. The user name for a domain user with privileges to add the new computer to the domain. Enabled only if WORK_GROUP is set to NO. HarryUser
DOMAIN_PASSWORD Required. The password for the domain user. Enabled only if WORK_GROUP is set to NO. password@123
PRODUCT_KEY Required. The valid Windows OS product key in the format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx. ZZZM2-Y330L-HH123-99Y1B-GJ20B
OWNER_NAME Required. The full name of the owner. Administrator and Guest are not allowable names. This is a mandatory field for OS_TYPE Windows 2008. LabAdmin
ORGANIZATION_NAME Required. The Organization Name to be set. MyOrganization
ORGANIZATION_UNIT Required. The Organization Unit to be set for Unified CM, Unified Intelligence Center, or Cisco Finesse. MyUnit
ORGANIZATION_LOCATION Required. The Organization Location to be set for Unified CM, Unified Intelligence Center, or Cisco Finesse. MyCity
ORGANIZATION_STATE Required. The Organization State to be set for Unified CM, Unified Intelligence Center, or Cisco Finesse. MyState
ORGANIZATION_COUNTRY Required. Drop-down selection of the Organization Country to be set for Unified CM, Unified Intelligence Center, or Cisco Finesse. United States of America
NTP_SERVER Required. The IP Address of the NTP server. xxx.xxx.xxx.xxx
NIC_NUM

Values in the field are pre-populated based on VM_TYPE field and are protected. Values are "1" or "2".

This value indicates the number of NICs to be configured for the VMs.

2
IP_ADDRESS_NIC1 Required. A valid IPv4 address for NIC1. xxx.xxx.xxx.xxx
SUB_NET_MASK_NIC1 Required. A valid subnet mask (IPv4 address) for NIC 1. xxx.xxx.xxx.xxx
DEFAULT_GATEWAY_NIC1 Required. A valid Default gateway (IPv4 address) for NIC1. xxx.xxx.xxx.xxx
DNS_IP_NIC1 Required. A valid IPv4 address for the primary DNS for NIC1. xxx.xxx.xxx.xxx
IP_ADDRESS_NIC2 Required. A valid IPv4 address for NIC 2.

Valid only if the value in the NIC_NUM fields is 2.

xxx.xxx.xxx.xxx
SUB_NET_MASK_NIC2 Required. A valid subnet mask (IPv4 address) for NIC 2. For Unified CCE VMs only. 255.255.255.255
DNS_IP_NIC2 Required. A valid IPv4 address for the primary DNS for NIC2. For Unified CCE VMs only. xxx.xxx.xxx.xxx
DNS_ALTERNATE_NIC2 Optional. A valid IPv4 address for the alternate DNS for NIC2. For Unified CCE VMs only. Must differ from the address of the primary DNS for NIC2. xxx.xxx.xxx.xxx

Run Automation Script

Launch VMware vSphere PowerCLI (32-Bit) to run the automation script.
The first time you run PowerCLI, you must enter the following command to determine whether the Restricted Execution policy is in effect or is restricted.
get-executionpolicy
If the policy is restricted, enter the following command:
set-executionpolicy
At the Supply Values prompt, enter Unrestricted. Then enter Y. This changes the execution policy so that you can run unsigned scripts that you write on your local computer and signed scripts from other users.
What to Do Next

Enter a command using the syntax:
<Path to the script> <Path of the spread sheet>
			 <vCenter IP / Hostname> <vCenter User> <Password to connect to vCenter>
C:\GoldenTemplateTool_901\scripts\DeployVM.PS1 C:\GoldenTemplateTool_901\GoldenTemplate_VMDataSheet_901.xls testvCenter testuser testpassword
Figure 4. GoldenTemplate_VMDataSheet_901.xls testvCenter testuser testpassword

This starts a script that parses the data, validates the data, creates a VM and a customization file for the VM.

Ongoing status messages, updated every 30 seconds, display as the script executes.

Figure 5. Status Messages

If you monitor the progress in the vSphere client, note that the vSphere Target is the golden template source.

Figure 6. vSphere Target

If the script runs successfully, it typically completes in several hours.

If the script encounters errors, it stops and displays those errors on the screen and also stores them in the log file.

Completion of the script generates a status report in the Report folder. The status report has a link to the Log file. Consult this file to debug error conditions and to consult with Cisco Support.

Figure 7. Status Report of Golden Template to VM Conversion



Manual Cloning and OS Customization

Create Customization File for Windows Based Components

Complete the following procedure to create the customization file for windows based components (Unified CCE Callserver, Unified CCE Dataserver, Unified CVP Callserver, Unified CVP Reporting Server, and Unified CVP OAMP Server).

Procedure
    Step 1   In VMware vSphere Client, choose View > Management > Customization Specification Manager.
    Step 2   Click New.
    Step 3   On the New Customization Specification page, complete the new customization specification:
    1. From the Target Virtual Machine OS menu, choose Windows.
    2. Under the Customization Specification Information, enter a name for the specification and an optional description and click Next.
    Step 4   On the Registration Information page, specify the registration information for this copy of the guest operating system. Enter the virtual machine owner's name and organization and click Next.
    Step 5   On the Computer Name page, click the most appropriate computer name option that identifies this virtual machine on the network.
    Step 6   On the Windows License page, specify the Windows licensing information for this copy of the guest operating system:
    1. Enter your product volume license key.
    2. Check Include Server License information (required to customize a server guest operating system).
    3. Click Per server to specify the server license mode. Enter 5 as the maximum number of connections you want the server to accept. Click Next.
    Step 7   On the Administrator Password page, enter a password for the administrator account and confirm the password by reentering it. Click Next.
    Step 8   On the Time Zone page, choose the time zone for the virtual machine and click Next.
    Step 9   On the Run Once page, click Next.
    Step 10   On the Network page, choose the type of network settings to apply to the guest operating system and click Next:
    1. Typical settings allow the vCenter server to configure all network interfaces from a DHCP server.
    2. Custom settings require you to manually configure the network settings.
    Step 11   On the Workgroup or Domain page, click Windows Server Domain and enter the destination domain, the username, and the password for a user account that has permission to add a computer to the specified domain.
    Step 12   On the Operating System Options page, check Generate New Security ID (SID) to generate a new security identity and click Next.
    Step 13   On the Ready to complete page, review your Customization File Summary, and then click Finish.

    Generate Answer File for Unified CM and Unified Intelligence Center

    Complete the following procedure to generate an answer file for Unified CM and Unified Intelligence Center.

    Procedure
      Step 1   Open the link http://www.cisco.com/web/cuc_afg/index.html.
      Step 2   Configure the following cluster-wide parameters:
      1. Under Hardware, select Virtual Machine for Primary Node Installed On.
      2. Under Product, select the product name and the product version.
      3. Under Administrator credentials, enter the administrator username and password, and confirm the password.
      4. Under Security Password, enter a password and confirm password.
      5. Under the Application user credentials, enter the application username, password, and confirm the password.

        Cisco recommends that you use the same System Application or Administrator credentials for all nodes.

      6. Under Certificate information, enter the organization name, unit, location, state, and country for the Unified CM and Unified Intelligence Center.
      7. Under SMTP, check the box Configure SMTP host and enter the SMTP location.
      Step 3   Configure the following primary node parameters:
      1. Under NIC Interface Settings, check the check box Use Auto Negotiation.
        Note    Do not change the MTU settings.
      2. Under Network Information, enter the IP address, hostname ,IP mask, and gateway information.

        Do not select the option Use DHCP for IP Address Resolution.

      3. Under DNS, select the option Configure Client DNS, and enter Primary DNS IP and DNS name.
      4. Under Timezone, select the option Use Primary Time Zone Settings.
      5. Under Network Time Protocol, check Use Network Time Protocol and enter the IP address, NTP server name, or NTP Server Pool name for at least one external NTP server.
      Step 4   Configure the following secondary node parameters:
      1. Under NIC Interface Settings, check the check box Use Auto Negotiation.
        Note    Do not change the MTU settings.
      2. Under Network Information, enter the IP address, hostname, IP mask, and gateway information.

        Do not select the option Use DHCP for IP Address Resolution.

      3. Under DNS, select the option Configure Client DNS, and enter primary DNS IP and DNS name.
      4. Under Timezone, check Use Primary Time Zone Settings.
      5. Under List of Secondary Nodes, click Add Secondary Node.
      Step 5   Click Generate Answer files & License MAC to download the answer file for publisher and first subscriber.
      Note    For Unified CM, where an answer file for a second subscriber is required, close and open the answer file generator web page and enter the details for the publisher and second subscriber. Download the answer file for the second subscriber only, because you already downloaded the publisher file along with the first subscriber.

      Deploy Virtual Machine from the Golden Template

      Complete the following procedure to deploy the virtual machine from the golden template. Use the 500 Agent Deployment Checklists and the 1000 Agent Deployment Checklist to record the hosts, IP addresses, and SAN locations for your deployment.

      Procedure
        Step 1   Right-click the template and choose Deploy Virtual Machine from this template.
        Step 2   Enter a virtual machine name, choose a location, and click Next.
        Step 3   On the Host/Cluster page, specify the host on which you want to store the template. Make sure that the host/cluster is valid. Click Next.
        Step 4   Click Advanced. Specify a valid datastore for the virtual machine that complies with the Cisco HCS for Contact Center component you deploy.
        Step 5   Click Next.
        Step 6   Make sure that the datastore RAID levels for the component that you install comply with conditions specified in the SAN Configuration for the 500 Agent Deployment or SAN Configuration for the 1000 Agent Deployment table.
        Step 7   Click Thick provisioned Lazy Zeroed to allocate a fixed amount of storage space to the virtual disk. Click Next.
        Step 8   Click Customize using an existing customization specification and click Next.
        Step 9   Select the customization file created in Create the Customization File for the Template.
        Step 10   Review the settings for the new virtual machine. Click Finish.