Adding the Linux server and Citrix XenServer host object to TrueSight Server Automation
The following topics provide instructions for adding the Linux server and the Citrix XenServer agentless managed object to TrueSight Server Automation:
To install the agent
Because the Citrix XenServer agentless managed object is managed through a proxy, do not overload the proxy server. The recommendation is to map one agentless managed object to one proxy host. However, if you are using one proxy server to host multiple agentless managed objects, all of the agentless managed objects using the proxy host must be running the same version of the Citrix XenServer configuration object.
To install the Linux agent, complete the following steps:
- Install the RSCD agent on the Red Hat Enterprise Linux server that acts as the proxy server, as described in Installing only the RSCD agent (Linux and UNIX). Be sure to install the RSCD agent that is specifically designated for use with a Linux server.
- Open the /etc/rsc/exports file and add an entry with the application server IP address or host name and a read/write mapping. This restricts access to accept connections only from the listed application serve. For example:
- Open the /etc/rsc/users.local file and add an entry for a role and user that should be mapped to the root account. For example:
- Save and close the files.
- Proceed to the next section about adding the Linux server and Citrix XenServer host object to TrueSight Server Automation.
For more information about the exports and users.local files, see Setting up configuration files.
To add the Linux server and Citrix XenServer host object to TrueSight Server Automation
- From the TrueSight Server Automation Console, add the Red Hat Enterprise Linux proxy server as a managed server to a server group (right-click a server group and select Add Server).
- Right-click the server group in the Servers folder.
- Select Virtualization > Add Citrix XenServer host to add a Citrix XenServer agentless device to TrueSight Server Automation.
- On the Add a new agentless managed object - Properties page, add the name or IP address of the Citrix XenServer master server.
- Optionally, add a brief description.
- Under Properties, locate the AGENTLESS_MANAGED_OBJECT_PROXY_HOST* property.
- Edit the property value by browsing to the name of the Linux system configured as the proxy host.
- Click OK.
- Click Finish.
The agentless managed object for the Citrix XenServer is added to the folder you specified.
While it is possible to use the same proxy host for multiple agentless managed objects, the recommendation is to have separate proxy servers for each agentless managed object (representing a Citrix XenServer master server), for optimal performance.
To set the connection properties for the Citrix XenServer object
- From the TrueSight Server Automation Console, select Configuration > Property Dictionary View.
- Browse the Built-in Property Classes > Connection class.
Click the Instances tab and set the connection details to the Citrix XenServer master host.
When you add the agentless managed object, TrueSight Server Automation automatically created a Connection instance with the name
<agentlessManagedObjectName>is the name of the Citrix XenServer object).
Your user role must have the appropriate RBAC permissions to update the Connection instance, otherwise the association between the instances will not be created and the server will not be enrolled. Also, if a Connection instance is already associated with the Virtualization instance then a new instance is not automatically created.
This new instance contains the connection details to the Citrix XenServer master host.
The Citrix XenServer platform can run in two modes: Pool mode or as a standalone host.
In Pool mode, multiple servers work together to provide capabilities such as workload balancing, high availability, and so on. In this configuration, one server is designated as the master server, while the other servers are designated as slaves. You must set the Connection instance to connect to the master server, rather than a slave server, so that TrueSight Server Automation can obtain configuration data or perform management operations.
In Standalone host mode, the standalone server is considered the master server.
Set the following properties for the newly added instance:
Enter the name of the Citrix XenServer master host.
Set this value to root. Citrix XenServer also supports users configured in Active Directory. If you intend to specify an Active Directory user, the user must be assigned at least the "VM Power Admin" role to be able to use all features supported by TrueSight Server Automation for Citrix XenServer. Enter the Windows Active Directory user in the following way:
<domainName> \ <userName>.
Enter the password of the user root on the master host.
- Save this instance.
- Browse the Built-in Property Classes > Virtualization class.
For each Citrix XenServer object you add, a corresponding instance is automatically created.
- Ensure that the
VIRTUAL_ENTITY_CONNECTIONproperty Virtualization instance points to the previously created Connection instance.
- Save this instance.
- Distribute the Citrix XenServer configuration object on the Citrix XenServer agentless managed object:
- From the TrueSight Server Automation Console, navigate to the Servers folder.
- Right-click a server and select New > Administration Task > Distribute Configuration Objects.
- Provide a name for the Job and click Next.
- Expand the Global Configuration Objects list, select the Citrix XenServer object, and add it to the Selected Configuration Objects section. Click Next.
- On the Targets panel, select the enrolled agentless managed object for the Citrix XenServer master server.
- Click Finish, and execute the job. For details, see Distributing configuration objects.
You can now use the TrueSight Server Automation Console to Live Browse the Citrix XenServer agentless managed object and access the *Citrix XenServer* node. For details on adding a server and setting its properties, see Adding a server to the system.