Common Configuration Tasks

This section discusses various configuration tasks:

Setting up gWLM (Initial Setup Steps)

Several of the configuration tasks require the same initial set-up steps. (Each task requiring these steps indicates that the steps are needed.) These steps are given below.




	NOTE: You must be logged in as root on the systems where you run the gwlmagent command mentioned below.

Configure your CMS as indicated in the VSE Management Software Installation and Update Guide, if you have not already done so.
On each managed node, start the gWLM agent (if it is not already running):
# /opt/gwlm/bin/gwlmagent
Alternatively, you can start the agents through HP SIM, as discussed in the VSE Management Software Installation and Update Guide.

Changing from Advisory Mode to Managed Mode

Advisory mode allows you to see what CPU resource requests gWLM would make for a workload—without actually affecting resource allocation. (Advisory mode is not available for SRDs containing virtual machines, psets, or fss groups due to the nature of these compartments.) Managed mode, however, allows gWLM to automatically adjust the resource allocations for your defined workloads.

To change from one mode to the other:




	NOTE: In HP SIM, you must be logged in as root or have authorizations for “All Tools” or “VSE All Tools.”If you are changing from managed mode to advisory mode and you do not plan to change back soon, be aware that gWLM leaves the npar and vpar and pset compartments with the number of cores they had in the last allocation interval. Set the compartments to your desired sizes before changing to advisory mode by associating fixed policies with all the compartments and waiting for an allocation interval to pass.

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd) and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
From the HP SIM menu bar, select:
ToolsVSE Management
and then click the Shared Resource Domain tab.
Select the SRD for which to change the mode.
From the VSE Management menu bar, select:
ModifyShared Resource Domain
Change to the desired mode.
Click OK.

Quick Link Options

In the previous procedure, instead of selecting an SRD and using the VSE Management menu bar, you can find the Details table for the SRD and then choose one of the following options:

Click the Change SRD to advisory mode link
Click the Modify SRD link

Creating a New Policy

A policy instructs gWLM how to manage a workload’s resources. You can create a policy when managing a workload or create a policy separately. To create a policy separately:




	NOTE: In HP SIM, you must be logged in as root or have authorizations for “All Tools” or “VSE All Tools.”

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd) and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
From the HP SIM menu bar, select:
ToolsVSE Management
and then click the Shared Resource Domain tab.
From the VSE Management menu bar, select:
PolicyCreate gWLM Policy...
Edit the settings, selecting a policy type and specifying the required values and optional values as desired.
Click OK.

Editing a Policy

A policy instructs gWLM how to manage a workload’s resources.




	NOTE: You can edit the policies provided with gWLM; however, there is currently no way to restore these policies to their original definitions.

To edit a policy:




	NOTE: In HP SIM, you must be logged in as root or have authorizations for “All Tools” or “VSE All Tools.”

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd), and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
From the HP SIM menu bar, select:
ToolsVSE Management
From the VSE Management menu bar, select:
PolicyEdit gWLM Policies...
Select the policy to edit.
Click Edit.
Edit the settings.
Click OK.
NOTE: All workloads associated with this policy will automatically use the updated policy.

Changing Which Policy is Associated with a Workload

To change the policy affecting how gWLM allocates resources to a workload:




	NOTE: In HP SIM, you must be logged in as root or have authorizations for “All Tools” or “VSE All Tools.”

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd) and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
From the HP SIM menu bar, select:
ToolsVSE Management
and then click the Shared Resource Domain tab.
Select the shared resource domain containing the workload for which you want to change the policy.
Select the workload for which you want to change the policy.
From the VSE Management menu bar, select:
PolicyChange Associated gWLM Policy...
From the Policy dropdown in the table row for the workload, select the new policy to associate, or apply, to the workload.
Click OK.

Adding a New Compartment or GiCAP Group Member to an SRD

If you:

Have added an npar, a vpar, or a virtual machine to your system and want to add it to an SRD,
Have added a Global Instant Capacity (GiCAP) group member and want to add it to an SRD, or
Want to create psets or fss groups in a host already in an SRD

You can use the gWLM wizard to accomplish those tasks. To start the wizard, select from the HP SIM menu bar:

ToolsVSE Management

and then click the Shared Resource Domain tab. From the VSE Management menu bar, select:

CreateShared Resource Domain

Step 1 in the wizard allows you to add npars, vpars, and GiCAP group members. Step 3 allows you to create psets or fss groups, as well as manage existing virtual machines.

Stop Managing a Workload

When you stop managing a workload:

gWLM stops managing resources for the workload
The workload’s definition is removed from the SRD, although it remains available for placing in another SRD




	NOTE: When gWLM stops managing npar-based or vpar-based workloads, it leaves the npars or vpars with the number of cores they had in the last allocation interval. For this reason, in Step 3 below, you associate fixed policies with the workloads based on these types of compartments. You must stop a virtual machine before you stop managing it with gWLM. When gWLM stops managing a virtual machine, it sets the entitlement of the running virtual machine to its minimum. For psets and fss groups, gWLM removes the pset or fss group and moves the processes from that compartment to the default compartment.

To stop managing workloads in an SRD:

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd), and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
Associate fixed policies with all workloads that you want to unmanage that are based on npars or vpars.
For information on setting the associated policy, refer to “Changing Which Policy is Associated with a Workload”.
Wait an allocation interval for gWLM to set CPU resource allocations based on the fixed policies.
Click the Shared Resource Domain tab.
Select the workload you want to stop managing in the workload table.
From the VSE Management menu bar, select:
PolicyRemove Associated gWLM Policy...
Associate policies.
Evaluate and change, if needed, the remaining workloads and their associated policies to ensure they are appropriate, given that a workload has been removed.
Click OK.

Stop Managing an SRD

To stop gWLM from managing an SRD and its workloads, returning resource allocation to HP-UX:




	NOTE: In HP SIM, you must be logged in as root or have authorizations for “All Tools” or “VSE All Tools.”

Ensure HP SIM, the gWLM CMS daemon or service (gwlmcmsd), and all the gWLM agents (gwlmagent) are still running, as explained in the section “Setting up gWLM (Initial Setup Steps)”.
Connect to HP SIM by pointing your web browser to:
http://hostname:280
where hostname represents the hostname of the CMS.
Associate fixed policies with all npars or vpars that were in the SRD.
When gWLM stops managing an SRD, it leaves compartments based on npars or vpars as they were in the last allocation interval. Associating fixed policies allows you to set the sizes exactly to what you want. (For virtual machines, gWLM sets the entitlements of the running virtual machines to their minimums. psets and fss groups are removed in this situation, with their processes going to the default pset or default fss group.)
For information on setting the associated policy, refer to “Changing Which Policy is Associated with a Workload”
Click the Shared Resource Domain tab.
Select the SRD that you want to stop managing (undeploy).
From the VSE Management menu bar, select:
ModifyShared Resource Domain
Change to the Undeployed state.
Click OK.

Quick Link Option

In the previous procedure, instead of selecting an SRD and using the VSE Management menu bar, you can find the Details table for the SRD and click the Undeploy SRD link.