HERMES SoftLab d.d

Installing and ConfiguringInstalling and ConfiguringHERMES SoftLab HERMES SoftLab

Citrix Presentation ServerCitrix Presentation Server SMART Plug-In SMART Plug-In

forfor HP HP OperationsOperations Manager Manager/UNIX/UNIX

HERMES SoftLab d.d.

Quick Reference

Installation and Configuration OverviewPreparing the Environment

Installing the HPOM Management Server

Configuring the HPOM Management Server

Deploying on the Managed Nodes

Licensing

Verifying the Installation and Configuration

- SPI for Citrix Hardware and Software Requirements - Plan the Citrix Environment - Set Up Managed Nodes - Obtain Installation Packages

- Install SPI for Citrix on the HPOM Management Server

- Establish Security of your Citrix Environment

- Deploy Instrumentation on the Managed Nodes - Install SPI for Citrix on the Managed Nodes - Configure SPI for Citrix Managed Nodes

- Deploy the Licensing Policy on Managed Nodes - Generate License Request File - Obtain License Activation File - Merge and Distribute the License Files

- Verify the Installation - Verify the Configuration - Verify Licensing

Installing Graphs - Install Graphs

Installing Reports - Install Reports - Configure Reports

Preparing the Environment

- SPI for Citrix Hardware and Software Requirements - Prepare the Citrix Environment - Set Up Managed Nodes - Obtain Installation Packages

• SPI for Citrix Hardware and Software Requirements– For requirements, supported versions and platforms refer to SPI for Citrix Installation

and Configuration Guide.

• Prepare the Citrix Environment– Obtain and prepare all information on your Citrix environment– Install and run HPOM agents on all Citrix nodes with the opcmsg policy– Ensure access to the HPOM management server and all target nodes, and HP

Performance, Internet Services (optional), and Reporter (optional).– Install HPOM Management server and HPOM Agent software on the management

server and make sure all server and agent processes are running

• Set Up Managed Nodes (for details refer to SPI for Citrix Installation and Configuration Guide)

Citrix servers are added as managed nodes to the HPOM.

• Obtain Installation Packages– CTXSPI_03.20.eulsa– hsl_eulsa_hpux / hsl_eulsa_sun– CTXSPI_Reports_03.20.exe

Installing the HPOM Management Server

- Install SPI for Citrix on the HPOM Management Server

During the installation, all HP Operations Manager processes must be “up and running”.

1. Copy the following files to the /tmp directory:– For HP-UX: the files hsl_eulsa_hpux and CTXSPI_03.20.eulsa– For Sun Solaris: the files hsl_eulsa_sun and CTXSPI_03.20.eulsa

2. Use the chmod command to set the executable permissions to the files hsl_eulsa_hpux or hsl_eulsa_sun , if necessary.

3. To obtain the product installation package, first you must agree to the end-user license agreement. In the /tmp directory, run from the command line:– For HP-UX: hsl_eulsa_hpux -e CTXSPI_03.20.eulsa– For Sun Solaris: hsl_eulsa_sun -e CTXSPI_03.20.eulsa

4. Enter your name and the name of your company.5. The standard HERMES SoftLab Software License Agreement will be displayed. Read it carefully,

type I AGREE, then press [ENTER] to generate the installation package file (CTXSPI_03.20.depot) and your digitally signed End User License & Support Agreement file (CTXSPI_03.20.eulsa.txt).

6. Install SPI for Citrix with the following command:– For HP-UX and Sun Solaris: swinstall -s /tmp/CTXSPI_03.20.depot CTXSPI

7. After the installation has completed successfully, start HPOM administrator GUI (management console) and check that SPI for Citrix group was added to Application Bank and Message Source Templates.

IMPORTANT: Data Source Integration to Dynamic Data Feed (DSI2DDF) component, version A.01.30 or above should be installed on the management server system if you want to use the reporting and graphing functionality.

Configuring the HPOM Management Server

- Establish Security of your Citrix Environment

With SPI for Citrix you can manage any number of Citrix farms from a single HPOM management server.

• For each farm, configure the farm administrator account that SPI for Citrix will use to perform its tasks. Use the CTXSPIConfig command-line application, located on the management server in /opt/OV/ctxspi/bin:

• Farm administrator account must:– be the local administrator of each individual Citrix Presentation Server system– have full access granted to farm (not read-only)– Be allowed to login to Citrix Presentation Server systems interactively

• For each farm add farm administrator account (do not use the ADS account format user@domain):

/opt/OV/ctxspi/bin/CTXSPIConfig -add

Farm name: <enter name of farm>

Farm domain: <domain name of farm admin account>

Farm username: <name of farm admin account>

Farm password: <password>

Retype password: <repeat password>

• Add the Managed Nodes to the HPOM Management ServerMake sure the agent on the node is running.

1. Start the HPOM Console and log in as an HPOM Administrator (opc_adm).

2. In the Node Bank window, first click Actions, and then Node. Click Add to open the Add Node window.

3. Add the Node name and select proper Machine type and OS Name.

4. After you add all required information, click [OK] to exit the Add Node window.

Citrix systems (Citrix Presentation Server, Citrix License Server, Citrix Web Interface, Citrix Secure Gateway) are added as managed nodes to the HPOM.

1/3Deploying on the Managed Nodes


• Install SPI for Citrix

1. To ensure that CTXSPI messages appear correctly in the HPOM message browser, add the target nodes as members of their corresponding new node group CTXSPI. This node group and the new message groups, ctxspi and ctxspi_int, need to be assigned to the HPOM user(s), operator and/or administrator, who will be using the instrumentation. This can be performed by manually assigning the responsibilities to these users or by using the CTXSPI Operator user profile.

2. Select the target node in the HPOM Node Bank window. In the menu, first click Actions, then Agents, and then click Install/Update SW & Config.

3. In the Install/Update Software and Configuration window select the following checkboxes: Actions, Monitors, and Commands. Click [OK].

2/3Deploying on the Managed Nodes


Deploying on the Managed Nodes


• Configure SPI for Citrix Managed Nodes

– Register SPI for Citrix subagent on all managed nodesGo to SPI for Citrix/CTXSPI-Maintenance/CTXSPI-Configure application group and execute CTXSPI-Register Subagent application on every Citrix node you want to manage.

– On Citrix web Interface nodes only, install SPI for Citrix Web Interface integrationGo to SPI for Citrix/CTXSPI-Web Interface/CTXSPI-WI Configure application group, right-click the CTXSPI-Install WI Monitoring application, choose Customized Startup, set the “allow_iis_restart” parameter, and execute the application on Citrix Web Interface managed nodes.

IMPORTANT: Installing Web Interface monitoring restarts Internet

Information Server (IIS) on the managed node, so plan the time of installation carefully.

3/3

Licensing

- Deploy the Licensing Policy on Managed Nodes - Generate License Request File - Obtain License Activation File - Merge and Deploy the License Files

• Deploy the Licensing Policy on Managed Nodes

1. Start the HPOM Console and log in as HPOM Administrator (opc_adm).

2. In the Node Bank window select the node(s) to which you want to deploy the templates.

3. In the menu first click Actions, and then Agents. Click Assign Templates to open the Define Configuration window.

4. Click Add to open the Add Configuration window.

5. Click Open Template Window to open the Message Source Templates window.

6. In the Template Group list expand SPI for Citrix/CTXSPI-SPI Licensing group, and then in the right pane select the CTXSPI-LicOpcMsg message template.

7. In the Add Configuration window click Get Template Selections and then [OK]. The selected template is now added to the list of templates in the Define Configuration window.

8. In the menu first click Actions, and then Agents. Click Install/Update SW & Config to open the Install/Update Software and Configuration window.

9. Select the Templates, Actions, Commands, and Monitors checkboxes and click [OK]. The template required for licensing is installed on the managed node.

1/3

• Generate License Request File

1. In the Node Bank window, first click Window, and then Application Bank. The Application Bank window opens.

2. Go to SPI for Citrix/CTXSPI-SPI Maintenance/CTXSPI-SPI Licensing/ group.

3. Run the CTXSPI-1. Clear License Request File on Mgmt Server application to clear the ctxspi_license_requests.dat license request file on the management server.

4. Run the CTXSPI-2. Generate License Request for Node application on the managed nodes for which you need licenses. In the Customized Startup-Application window, in the Additional Parameters field, replace the string "Your Company Name" with the name of your company. Click [OK] to generate the license request file. The license request file will be created in the /opt/OV/ctxspi/conf folder on the management server.

The license requests for all nodes will be created in the /opt/OV/ctxspi/conf/ctxspi_license_requests.dat file on the management server.

Licensing

- Deploy the Licensing Policy on Managed Nodes - Generate License Request File - Obtain License Activation File - Merge and Deploy the License Files

2/3

• Obtain License Activation File

1. Upload the license request file using the Licensing Portal (http://spi.hermes-softlab.com/licensing/) or send it by e-mail to the Licensing Department ([email protected]).

You will receive a license activation file ctxspi_licact_new.dat by e-mail.

• Merge and Distribute the License Files

1. Copy the ctxspi_licact_new.dat file to the /opt/OV/ctxspi/conf folder.

2. In the Application Bank window, go to SPI for Citrix/CTXSPI-SPI Maintenance/CTXSPI-SPI Licensing application group and run the CTXSPI-3. Merge License Activation Codes on Mgmt Server application to merge the ctxspi_licact_new.dat file with the SPI license file.

3. In the Install/Update Software and Configuration window, distribute Actions, Commands, and Monitor to all managed nodes for which you have requested the licenses.

Licensing tutorial is available at the HERMES SoftLab website.

Note that you will be requested to sign in.

Licensing

- Deploy the Licensing Policy on Managed Nodes - Generate License Request File - Obtain License Activation File - Merge and Distribute the License Files

3/3



• Verify the Installation

1/3

Do you meet hardware and

software requirements?

Check software requirements and install the required software.

NO

Are your Citrix systems added

as managed nodes to the

HPOM?

Set up managed nodes (refer to SPI for Citrix Installation and

Configuration Guide).

Install SPI for Citrix on the HPOM management server.

Is SPI for Citrix group added to

Application Bank and Message

Source Templates in HPOM

administrator GUI?

For solution refer to chapter Troubleshooting in the SPI for Citrix Installation and Configuration Guide, or reinstall the product.

NO

YES

NO

YES

Proceed with Verifying the Configuration.

YES



• Verify the Configuration

2/3

Is the instrumentation deployed on all

nodes?

Check HPOM Agent configuration. Try to deploy a native HPOM template on the

node.

NO

YES

Proceed with Verifying Licensing.

Run "Check Requirements/Configuration" tool for each node to check SPI for Citrix requirements and

configuration.

YES

Is the SPI for Citrix installed on

all nodes?

For solution refer to chapter Troubleshooting in the SPI for Citrix Installation and Configuration Guide, or reinstall the product on the node.

NO

YES



• Verify Licensing

3/3

Is the licensing template deployed

on all nodes?NO

Is the ctxspi_license_requests.dat file located in the /opt/OV/

ctxspi/conf folder?

In the message browser find the licensing message. The

message contains the error description and proposed

solution.

NO

YES

YES

Is the license activation file ctxspi_licact_new.dat located

in the /opt/OV/ctxspi/conf folder?

Verify that you received the file and copy it to the /opt/OV/ctxspi/

conf folder. NO

Check HPOM Agent configuration. Try to deploy a native HPOM template on the

node.

YES

Congratulations! You have successfully installed the

SPI for Citrix.

Can you use SPI for Citrix on managed

nodes?

Use provided support applications to troubleshoot the installation. Contact support at

[email protected]

NO

YES

Installing Reports - Install Reports - Configure Reports

• Install Reports

1. Where HP Reporter is installed, login to your Windows machine as the user with administrator permissions.

2. Run the CTXSPI_Reports_03.20.exe package. In the Select Setup Type window, select one of the following:– HPOM Unix server– HPOM Windows server with reports for Crystal Report 10– HPOM Windows server with reports for Crystal Report 8.5

3. After the installation has completed successfully, start HP Reporter on the Reporter system and check that SPI for Citrix is listed under Reports.

• Configure Reports

SPI for Citrix reports will be generated only for nodes, which are members of the SPI for Citrix Reporter node group.

1. If SPI for Citrix node group is not generated automatically, create it manually.

2. Verify that all Citrix managed nodes belong to this node group. If necessary, add them manually.

3. Deploy the corresponding CTXSPI-<node type> Data Collection policy groups to your Citrix managed nodes.

You can start using Reports when performance data is collected on the managed nodes (after at least two days).

Installing Graphs - Install Graphs

• To install graphs, copy the SPI for Citrix graph templates file VPI_GraphsSPI for Citrix.txt on the HP Performance Manager system to the following locations:/var/opt/OV/conf/perf//opt/OV/newconfig/OVPM/

• To verify the installation, open the Performance Manager and click the Display tab. In the right pane you will see the main SPI for Citrix graph category.

I M P O R T A N T: In order for graphs to show data, the corresponding data collection templates need to be distributed to Citrix managed nodes.

Documents

HERMES SoftLab d.d