Using Citrix Resource Manager
Citrix Resource Manager and Citrix Presentation Server flavors
Citrix has three versions of their Citrix Presentation Server product on the market. The three flavors are Standard, Advanced and Enterprise edition. As everyone knows Advanced supports load balancing while the Standard version does not. The Enterprise edition (especially with Presentation Server 4) offers more functionality like Installation Manager, Server Reboot options, Application Isolation Environment, CPU utilization management and virtual memory optimization.
Also only available in the Enterprise edition is the Resource Manager. Although this can be very useful, not many companies use this functionality in their infrastructure. In this article, I will describe the benefits of Resource Manager, configuration of Resource Manager and the usage of Resource Manager during system administration.
Introduction to Resource Manager (RM)
What is Resource Manager, actually?
Resource Manager collects, displays and stores data about system performance, applications or process use.
Is this not exactly the same things that Performance Monitor (standard available in Windows) does?
Citrix RM definitely has some overlap with Performance Monitor, but adds some extra functionality to it.
These additional functionalities are the benefits of Resource Manager.
- Real Time Watcher, on the monitored counters (called Metrics within Resource Manager) you can assign two thresholds (warning and error). If these thresholds are exceeded Resource Manager can warn you via several methods like SMS, E-mail or SNMP.
- Resource Manager can store the collected data for a longer time. This makes it possible to generate reports based on current and past activity.
- Resource Manager has an option to create billing reports based on self defined costs.
- Resource Manager collects, besides the system counters, also Citrix specific data like Application usage, User activity and Farm information.
If your infrastructure already contains an advanced monitoring system like Tivoli NetView, HP OpenView, or CA Unicentre, these solutions provide the Network Manage component. This component ports the data from Resource Manager to the monitoring system, so the data is also available in those systems. Citrix also support this functionality for Microsoft Operations Manager (MOM).
Resource Manager Setup
Resource Manager configuration is done via the Citrix Management Console via the Resource Manager menu option in the left pane.
Figure 1: Rescource Manager overview
The first step should be configuring the Summary Database. This database can be hosted on a MS SQL or Oracle server. After defining the database you should pick one of your Citrix servers to host the role Database Connection Server. On this server you should define a Data Source Name (System DSN) to set up a connection with the database server. If the DSN configuration is completed the last step is to configure the chosen server as the Database Connection Server. This is done via the configure button on the Summary Database tab within the Resource Manager component.
Choose the server you created the system DSN on and specify the database user with this password. Also choose an update time. At the selected time the database connection server will store all collected data in the database. This data is stored in a local access database on all Citrix servers during the day. You can specify the retention period of the data in the database and, if needed, alert settings for summary database alerts.
Figure 2: Setting up a Summary Database
As mentioned before, Citrix also collects specific data about the Citrix Farm. This specific data is collected by one server which has the so called Farm Metric role. The assigning of this role is done on the Farm Metric Server tab. Within this tab you can configure the primary server and backup server. If this server is unavailable the role will be assigned to the backup Farm Metric server automatically.
If you would like to be alerted via SMS, SNMP or e-mail these settings are configured in the tabs SMS, SNMP and/or Email.
If your company is charging departments, branch office or customers for the usage of the IT infrastructure, they could use the billing option available in the Resource Manager.
First you need to define a fee for the environment based on one or more sources, like session time, CPU, memory and process active time. Secondly you need to define so called Cost Centers. In these Cost Centers you can add users and or groups which represent an entity which your company would like to invoice. Via the same Billing TAB the invoices can also be generated.
Probably the real time monitoring option is one of the most used options within Resource Manager. The watcher shows the configured metrics with their current state. These metrics are configured at the server level in the tab Resource Manager. Right Click on a metric and choose properties to set the desired values for the metric.
Of course it is very important that the metrics’ thresholds are configured with truthful values and it is here where a lot of problems usually occur. Lots of companies do not change the thresholds and get warnings and errors all the time, while the environment looks fine.
So definitely change the threshold values with values that correspond to your environment. To do this use Resource Manager or Microsoft Performance Monitor to make at least two baselines. One baseline is an overview of the system usages when no users are connected. The second baseline is a server with connected users with normal usage as expected/calculated. Use the second baseline to define your thresholds. Configure the thresholds somewhat higher than the maximum values which were shown in the baseline.
Figure 3: Configuring the thresholds for the metrics
Also additional metrics can be added for your needs, but do not add too many metrics. Citrix recommends limiting the amount of metrics to fifty.
I advise monitoring the following counters, because they give a good overview of the total system performance or important Citrix data:
- Citrix Metaframe Presentation Server – Data Store Connection Failure
- LogicalDisk - % Disk Time
- LogicalDisk - % Free Space
- Physical disk: % disk time
- Physical disk: Average current disk queue length
- Memory: Pages/sec
- Memory: Available Bytes
- Memory: % Committed bytes in use
- Paging file: % Usage
- Processor: % Interrupt Time
- Processor: Processor Time %
- System: Processor queue length
- Network interface: bytes total/sec
- System – Context Switches/sec
- Terminal Services – Active Sessions
- Terminal Services – Inactive Sessions
Because these settings are on the server level, you can configure different metrics and thresholds on every server. But in most situations you probably would like to have the same metrics and thresholds through your whole farm. This can be done in the server metric properties of the server where you configured all the metrics. Choose Apply to other servers and select the servers you want to assign the metrics to.
If you would like to monitor the usage of applications you should define this during the publishing of the application via the Citrix Management Console. This is the only metric available, so you can just count how many instances of the application are running.
Monitor the farm using Resource Manager
Now the configuration is finished we are ready to really use the Resource Manager. You have two options that you can really make good use of with the Management Console as a starting point.
- The Resource Manager tab on the Servers component (in the left pane)
This gives an overall overview of the status of your servers with easy icons (green for below thresholds, yellow for warning level and red for the error level). If one or more metrics are above their threshold then the overall server status will also change.
- The Watcher tab within the Resource Manager component
If one or more metrics are above threshold, they will be displayed within the watcher.
When double clicking on the server or metric you will be forwarded to the Resource Manager tab of that particular server where the metric exceeded the threshold.
Double click the metric to show the real time graph on the specified metric. The specified threshold is displayed using a yellow (warning) and red (error) line.
Reports using Resource Manager
Besides the real time monitoring you can also create reports on current activity and historical usage. Within the Resource Manager just a few simple reports are available. These can be useful for troubleshooting, but are not reports you can use for analysis or management overviews. Fortunately Citrix added lots of useful reports in their new Access Suite Console.
Figure 4: Selecting report out of the Citrix Access Suite console
If the report within the Access Suite does not fit your needs you can use specified products to create your own reports. Because the summary database is an SQL or Oracle database you can directly query the database. One of the most used software products for this kind of task is Crystal Reports. Citrix has delivered several Crystal Reports templates to get started with this product. The templates can be downloaded at the Citrix Download Site.
Resource Manager is a component within the Enterprise edition of Citrix Presentation Server that is not used a lot in Terminal Server infrastructures. Actually that is a pity, because Resource Manager can help a lot during analysis and troubleshooting.
In this article I have described the benefits of Resource Manager, followed by the configuration and usage of Resource Manager. Hopefully this article will make you realize how useful it can be to use Resource Manager in your environment. Also, if you already have a monitoring system like NetView, OpenView or Unicentre in your infrastructure Rescource Manager can be useful because you can connect the metrics into your overall monitoring system using the Network Manager component.