Product Documentation

Power and Capacity Management Task Descriptions

Oct 09, 2015

When task instructions include selecting an entry in the Actions pane, there may be equivalent selections in the Action menu. Also, when the task instructions include selecting an entry in a workload or tabs pane and then selecting from the Actions pane, there may be equivalent selections in a right-click menu.

To connect to a Power and Capacity Management farm

This task is required only if you have more than one Power and Capacity Management farm.

In the Actions pane, click Connect to XenApp PCM Service, then select the Power and Capacity Management farm you want to manage.

To configure or delete a server profile

In the tabs pane, select Capacities. Select one or more profiles.
  • To configure server profile properties:
    1. In the Actions pane, click Server Profile Properties. The Server Profile Properties dialog box appears.
    2. Enter the typical session capacity value. A zero value is equivalent to unset.
    3. Enter the power action timeout (seconds) value.
    4. Enter the estimated session capacity limit in the range 0-1000 (0 = not set). This value must be greater than or equal to the typical session capacity value.
  • To delete a server profile, click Delete Server Profile in the Actions pane. Confirm the deletion. You can delete a server profile only if it has no associated servers.

To configure server properties

  1. In the workload pane, select a workload or All Workloads.
  2. In the tabs pane, select Servers, then select one or more servers.
  3. In the Actions pane, click Server Properties.
  4. In the Server Properties dialog box, select the desired control mode and power controller preference.

To specify global configuration settings

In the Actions pane, click Configuration. In the XenApp PCM Configuration dialog box:
  • Select the control mode for new servers added to the Power and Capacity Management farm.
  • Select the optimal load percentage for servers.
  • Enable or disable metrics data collection. Select the number of days to retain the collected metrics data. The default is 365 days (1 year).

To add, modify, or delete virtual machine managers

In the Actions pane, click Machine Managers and use the Machine Managers dialog box to add, modify, or delete virtual machine managers.
  • When adding a virtual machine manager:
    • Click Add.
    • Specify a URL to the XenServer resource pool in the form http[s]://ip-or-hostname.
    • For the type, leave Citrix XenServer 4.0 or newer selected.
    • For the site, specify where the resource pool is located.
    • For authentication, if you select the Authenticate with user name and password check box, specify the user name and password XenServer uses to authenticate. Do not select the checkbox if you want to use the domain credentials of the concentrator service to authenticate to XenServer (pass-through authentication).
    • Leave the Enable this machine manager checkbox selected.
  • When modifying a virtual machine manager, select the machine manager and click Modify. Change values as needed.
  • When deleting a virtual machine manager, select the machine manager and click Delete. Confirm the deletion.
Important: Assign unique MAC addresses to virtual machines even across resource pools. This is typically done by using the auto-generate MAC option when creating the virtual machine.

To add, modify, or delete a site

In the Actions pane, click Sites and use the Server Sites dialog box to add, modify, or delete a site.

  • When adding a site:
    • Click Add.
    • Specify a site name.
    • Select a power controller preference for servers that belong to this site.
  • When modifying a site, select the site and click Modify. Change values as needed.
  • When deleting a site, select the site and click Delete. Confirm the deletion.

To create, copy, or delete a schedule

Select a workload in the workloads pane. In the tabs pane, select Schedule.
  • To create a schedule, select the Allow Edit checkbox. Edit the schedule for one or more days of the week.
  • To copy the schedule from the previous day, click the Copy day's schedule in the day of the week area.
  • To copy the entire workload schedule to another workload, ensure the workload being copied has focus, then select Copy Schedule To in the Actions pane.
  • To delete a schedule, select Delete Schedule in the Actions pane.
  • To delete an individual schedule item, select the leftmost cell in the item, then press the Delete key.

To enable or disable power management and load consolidation

Select a workload or All Workloads in the workloads pane, then select an operation in the Actions pane, the Action menu, or the right-click menu.

When you enable power management and load consolidation globally (by selecting All Workloads), you can also enable or disable power management and load consolidation on a per-workload basis. The global setting overrides the per-workload setting. For example, to enable power management for one workload, power management must be enabled for All Workloads.

To generate a workload or server report

  1. Select the reporting object:
    • To generate a workload report, in the workloads pane, select a workload or All Workloads. In the Actions pane, click Generate Workload Report.
    • To generate a server report, click the Servers tab in the tabs pane and select a server. In the Actions pane, click Generate Server Report.
  2. Select the report type, period of time the report covers, and the interval.
  3. Select Generate Report.
Important: The management console uses Microsoft Internet Explorer to display reports (overriding the user default browser setting). For optimal display, always use Microsoft Internet Explorer to view reports.

To explicitly designate a master concentrator

  1. Select Cluster Management in the Actions pane.
  2. In the Cluster Management dialog box, select a concentrator and click Set Master.

To delete a server or workload

You can delete a server only if it (or the server it represents) is not online with the Power and Capacity Management agent running. To delete a server:
  1. Click the Servers tab and select one or more servers.
  2. Click Delete Server in the Actions pane and confirm the deletion.
You can delete a workload only if it has no servers associated with it. Deleting a workload also deletes all associated profiles and schedules. To delete a workload:
  1. Select one or more workloads in the workloads pane.
  2. Click Delete Workload in the Actions pane and confirm the deletion.

After you delete a server (or a workload or server profile) that is offline, if Power and Capacity Management discovers those objects, they will be re-created. For example, if you delete an offline XenApp server that has the Power and Capacity Management agent installed, then power on that server, the server will be re-added to the Power and Capacity Management system.

To initiate or cancel a manual override

To initiate a manual override for a workload:
  1. Select the workload in the workloads pane.
  2. Select Power Controller Manual Override in the Actions pane.
  3. In the Power Controller Manual Override dialog box, enter setpoint values or select the infinity check boxes, and click Start Override.
To cancel a manual override for a workload:
  1. Select the workload in the workloads pane.
  2. Select Power Controller Manual Override in the Actions pane.
  3. Click Stop Override.

To manually publish the concentrator

If the account running the Concentrator service does not have sufficient access in Active Directory (AD) to automatically publish its service information, other Power and Capacity Management components will not be able locate Power and Capacity Management and the system will not operate correctly. This will manifest itself by the concentrator writing errors to the application log, and the console not showing the XenApp servers on which the agent has been installed.

To overcome this, manually publish the concentrator within AD.
  1. Log onto the computer hosting the concentrator using an account that has sufficient access in AD.
  2. Ensure that the Concentrator service is running.
  3. From a command prompt, change directory (CD) to the directory in which the PCMConcentrator.exe file is located; by default this is “%SystemDrive%\Program Files\Citrix\ XenApp Power and Capacity Management\Concentrator”. Run the following command:

    PCMConcentrator /publish

  4. Restart the Concentrator service.

This creates an AD object only; no AD schema changes are required. This object is created as a child object of the computer container hosting the concentrator, called “CN=Citrix XenAppPCM SCP”.

Conversely, you can manually revoke the publishing information by running:

PCMConcentrator /revoke

This command deletes the aforementioned object in AD.

To change the workload assigned to a XenApp server

A XenApp server is assigned to a workload during the installation of the Power and Capacity Management agent. You can change the name of the workload to which a XenApp server is assigned by editing the registry on the XenApp server.

Caution: Editing the Registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Key:

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\XenAppPCM

String ValueName:

WorkloadName

Change the contents of the WorkloadName to the value required. The Agent service does not need to be restarted for this change to take effect.

To unassign the server from all workloads, enter the value Unassigned.