Product Documentation

Release Notes 5.1

May 28, 2015

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds for a particular release or build of Citrix Command Center 5.1 software. The release notes are categorized into:

What's New in Command Center 5.1

The Command Center user interface has been revamped to provide you with an enhanced user experience, intuitive navigation, and other usability improvements. With this release, Command Center provides support for managing NetScaler SDX 10, CloudBridge Platform, and NetScaler Cluster from the Command Center console.

You can now discover and monitor NetScaler devices whose NetScaler IP (NSIP) addresses are in IPv6 format. You can also monitor and fetch statistics from virtual servers that have IPv6 addresses. Two new built-in tasks added to upgrade the NetScaler devices from NetScaler release 9.x to any version of NetScaler release 10.x

You can use the NetScaler Gateway dashboard to view graphical reports of NetScaler Gateway user sessions. The reports are based on parameters such as session access, ICA applications accessed, bandwidth usage, client type usage, EPA scan failures, and logon failures. NetScaler Gateway log messages also provide information about these parameters.

Main Release

These topics describe enhancements in Command Center 5.1 releases. You can determine your Command Center build type by looking at the build information on the banner of the Command Center Graphical User Interface (GUI).

  • In this section:

    • New in This Release
    • Bug Fixes
    • Limitations
    • Known Issues and Workarounds

New in This Release

Updated: 2013-06-13

The Citrix Command Center release 5.1 includes the following new features and enhancements.

New Improved User Interface

The Command Center user interface has been revamped to provide you with an enhanced user experience, intuitive navigation, and other usability improvements.

Support for NetScaler Cluster Management

NetScaler release 10 introduces support for clustering architecture. From the Command Center console, you can create and manage a cluster of nCore NetScaler appliances that work together as a single system image. The enhancements in Command Center to support NetScaler Cluster management are:

  • NetScaler Cluster

    The NetScaler Cluster is represented as the NS CL, and the device type of a cluster node is represented as Cluster Node in the right pane of the Citrix Network page. You can configure a cluster from Command Center, or discover a previously configured cluster, and then manage the cluster from the Command Center console. You can discover a configured NetScaler cluster by specifying a Cluster IP address or the IP address of any of the cluster nodes.

    After Command Center discovers the cluster and the nodes, you can add additional nodes to the discovered NetScaler Cluster, remove nodes, or remove the cluster configuration from Command Center console. You can use Command Center to perform all the configuration management, entity monitoring, and change management operations on the NetScaler Cluster.

    You can monitor the performance of NetScaler Cluster as well as the participating nodes by using performance reports and threshold functionality. You can receive notifications for SSL certificate expiration dates and then manage the certificates for the NetScaler Cluster and also for the participating nodes.

  • Device Properties

    Apart from the general device properties, you can view cluster properties such as Dead Interval, Hello Interval, Preemption, Cluster Status, and mapping between cluster and member nodes in the Device Properties page of NetScaler Cluster.

    For the NetScaler devices participating in the cluster configuration, apart from the general device properties, you can view the cluster specific properties such as Cluster IP address, State, Node ID, Back Plane, Master State, and Sync State from the Device Properties page of the NetScaler device.

  • New SNMP Traps

    With this release, new cluster-specific SNMP traps are added in Command Center.

NetScaler SDX 10 and CloudBridge Advanced Platform Support in Command Center

With this release, Command Center provides NetScaler SDX 10 and CloudBridge Advanced Platform support. After your NetScaler SDX device is up and running, you can perform various tasks to manage and monitor the device from the Command Center console. The enhancements in Command Center to support NetScaler SDX devices are:
  • Device Properties

    In addition to the previously existing device properties, the Device Properties page now displays the number of available NetScaler instances, maximum number of CloudBridge instance, total SSL cores, free SSL cores, and BIOS version.

  • Device Profile
    • With this release, you can provide the SNMP community string which enables Command Center to receive the NetScaler SDX SNMP traps.
    • With this release, you can create device profiles for CloudBridge Advanced Platform by selecting a CloudBridge Advanced Platform profile in the Create Device Profile.
  • Provisioning

    With this release, additional VLAN setting provided to support the SDX 10 devices.

  • New SNMP traps

    With this release, new SNMP traps are added in Command Center.

IPv6 Support in Command Center

You can now discover and monitor NetScaler devices whose NetScaler IP (NSIP) addresses are in IPv6 format. You can also monitor and fetch statistics from virtual servers that have IPv6 addresses.

Monitoring NetScaler Gateway Syslog Events

You can use the NetScaler Gateway dashboard to view graphical reports of NetScaler Gateway user sessions. The reports are based on parameters such as session access, ICA applications accessed, bandwidth usage, client type usage, EPA scan failures, and logon failures. NetScaler Gateway log messages also provide information about these parameters.

Graceful Shutdown of Services and Service Groups

When disabling services and service groups, you can specify a wait time and the graceful shutdown time to ensure services are not shut down abruptly. This helps in better management of the state of services and service groups from the Command Center console.

Upgrading a NetScaler Device using Built-in Tasks

Two new built-in tasks added to upgrade the NetScaler devices from NetScaler release 9.x to any version of NetScaler release 10.x
  • SoftwareUpgrade-9.xto10.x - Upgrade one or more devices from NetScaler release 9.x to any version of NetScaler release 10.x.
  • SoftwareUpgrade-Within10.x - Upgrade one or more devices from a NetScaler release 10.x to a newer 10.x release.

Additional NetScaler Device Properties

The Device Properties page now displays the number of SSL Cards on the devices, the number of Packet Engines on the device, and the system model ID.

Additional Counter Support for NetScaler and CloudBridge Devices

With this release, two new counter groups, NIC and SSL Cumulative have been added for NetScaler devices. Also, new counters have been added under Interface(+), Virtual Servers, and CloudBridge Service Classes counter groups.

Bug Fixes

The following table lists the bugs fixed in Command Center release 5.1.

Bug Fixes in Release 5.1 Build 29.3

The following issues, identified in Command Center release 5.0, have been fixed in this release.

Issue ID Issue Description

0306947

The default certificate and keys generated when the Command Center appliance is started for the first time are not unique.

0347643

Command Center cannot generate Certificate Signing Requests (CSR) for certificates that are added to a NetScaler appliance using the FIPS key.

348611

On the Configuration tab, the Certificate Management page does not display complete list of polled SSL certificates.

0346003

The complete list of entities are not displayed on the Monitoring page of the Command Centre client until the polling operation is complete.

Limitations

The following table describes the limitations in Command Center release 5.1.
Issue ID Issue Description

0356483

When you execute the SoftwareUpgrade built-in task on a Repeater on SDX device, if the task is not executed successfully the status of the task still displays as "Queued" in the Execution Log.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.1.

The following export options are not available in Command Center release 5.1.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0348256

When the application firewall feature on the NetScaler appliance is configured to use Common Event Format (CEF) logs, in the application firewall dashboard (Reporting > AppFirewall > Dashboard), the Signature violations by category graph is not displayed for NetScaler devices running 10.0 releases.

0347274

The details of the security violation, of type "APPFW_CSRF_TAG" ,displayed in AppFirewall log messages are incorrect for NetScaler devices running 10.0 releases.

0347210

Sub maps, NetScaler pool, Move to (another map), and Configure Location features are not supported in Command Center release 5.1. The existing sub maps created in the previous Command Center release, will be available under Maps node.

The Datacenter and the Application views are not available in Command Center 5.1 release.

0347208

In the Authentication settings for Active Directory Group extraction, option to retrieve the attributes from Active Directory server, and then select the attributes from the retrieved list, is not available for Command Center release 5.1.

0337817

The option to customize the columns on the Device Inventory, Alarms, Events, Virtual Servers, Services, Service Group, and Custom View pages in Command Center user interface is not available in the Command Center release 5.1.

0315632

When creating views for SNMP alarms and events in Faults tab, selecting a device type on the "Create view " page does not load the filter criteria associated with the device type.

0307457

C# and Java Nitro API support for Command Center is not available in the Command Center release 5.1.

0303315

When you add a group in Command Center by browsing the Active Directory groups, not all the groups in Active Directory are displayed.

0290553

The advanced search, and find device feature in Home page are not available in the Command Center release 5.1. This is because of migration to the new user interface framework.

0246561

Command Center does not support MySQL database version 5.5 and later.

0235683

If you have created custom view scopes in Command Center release 3.3 and have now upgraded to release 4.1, and the custom view scopes will no longer be available. This is because of the enhancements in the authorization mode.

0234377

The built-in task SoftwareUpgrade fails on Branch Repeater devices running on Windows platform.

0233920

If you are using Internet Explorer version 8, when you try to execute the built-in task InstallSSLCert, in the Preview pane, the actual file path is replaced with a fakepath, for example, c:\fakepath\filename. This is due to a security feature on Internet Explorer version 8. For more information, see http://www.telerik.com/community/forums/aspnet-ajax/upload/ie8-upload-control-shows-quot-c-fakepath-quot.aspx

0225713

If the hostname of the Command Center server contains an underscore ('_'), you may encounter a java exception.

0218964

Branch Repeater discovery fails when Command Center server is installed on a machine with multiple interfaces (IP1 and IP2).

0201120

The restore facility does not restore thresholds and event/alarm filters.

0203098

Event Severity configuration changes roll back to their default configurations after a service pack installation.

0193763

Custom View Scope does not work on high availability (HA) pairs.

Known Issues and Workarounds

The following table describes the known issues with their workarounds in Command Center Release 5.1.
Issue ID Issue Description Workaround

0356432

The discovery of Citrix Branch Repeater with Windows Server (CBRwWS), running release 6.2.0 or later, fails because the Command Center server does not automatically add the Command Center IP address as an SNMP manager on CBRwWS during the discovery process.

Manually add the Command Center server IP address as an SNMP manager on the CBRwWS.

0356104

If you upgrade the Command Center software from release 4.1 to release 5.1, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates).

Click Poll Now and the certificates will be displayed.

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

0332765

The Command Center HA setup stops working when JVM fails on the Command Center secondary server.

Restart the Command Center secondary server.

0257635

A Branch Repeater device connected to Command Center becomes inaccessible from Command Center, and the following error message appears: "Exception while doing inventory collection :No such SNMP MIB exists " is displayed.

Provide a higher value for SNMP retry count and timeout value and then rediscover the Branch Repeater device.

0250905

On a HA failover, alarm triggers configured in the primary appliance within the file synchronization interval will be lost. As a result, the alarm triggers created are not displayed in the Command Center UI after the failover .

Note: Configuration files synchronization happen between primary and secondary appliance every 2 minutes by default.

You can re-create the alarm triggers in Command Center.

0228281

Show Running Configuration and Difference between Running and Saved Configuration fails if the SSH password contains single quote (') or double quote (") characters.

Do not use single quote (') or double quote (") characters in your password.

Maintenance Release

Updated: 2014-05-20

This section describes the enhancements, changes, fixed issues, and known issues provided in the maintenance releases of the Citrix Command Center software.

  • Build 30.5
  • Build 31.6
  • Build 32.2
  • Build 33.3
  • Build 34.4

Build 34.4

Updated: 2014-05-16

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds in Citrix Command Center release 5.1, build 34.4.

In this section:

  • New in This Release
  • Bug Fixes
  • Limitations
  • Known Issues and Workarounds

New in This Release

Updated: 2014-05-16

The Citrix Command Center Release 5.1, Build 34.4 includes the following new features and enhancements.

Ability to search by Device in the Task Execution Log page

You can now search for a device by device name, task name and status after navigating to Configuration > Configuration > Execution Log.

Configuring Server Log Settings Changes
On the graphical user interface (GUI), the Logs Settings page ( Administration > Logging > Logs Settings) now displays the following details:
  • Logger: Type of log file.
  • Level: Level of log you want to generate. Select the log level for a file.
  • Appender: A link to set the file appender details.
    When you click on file name in the Appender column, you can modify the following settings:
    • File Name: Name of the log file with which the appender is associated.
    • Max Backup: Maximum number of files to be backed up when storing the logs. When this limit is reached, the log file is rolled back.
    • File Size: Maximum size of the log file.

The log-file storage behavior of Command Center 5.1 build 34.x is different from that of Command Center 5.1 build 33.3 or earlier builds.

When you install Command Center 5.1 build 33.3 and earlier builds, Command Center initially creates two log files, <logfilename>.txt and <logfilename1>.txt, in the CC_home/logs/ path and stores the log information in the <logfilename1>.txt file. By default, <logfilename>.txt remains empty. When <logfilename1>.txt reaches the limit for maximum size, Command Center 5.1 build 33.3 or earlier builds creates a new file, <logfilename<N>>.txt and stores the log information in that file until it reaches the size limit.
Note: <N> represents a numeric value.

When you install Command Center 5.1 build 34.4, Command Center initially creates only one log file, <logfilename>.txt, and stores log information in this file. When the file size reaches the limit, Command Center 5.1 build 34.4 creates <logfilename>.txt.<N>.

If you upgrade Command Center from version 5.1 build 33.3 or any earlier builds to 5.1 build 34.4, Command Center stores the log information in the existing empty <logfilename.txt> file. If that file reaches the file-size limit, Command Center creates a new file, <logfilename>.txt.<N>, and stores the log information in that file until it reaches the file-size limit.

Progress of Executed Tasks

After you provide the details for executing a built-in task or a custom task, a pop-up screen appears, stating that the task execution is in progress. You are redirected to the Execution Log page that displays the progress of the executed task.

Mbps unit removal from table header

On the CloudBridge dashboard page (Monitoring > CloudBridge > Dashboard), the Mbps designator is no longer in the WAN Sent, WAN Received, LAN Sent and LAN Received table headers. It now appears in each entry in the table.

Support for subdomain names with more than four characters

Email addresses in the To field now support subdomain names with more than four characters.

Bug Fixes

Updated: 2014-05-14

The following table describes the bugs fixed in Command Center Release 5.1 build 34.x.
Issue ID Issue Description

0407104

On the Administration tab, after you configure the access setting values for server protocol and server port, and then upgrade Command Center, the values are reset to default server protocol and server port.

0429631

The sorting option after performing a search under the Monitoring tab does not work.

0435675

The SoftwareUpgrade task fails to upgrade CloudBridge appliances.

0443441

Huge NetScaler configuration files causes high disk usage.

0446983

You might not be able to configure a high availability (HA) setup after upgrading a Command Center hardware appliance to version 5.1 build 33.3.

0451089

On a Command Center hardware appliance version 5.1 build 33.3, a failover can cause the MYSQL replication to fail, which in turn can disable high availability (HA) functionality.

0451367

On the Configuration tab, when you add or edit a custom task, and click Add Command to add a command, the Command field displays very long commands in a single line and does not provide the scroll option.

0451390

On the Configuration tab, when you edit a custom task and click Add Task Variable to add a variable task, some fields are not displayed.

0451621

On the Configuration tab, the task specific execution log does not display the Command Center user details.

0452151

After you upgrade Command Center, you cannot change the Command Center password.

0452506

You might not be able to configuring a high availability (HA) setup after changing the password of a Command Center hardware appliance.

0458009

If you use the Command Center graphical user interface (GUI) to change the database password for a high availability (HA) setup, the password change is not propagated to the secondary Command Center.

0461609

The Monitoring tab might not display the list of polled entities for a NetScaler HA pair.

0470491

The Change Password page does not load when you use the Google Chrome browser, version 34.0.1847.131, to change the password from the Command Center login page.

Workaround: Navigate to Administration > Security > Change Password to change the password.

Limitations

Updated: 2014-05-15

The following table describes the limitations in Command Center software from Release 5.1 build 34.4.
Issue ID Issue Description

0290553

The advanced search, and find device feature formerly on the Home page are not available in the Command Center release 5.2, because of migration to the new user interface framework.

0234377 and 399202

The built-in task, SoftwareUpgrade, for CloudBridge is not supported for CloudBridge 700 platforms.

0347274

The details of a security violation, of type APPFW_CSRF_TAG, displayed in AppFirewall log messages are incorrect for NetScaler devices running release 10.0.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.2.

The following export options are not available in Command Center release 5.2.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0371907

When you replicate a configuration on a NetScaler device, the L2 and L3 configurations are also replicated.

0377592

If the number of failure objects in Command Center is high and you create or modify custom views in Events and Alarms, a script error occurs.

0381157

When a secure FTP to a NetScaler device fails, an OutOfMemory (OOO) error occurs.

Known Issues and Workarounds

Updated: 2014-05-16

The following table describes the known issues with their workarounds in Command Center software from Release 5.1 build 34.4.
Issue ID Issue Description Workaround

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

0356104

If you upgrade the Command Center software from release 4.1 to release 5.2, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates.

 

0358712

You might be unable to log onto Command Center after afresh installation, because of a corrupted security configuration.

After a fresh installation, reset the Command Center setup by reinitializing it. To do so, run the reinitialize_nms.bat or reinitialize_nms.sh script, which is located in the <CCHome>/bin/ folder.

0470491

The Change Password page does not load when you use the Google Chrome browser, version 34.0.1847.131, to change the password from the Command Center login page.

Navigate to Administration > Security > Change Password to change the password.

0443894

If Command Center fails to discover any CloudBridge devices, the CloudBridge Dashboard (Monitoring > CloudBridge > Dashboard ) page does not display those devices. However, with this build, the Operational state on the CloudBridge dashboard page displays a – symbol.

 

Build 33.3

Updated: 2013-11-11

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds in Citrix Command Center release 5.1, build 33.3.

In this section:

  • New in This Release
  • Bug Fixes
  • Limitations
  • Known Issues and Workarounds

New in This Release

Updated: 2013-11-11

The Citrix Command Center Release 5.1, Build 33.3 includes the following new features and enhancements.

Support for CloudBridge 4000/5000 Platforms running release 7.1.0

Command Center now supports CloudBridge 4000/5000 platforms running CloudBridge release 7.1.0

New Counter Support for NetScaler devices

The AAA group includes a new counter: Current ICA Sessions.

Download the Configuration Details of CloudBridge Devices

The CloudBridge Device Properties page now includes a Download button, with which you can download the configuration of a CloudBridge device as a zipped file.

Wild-card Character Support

In custom views of entity monitoring, the input values (like VServer Name, VServerIP, Service Name and others) now support the usage of wild-card characters : asterisk (*), exclamation mark (!), and separator (,).

GUI Changes

In Configuration > Built-in Tasks page, the built-in tasks are now organized into two separate tabs: NetScaler and CloudBridge.

Bug Fixes

Updated: 2013-11-11

The following table describes the bugs fixed in Command Center Release 5.1 Build 33.3
Issue ID Issue Description
0423165 The blocked or transformed information is not displayed when AppFirewall violation is blocked or transformed.
0431067 If you log on to Command Center appliance while it is being backed up, the Command Center user interface does not notify you that the backup is in progress.
0416208 A user who is not assigned Execute permission for Reporting is able to view data on AppFirewall Dashboard.
0418543 Task execution logs do not contain the reasons for the failure of commands, nor the details of the scheduled tasks.
0414804 If CEF logging is enabled, AppFirewall reporting does not function when the AppFirewall syslog message does not contain a session-ID field.
0414851 The format of the APPFW CSRF TAG syslog message is not in the expected format. As a result, the values displayed in AppFirewall Recent Logs are incorrect
0412261 Discovery and rediscovery of NetScaler devices with SNMP V3 profile intermittently generates the following alarm: usmStatsNotInTimeWindows.
0413811 Command Center does not support violation type AF_400_RESP under AppFirewall Reporting.
0430057 The refresh timeout rate for Entity monitoring list views is low. Therefore, the selection of data is lost for the operations performed on the entities.
0427600 For the built-in report, VirtualServerThroghputDistribution, if the Plot bound Services check box is selected when you view reports in graphical format, the following error message appears: com.ns.ems.common.report.ReportData cannot be cast to java.lang.Integer.
0396514 After CloudBridge devices process traffic for an extended period of time, the following reports might show incorrect values: CloudBridge System, CloudBridge App Traffic +, CloudBridge QOS Stats +, and CloudBridge Link Stats + .
0332765 The Command Center HA setup stops working when JVM fails on the Command Center secondary server.

Limitations

Updated: 2013-11-11

The following table describes the limitations in Command Center software from Release 5.1, build 33.3 or later.
Issue ID Issue Description
0399202

The built-in task, SoftwareUpgrade, for CloudBridge is not supported for CloudBridge 700 platforms.

0398919 The counter values for Transmit Link utilization and Receive link Utilization are incorrect.
0383438 If you initiate a high availability configuration from an appliance by using the Setup High Availability option in the graphical user interface, an error occurs and high availability configuration is not successful.
0381157 When a secure FTP to a NetScaler device fails, an OutOfMemory (OOO) error occurs.
0377592 If the number of failure objects in Command Center is high and you create or modify custom views in Events and Alarms, a script error occurs.
0371907

When you replicate a configuration on a NetScaler device, the L2 and L3 configurations are also replicated.

0370232

The Replicate Configuration feature is not supported for a NetScaler cluster or for NetScaler devices in a high availability pair.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.1.

The following export options are not available in Command Center release 5.1.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0347274

The details of a security violation, of type APPFW_CSRF_TAG, displayed in AppFirewall log messages are incorrect for NetScaler devices running release 10.0.

0347208

In the Authentication settings for Active Directory Group extraction, the option to retrieve the attributes from Active Directory server, and then select the attributes from the retrieved list, is not available in Command Center release 5.1.

0337817

The option to customize the columns on the Device Inventory, Alarms, Events, Virtual Servers, Services, Service Group, and Custom View pages in Command Center user interface is not available in the Command Center release 5.1.

0315632

When creating views for SNMP alarms and events in Faults tab, selecting a device type on the Create View page does not load the filter criteria associated with the device type.

0290553

The advanced search, and find device feature formerly on the Home page are not available in the Command Center release 5.1, because of migration to the new user interface framework.

Known Issues and Workarounds

Updated: 2013-12-06

The following table describes the known issues with their workarounds in Command Center software from Release 5.1, build 33.3 or later.
Issue ID Issue Description Workaround
0383097 Command Center service is unable to start and the following error is displayed, "Error 1067: The process terminated unexpectedly". This is due to an issue in JRE 1.6 version, which might cause automatic deletion of the rt.jar file after a restart. Execute the RecoverJRE.bat/sh script available under <CC_INSTALL_HOME>/bin directory and then start the server.
0366507 You cannot modify the device profile from Citrix Network > Add Device > Modify icon. Navigate to Administration > Settings > Device Profiles, right-click the device profile and click Modify .

0356104

If you upgrade the Command Center software from release 4.1 to release 5.1, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates).

Click Poll Now to display the certificates.

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

Build 32.2

Updated: 2013-08-14

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds in Citrix Command Center release 5.1, build 32.2.

In this section:

  • New in This Release
  • Bug Fixes
  • Limitations
  • Known Issues and Workarounds

New in This Release

Updated: 2013-08-14

The Citrix Command Center Release 5.1, Build 32.2 includes the following new features and enhancements.

Authentication Enhancements

This release, delivers the following enhancements to the authentication capabilities of Command Center:

  • RADIUS Authentication Settings

    The way that Command Center handles RADIUS authentication after a forced failover is improved. If you configure Command Center servers in high availability mode with RADIUS authentication, you must provide the Secondary Server Client Identifier details.

  • Ability to Verify Authentication Server Settings and Connectivity

    With this release, the authentication server settings specified under Administration > Security > Authentication Settings are verified. If the settings are not accurate, an error message prompts you to specify the correct settings.

  • Search for Active Directory Groups

    If you enable group extraction from Active Directory, you can browse and search for Active Directory groups while adding groups in Command Center. The number of search results is limited to 5000 results.

Counter Reporting Enhancements

With this release, Command Center can generate a report to plot the difference in the following counter values between the polling cycles: Vserver hits, Request bytes, Response bytes, Total Packets rcvd, Total Packets sent, Current client connections, Current Client Est connections, Current server connections, and Spill Over Hits.

Support for SNMP Object Identifiers
Command Center now supports and responds to the following RFC 1213 Standard MIB OIDs:
  • oid .1.3.6.1.2.1.1.6 (location)
  • oid .1.3.6.1.2.1.1.4 (contact)
  • oid .1.3.6.1.2.1.1.1 (description)

You can now view the location, contact and description details.

Host Name Column Added in Device Inventory Page

With this release, a new column, Host Name, displays the hostname of the discovered device on the Device Inventory page.

Bug Fixes

Updated: 2013-08-14

The following table describes the bugs fixed in Command Center Release 5.1 Build 32.2
Issue ID Issue Description
0412131 If you use Internet Explorer with the Compatibility View enabled, to access the Command Center user interface, the logon is unsuccessful and the user credentials appear in the address bar.
0365125 You cannot access Command Center graphical user interface using the host name if you are using Internet Explorer 9 browser in Compatibility View.
0406857

The graphs on the Device Properties page and Appfirewall Dashboard page are not displayed properly if you log on to Command Center with non-root-user credentials because the image directory is not available to a non-root user.

0405956 After a CloudBridge Advanced platform is discovered in Command Center version 5.1, build 30.5, the default status polling of the platform fails to discover the NetScaler instance, CloudBridge, and CloudBridge Accelerator.
0404208 When creating a custom task by importing a file, it takes a longer time to add a custom task if the input command file is large.
0402416 When events or alarms are exported to a .csv file, the date and time details do not display the data in seconds.
0374806 For each authentication attempt during discovery and "Invoke CLI" in Command Center, multiple authentication requests are sent to a NetScaler configured with LDAP or RADIUS authentication.

Limitations

Updated: 2013-08-14

The following table describes the limitations in Command Center software from Release 5.1, build 32.2 or later.
Issue ID Issue Description
0399202

The built-in task, SoftwareUpgrade, for CloudBridge is not supported for CloudBridge 700 platforms.

0398919 The counter values for Transmit Link utilization and Receive link Utilization are incorrect.
0396514

After CloudBridge devices process traffic for an extended period of time, the following reports might show incorrect values: CloudBridge System, CloudBridge App Traffic +, CloudBridge QOS Stats +, and CloudBridge Link Stats + .

0383438 If you initiate a high availability configuration from an appliance by using the Setup High Availability option in the graphical user interface, an error occurs and high availability configuration is not successful.
0381157 When a secure FTP to a NetScaler device fails, an OutOfMemory (OOO) error occurs.
0377592 If the number of failure objects in Command Center is high and you create or modify custom views in Events and Alarms, a script error occurs.
0371907

When you replicate a configuration on a NetScaler device, the L2 and L3 configurations are also replicated.

0370232

The Replicate Configuration feature is not supported for a NetScaler cluster or for NetScaler devices in a high availability pair.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.1.

The following export options are not available in Command Center release 5.1.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0347274

The details of a security violation, of type APPFW_CSRF_TAG, displayed in AppFirewall log messages are incorrect for NetScaler devices running release 10.0.

0347208

In the Authentication settings for Active Directory Group extraction, the option to retrieve the attributes from Active Directory server, and then select the attributes from the retrieved list, is not available in Command Center release 5.1.

0337817

The option to customize the columns on the Device Inventory, Alarms, Events, Virtual Servers, Services, Service Group, and Custom View pages in Command Center user interface is not available in the Command Center release 5.1.

0315632

When creating views for SNMP alarms and events in Faults tab, selecting a device type on the Create View page does not load the filter criteria associated with the device type.

0290553

The advanced search, and find device feature formerly on the Home page are not available in the Command Center release 5.1, because of migration to the new user interface framework.

Known Issues and Workarounds

Updated: 2013-08-14

The following table describes the known issues with their workarounds in Command Center software from Release 5.1, build 32.2 or later.
Issue ID Issue Description Workaround
0383097 Command Center service is unable to start and the following error is displayed, "Error 1067: The process terminated unexpectedly". This is due to an issue in JRE 1.6 version, which might cause automatic deletion of the rt.jar file after a restart. Execute the RecoverJRE.bat/sh script available under <CC_INSTALL_HOME>/bin directory and then start the server.
0366507 You cannot modify the device profile from Citrix Network > Add Device > Modify icon. Navigate to Administration > Settings > Device Profiles, right-click the device profile and click Modify .

0356104

If you upgrade the Command Center software from release 4.1 to release 5.1, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates).

Click Poll Now to display the certificates.

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

Build 31.6

Updated: 2013-06-21

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds in Citrix Command Center release 5.1, build 31.6.

In this section:

  • New in This Release
  • Bug Fixes
  • Limitations
  • Known Issues and Workarounds

New in This Release

Updated: 2013-06-21

The Citrix Command Center Release 5.1, Build 31.6 includes the following new features and enhancements.

Command Center Appliance Setup Wizard

You can configure the initial settings by using the Setup Wizard available on the Administration > Operations screen in the Command Center graphical user interface. You can also use the wizard to change the existing network settings.

Command Center Appliance Operations
With this release, the operations specific to Command Center Appliance are grouped and available in the Command Center graphical user interface on the Administration > Operations.The following operations available:
  • Setup Wizard—You can configure the initial settings or modify the existing network settings with this wizard.
  • Backup—You can perform an immediate backup of the database on the Command Center appliance.
  • Schedule Backup—You can schedule a backup of the database on the Command Center appliance
  • Force Failover —You can force a failover if, for example, you need to replace or upgrade the primary node. Force failover is always initiated from the primary node. Note that after you confirm, the appliance is shut down. To log on you have to use the IP address of the secondary appliance. To view the status and other details, refer the log file in the logs/forcefailover_cc_ha.log directory.
  • Reboot—You can use this option to restart appliance.
  • Shutdown—You can use this option to shut down the appliance.
    Note: The Administration > Operations section is displayed only when you log on to Command Center appliance.
Command Center Appliance Logs

You can now view the user and error log messages for appliances configured for high availability in separate log files: hauser.txt and haerr.txt

Root User Credentials Management in Command Center Appliance

In Command Center appliance, when you modify the root user credentials on the primary, the password for the root user in Command Center, SSH root user of the CentOS, SSH root user of the XenServer, and the database password on both primary and secondary appliances are modified.

New Built-in Tasks
This release introduces the following new built-in tasks:
  • InstallCACert—Install CA certificates for CloudBridge.
  • InstallCombinedCertKey—Install combined certificate key for CloudBridge.
  • InstallSeparateCertKey—Install separate certificate key for CloudBridge.
  • NSConfigureSyslogServer—Configure syslog server settings on NetScaler devices.
New SNMP Traps

This release adds, NetScaler-release-10.1-specific SNMP traps to Command Center.

Support for CloudBridge 2000 and 3000 Platforms

Command Center provides support for CloudBridge 2000 and 3000 platforms. After the CloudBridge device is discovered, you can perform various tasks to manage and monitor the device from the Command Center console.

Email Report Highlighting the Configuration Changes

You can choose to receive a report of changes to the configuration by selecting the Email the report check box while configuring an audit policy. You can also specify weather you want to receive the configuration report as an attachment in CVS file format. If the configuration changes, you receive an email listing the changes after the audit policy is applied (at the scheduled time.) You can also check if the accuracy of the mail server credentials and verify that the mail server is accessible from Command Center appliance by clicking Test Mail. If the connection to the mail server is successful, a test mail is sent to the specified email address and the settings are saved.

Ability to Verify Mail Server Settings and Email Connectivity

With this release, you can check to make sure the mail server settings specified under Administration > Settings > Mail Server Settings are accurate and connection to the mail server is established. If the connection to the mail server is successful, a test message is sent to the email address specified in the settings and the settings are saved. Otherwise an error message is displayed prompting you to specify the accurate settings.

You can also verify the mail server settings specified by clicking the Test Mail button available on pages where you can schedule email alerts. For example, pages where you can schedule custom report, schedule Appfirewall report, schedule Appfirewall dashboard report, schedule policy, and schedule event or alarm triggers

CloudBridge Dashboard

You can use the CloudBridge Dashboard to view the status of all the CloudBridge appliances being managed by Command Center. The CloudBridge Dashboard is now available under Monitoring > CloudBridge > Dashboard.

Rebranding Changes

In this release, the Branch Repeater and Repeater products are renamed as CloudBridge products, and the Access Gateway is renamed as NetScaler Gateway. The following table lists the product-name changes:

Prior to Rebranding Post Rebranding
NetScaler NetScaler MPX
NetScaler VPX NetScaler VPX
NetScaler VPX (running on SDX) NetScaler Instance
NetScaler VPX (running on Branch Repeater SDX) NetScaler Instance
Access Gateway NetScaler Gateway
NetScaler Cluster NetScaler Cluster
NetScaler SDX NetScaler SDX Platform
Repeater, Branch Repeater CloudBridge

This also includes the Repeater 8500 and Repeater 8800 series.

Branch Repeater VPX CloudBridge VPX
Repeater for SDX CloudBridge Accelerator
Branch Repeater SDX (previously represented as NetScaler SDX along with model numbers), CloudBridge 2000 and 3000 platforms. CloudBridge Advanced Platform
XenServer XenServer
Apart from the above product-name changes, the following changes are also available in this release:
  • Devices are no longer represented by icons in the Device Inventory.
  • Two new columns, Type and State, on Device Inventory page identify the device types that were formerly represented by icons. The Type column specifies the type of device, such as NetScaler VPX, NetScaler MPX or NetScaler Instance. The State column specifies the category of device, such as Standalone or Primary.

Bug Fixes

Updated: 2013-06-21

The following table describes the bugs fixed in Command Center Release 5.1 Build 31.6
Issue ID Issue Description
0371931 If you shut down a NetScaler VPX on XenServer that is already discovered in Command Center and re-assign the same IP address to a new NetScaler VPX, the following error occurs, "Exception in NsSnmpPingTask and exception is The EngineID is Wrong" and the discovery of new NetScaler VPX fails.

0377149

Repeated emails are generated when multiple alert triggers are configured with the same criteria and the alarm age property and email action are also configured on them.

0380635

Rediscovery of a NetScaler SDX device in Command Center modifies the SNMP trap and results in restart of the SNMP daemon.

0383915

Total count of Events, Alarms and Syslogs is not displayed accurately in Command Center user interface.

0386827

After a device with SNMP v3 credentials is discovered, SNMP authentication traps are generated during polling for entities, even if the SNMP request is being handled successfully.

0394630

A warning message is not displayed when unauthorized users modify the group details.

0394692

If a recurring task, which is scheduled on more than two devices, is stopped for a particular device, the stop functionality works only once for that device. For the next scheduled time, the state of the task for that device is automatically displayed as Scheduled even though the task was stopped for that device.

0394750

If you created a device profile in Command Center release 4.x and have since upgraded to release 5.x, you cannot modify the device profile created in Command Center release 4.x.

0394755

If counters are not associated with a custom report, modifying or deleting the custom report is not possible.

0398314

If you create a group name with more than 20 characters, and configure the Advanced settings, an error occurs when you modify the permissions for that group.

Limitations

Updated: 2013-06-21

The following table describes the limitations in Command Center software from Release 5.1, build 31.6 or later.
Issue ID Issue Description

0370232

The Replicate Configuration feature is not supported for a NetScaler cluster or for NetScaler devices in a high availability pair.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.1.

The following export options are not available in Command Center release 5.1.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0347274

The details of a security violation, of type APPFW_CSRF_TAG, displayed in AppFirewall log messages are incorrect for NetScaler devices running release 10.0.

0347208

In the Authentication settings for Active Directory Group extraction, the option to retrieve the attributes from Active Directory server, and then select the attributes from the retrieved list, is not available in Command Center release 5.1.

0337817

The option to customize the columns on the Device Inventory, Alarms, Events, Virtual Servers, Services, Service Group, and Custom View pages in Command Center user interface is not available in the Command Center release 5.1.

0315632

When creating views for SNMP alarms and events in Faults tab, selecting a device type on the Create View page does not load the filter criteria associated with the device type.

0290553

The advanced search, and find device feature formerly on the Home page are not available in the Command Center release 5.1, because of migration to the new user interface framework.

0371907

When you replicate a configuration on a NetScaler device, the L2 and L3 configurations are also replicated.

0399202

The built-in task, SoftwareUpgrade, for CloudBridge is not supported for CloudBridge 700 platforms.

0398919 The counter values for Transmit Link utilization and Receive link Utilization are incorrect.
0396514

After CloudBridge devices process traffic for an extended period of time, the following reports might show incorrect values: CloudBridge System, CloudBridge App Traffic +, CloudBridge QOS Stats +, and CloudBridge Link Stats + .

0377592 If the number of failure objects in Command Center is high, a script error occurs when you try to create or modify custom views in Events and Alarms.
0383438 If you initiate a high availability configuration from an appliance by using the Setup High Availability option in the graphical user interface, an error occurs and high availability configuration is not successful.
0381157 When secure FTP to a NetScaler device fails, an OutOfMemory (OOO) error occurs.
0383097 Command Center service is unable to start and the following error is displayed, "Error 1067: The process terminated unexpectedly". This is due to an issue in JRE 1.6 version, which might cause automatic deletion of the rt.jar file after a restart.

Known Issues and Workarounds

Updated: 2013-06-21

The following table describes the known issues with their workarounds in Command Center software from Release 5.1, build 31.6 or later.
Issue ID Issue Description Workaround

0356104

If you upgrade the Command Center software from release 4.1 to release 5.1, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates).

Click Poll Now to display the certificates.

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

365125

You cannot access Command Center graphical user interface using the HostName if you are using Internet Explorer 9 browser in Compatibility View.

Change to the standard view by clearing the Display all websites in Compatibility View check box in Tools > Compatibility View Settings dialog box.

Build 30.5

Updated: 2013-06-21

The Citrix Command Center Release Notes describe the new features and enhancements, limitations, and known issues and workarounds in Citrix Command Center release 5.1, build 30.5.

In this section:

  • New in This Release
  • Bug Fixes
  • Limitations
  • Known Issues and Workarounds

New in This Release

Updated: 2014-02-17

The Citrix Command Center Release 5.1, Build 31.1 includes the following new features and enhancements.

Command Center Appliance Setup Wizard

You can configure the initial settings by using the Setup Wizard available under Administration > Operations screen in Command Center graphical user interface. You can also change the existing network setting using this wizard.

Command Center Appliance High Availability Setup

You can initiate a high availability configuration from an appliance by using the Setup High Availability option under Administration> Operations. The appliance from which the configuration is initiated is designated as the primary node.

Repeater Dashboard

You can use the Repeater Dashboard to view the status of all the Repeater appliances being managed by Command Center. You can view the Name, Operation State, System Load, Data Reduction, WAN Sent, WAN Received, LAN Sent, and LAN Received data for each of the discovered device. The dashboard data is refreshed based at the frequency specified by the configured polling interval. By default, the data is refreshed every 5 minutes.

Backup, Replicate, and Restore Configuration of a NetScaler

To save time and minimize configuration errors, you can use Command Center to replicate the configuration of a NetScaler device to multiple NetScaler devices on your network. Command Center does not propagate node- or device-specific details, such as NetScaler IP addresses.

You can view the status of a configuration that has been replicated on one or more NetScaler devices and you can view the list of commands executed during replication. You can also view the details of each of the commands executed, such as, attribute name, number of retries, start time, finish time, the result of command execution, the user name of the Command Center user who executed the command, the command that was executed, location where the configuration is saved, and the success status of the command execution. Also, you can view and download the configuration status of the batch commands executed.

You can track the configuration details and downloaded files on the NetScaler Device Properties page. You can archive configuration of a device at any given time by clicking on the Backup Config button and you can restore the current NetScaler Configuration with an archived configuration by clicking on the Restore Configuration link against a timestamp.

Note: When you upgrade the Command Center server from version 5.0 or 5.1 to version 5.1, build 30.5, you cannot restore the current configuration with a configuration that was achieved before the upgrade.
Important: If you are using the MySQL database, make sure you have configured the max_allowed_packet parameter value to 16M.
Syslog Purge Interval

To limit the amount of syslog data stored in the database, you can now specify the interval at which to purge syslog data. By default, Command Center stores syslog messages for the last 90 days. To customize the purge interval, you can specify the number of days in the Administration > Server Settings > Syslog Clean interval (in days) field. Only the records older than the number of days that you specify are purged. For example, if you specify as 45 days, Command Center purges syslog messages that are older than 45 days.

Password Expiry Notification

If you specify the password expiry value for the user account, the password expires after the number of days specified. When the password is about to expire, a notification is displayed when you log on to Command Center server, and you are prompted to navigate to the Change Password screen to modify the password.

GUI Label Enhancements

The following GUI label changes have been introduced in this release:

  • The Message column in the Events and Alarms listing under Fault has been renamed to Description.
  • The Event Message and Alarm Message fields in the Triggers and Custom Views has been renamed to Filter based on event description and Filter based on alarm description.
Device Family Details Includes Additional Information

When you export the device family details to a CSV file, you can now view additional details such as the serial number of the device.

Bug Fixes

The following table describes the bugs fixed in Command Center Release 5.1 Build 30.5
Issue ID Issue Description
0346650 Configuration of Command Center appliances in High Availability mode fails in Command Center release 5.0, build 35.11.
0351737 The Command Center software version displayed in the Add/Remove Programs >Support information window is incorrect.
0353659 You cannot select a group from the Active Directory groups list in Command Center if any of the Active Directory group names includes backslash (\) character.
0360662 and 0307457 C# and Java Nitro API support for Command Center is not available in the Command Center release 5.1.
0361321 The Active Directory users present under sub domain are not authenticated in Command Center.
0361473 The configuration of the Syslog Purge Interval doesn't work.
0363434 The resource check for port "8009" is removed as this port is no longer used by Command Center.
0369068 If a Netscaler device is configured with a SNMP Community containing special characters, such as an asterisk (*), Command Center generates a ConfigChange and SaveConfig trap for that device upon every rediscovery.
0356432 The discovery of Citrix Branch Repeater with Windows Server (CBRwWS), running release 6.2.0 or later, fails because the Command Center server does not automatically add the Command Center IP address as an SNMP manager on CBRwWS during the discovery process.

Limitations

The following table describes the limitations in Command Center software from Release 5.1, Build 30.5 onwards.
Issue ID Issue Description

0371907

When you replicate a configuration on a NetScaler device, the L2 and L3 configurations are also replicated.

0370232

The Replicate Configuration feature is not supported for NetScaler cluster and NetScaler devices in a high availability pair.

0354869

The option to export the details in the custom views of Events and Alarms is not available in Command Center release 5.1.

The following export options are not available in Command Center release 5.1.

  • Export entire custom view data
  • Export displayed data
  • Export Annotations

0347274

The details of the security violation, of type "APPFW_CSRF_TAG" ,displayed in AppFirewall log messages are incorrect for NetScaler devices running 10.0 releases.

0347208

In the Authentication settings for Active Directory Group extraction, option to retrieve the attributes from Active Directory server, and then select the attributes from the retrieved list, is not available for Command Center release 5.1.

0337817

The option to customize the columns on the Device Inventory, Alarms, Events, Virtual Servers, Services, Service Group, and Custom View pages in Command Center user interface is not available in the Command Center release 5.1.

0315632

When creating views for SNMP alarms and events in Faults tab, selecting a device type on the "Create view " page does not load the filter criteria associated with the device type.

0290553

The advanced search, and find device feature in Home page are not available in the Command Center release 5.1. This is because of migration to the new user interface framework.

Known Issues and Workarounds

The following table describes the known issues with their workarounds in Command Center software from Release 5.1, Build 30.5 onwards.
Issue ID Issue Description Workaround
0366507 You cannot modify the device profile from Citrix Network > Add Device > Modify icon. Navigate to Administration > Settings > Device Profiles, right-click the device profile and click Modify.

0356104

If you upgrade the Command Center software from release 4.1 to release 5.1, the list of polled SSL certificates is not displayed in the Certificates page (Configuration > Certificate Management > Certificates).

Click Poll Now and the certificates will be displayed.

0352280

When you discover a NetScaler device with an SNMP v3 profile, the discovery fails if the SNMP user already exists on the device.

Make sure that the SNMP configuration on the device is correct, or use a new SNMP user and try to discover the device.

0332765

The Command Center HA setup stops working when JVM fails on the Command Center secondary server.

Restart the Command Center secondary server.