Product Documentation

What's new

Nov 27, 2017

Citrix SCOM Management Pack 1.3 for ShareFile introduces the following new or enhanced features:

  • Documentation in HTML format. The documentation for the Citrix SCOM Management Pack 1.3 for ShareFile is available in HTML format. 
  • Support for Microsoft System Center Operations Manager 2016. This product version extends support for Microsoft System Center Operations Manager to include its latest release.
  • Support for Citrix ShareFile versions 4.1 and 4.0. This product version extends support for Citrix ShareFile to include its latest two releases.
  • Proxy server support. You can use this product version to monitor ShareFile deployments in which StorageZones Controller instances are configured to use a proxy server. You can configure proxy server-related settings in the ShareFile MP Configuration tool. 
    Citrix SCOM Management Pack for ShareFile supports the following modes of authenticating with the proxy server: none (unauthenticated connections), basic, NTLM. HTTP is supported as the only protocol for connecting to the proxy server.
    For more information, see Install and configure.

Known issues

The following is a list of known issues in this product version.

  • Issue ID: SCOM-898
    Symptom: In the ShareFile MP Configuration tool, modifications of the Enable Proxy option are not immediately reflected in the Enabled column in the main window.
    Action: None. The tool properly enables or disables configuration entries. The column shows the correct option values after the configuration changes are applied (by clicking OK in the main window) and the tool is started again.

  • Issue ID: SCOM-770
    Symptom: Health states of several aggregate rollup monitors are not propagated up to the Customer Managed Zones level; they are not propagated at all. Examples of such monitors are:
    – Availability Health Rollup From StorageZone Service Group to StorageZone Controller Monitor
    – Configuration Health Rollup From StorageZone Service Group to StorageZone Controller Monitor
    Action: None. There is no workaround available.

  • Issue ID: SCOM-514
    Symptom: In the output of the Check Requirements and Configuration for Citrix MPSHF Agent task in the SCOM Operations console, user names and folder names that contain non-ASCII characters are not displayed correctly. For example, Spanish characters çñ appear as ╬¤ in such a name.
    Action: None. Apart from the visual glitch, the functionality of the product is not affected in any way. You can therefore safely ignore the symptom.

  • Issue ID: SCOM-459
    Symptom: During a Citrix SCOM Management Pack for ShareFile upgrade on the SCOM management server computer, the Setup Wizard fails to import the included management packs. This issue occurs when the effective installation folder of the new product version differs from the installation folder of the earlier version.
    Action: After you close the Setup Wizard, manually import the management packs. For instructions, see section Manually importing included management packs into SCOM in Optimize.

  • Issue ID: SCOM-411
    Symptom: After upgrading the product from the version 1.1, the %ProgramData%\Comtrade folder is left on the local system. This issue occurs on the SCOM management server computer as well as on the agent-managed computers.
    Action: Manually remove the residuary folder by using an operating system tool.

Upgrading

Note: Earlier product versions were released under the name Comtrade Management Pack for Citrix ShareFile.

Upgrade is available only for the following version: 1.1. During the upgrade process, the included management packs of the earlier product version are automatically upgraded; they prior removal is not required.

To upgrade the Citrix SCOM Management Pack for ShareFile to its current version, do the following: 

  1. Prepare your environment for installation of the new product version. For instructions, see Preparing for the installation in Install and configure.
  2. Check if the .mpb file that was installed by the product is locked by any program, for example, SCOM Operations console or Windows PowerShell. This includes programs in both active and disconnected sessions. If the file is locked, exit the locking program, for example, exit the SCOM Operations console or close the Windows PowerShell window.
    Tip: To check if a file is locked, try renaming it and then reverting to its original file name. Inability to rename the file indicates a locking program. You can identify it by using the Handle utility of Sysinternals Suite (see the Handle webpage on the Microsoft TechNet website).
  3. Install the product (its server-side part) on the SCOM management server computer. For instructions, see Installing the product on the SCOM management server computer in Install and configure.
    Note: Installation process upgrades the product and preserves local configuration data.
  4. Verify the installation on the SCOM management server computer. For instructions, see Verifying the installation on the SCOM management server computer in Install and configure.
  5. On the SCOM management server computer, move the mpshf_config.dat file from the %ProgramData%\ComTrade\MPShare\ShareFile MP directory to the %ProgramData%\Citrix\CitrixMPShare\ShareFile MP directory.
  6. Configure access to the shared folder for agent installation. For instructions, see Configuring access to the shared folder for agent installation in Install and configure.
  7. Install the product (its agent-side part) on the StorageZones Controller computers. For instructions, see Installing the product on the StorageZones Controller computers in Install and configure.
    Important: In the Run Task – Install Citrix MPSHF Agent dialog box, set the UpgradeAgent task parameter to the true value.
  8. Verify the installation and configuration on the StorageZones Controller computers. For instructions, see Verifying the installation and configuration on the StorageZones Controller computers in Install and configure.