Product Documentation

Install and configure

Sep 03, 2017

This chapter contains instructions that you must follow to install and configure Citrix SCOM Management Pack for NetScaler. Perform all procedures in the documented order of precedence.

Note: Citrix recommends that you use the same versions of the Citrix SCOM Management Pack and of the Citrix SCOM Management Pack Agent to ensure that all features work correctly.

Preparing for the installation

Before installing Citrix SCOM Management Pack for NetScaler, make sure that the following prerequisites are fulfilled: 

  • Your environment meets the software requirements. For software requirements, see the System requirements.
  • A computer is chosen on which an SCOM management server resides and where the server side of Citrix SCOM Management Pack for NetScaler will be installed. This computer is referred to as the SCOM Management Server.
  • A SCOM resource pool is chosen for NetScaler monitoring. For easier deployment of Citrix SCOM Management Pack for NetScaler Agent and decreased SCOM resource usage, Citrix recommends that this is a custom resource pool (a resource pool designated to monitor NetScaler devices). 
  • An SNMP version is chosen that will be used for monitoring. Additionally, all required SNMP configuration parameters are defined and accounts for SNMP-based monitoring are configured in SCOM. 
  • All NetScaler appliances that you plan to monitor by using Citrix SCOM Management Pack for NetScaler are discovered by SCOM. For general instructions on network device discovery, see the How to Discover Network Devices in Operations Manager webpage on the Microsoft TechNet website.
    To discover network devices by using SNMPv1 or SNMPv2, do the following:
  1. Log on to NetScaler with an existing administrator account and by using an SSH client, for example, PuTTY. 
  2. Run the following command to configure the SNMP community:
    add snmp community <CommunityString> <Permission>
    In the above instances, <CommunityString> is the community name and <Permission> is the associated SNMP query type.
    Citrix recommends that you use the ALL query type only in the event that you are unable to discover devices by using some other query type. In this case, revert the NetScaler configuration to accept a more restrictive query type immediately after the discovery completes. 
  3. Log on to the management server computer and launch the SCOM Operations console. 
  4. In the Administration view, expand Network Management, and then click Discovery Rules. In the Tasks pane, expand Actions, and then click Discover Network Devices
  5. In the Network Devices Discovery Wizard, in the Name text box, type a name. From the Available servers drop-down list, select a discovery server, and from the Available pools drop-down list, select a resource pool.
    Note: Citrix recommends that you use a custom resource pool that you have created in advance specifically for the needs of NetScaler monitoring.
    Click Next
  6. In the Discovery Method page, leave the Explicit discovery option selected, and then click Next
  7. In the Default Accounts page, select a preconfigured account for SNMP-based monitoring. Click Next
  8. In the Devices page, click Add to open the Add a Device dialog box. In the Add a Device dialog box, enter the required data. Pay attention to select the appropriate account from the SNMP V1 or V2 Run As account drop-down list, to associate it with the device. Click OK to close the dialog box. 
  9. Repeat step 8 for each additional NetScaler device you plan to monitor. Click Next
  10. In the Schedule Discovery page, define a schedule for the discovery rule or choose to run the rule manually. Click Next
  11. In the Summary page, verify your settings, click Create, and then wait for the discovery rule to be created. 
  12. In the Completion page, click Close to close the wizard. 

Once the devices are discovered, their entries appear at two locations in the SCOM operations console: in the Administration view in the Network Management > Network Devices context and in the Monitoring view in the Network Monitoring > Network Devices context.

To discover network devices by using SNMPv3, do the following:

  1. Perform the necessary steps on the NetScaler devices. For instructions, see the Configuring the NetScaler for SNMPv3 Queries webpage (or a corresponding webpage for your NetScaler product version).
  2. Perform the necessary steps in the SCOM Operations console. For instructions, see the How to Discover Network Devices in Operations Manager webpage. Pay attention to the SNMP version.
  • All members of the SCOM resource pool that is designated for NetScaler device monitoring can access NetScaler devices through the following ports:
    • UDB port 161 — for generic discovery and monitoring provided by SCOM
    • TCP port 80 (HTTP) or 443 (HTTPS) — for NetScaler-specific discovery and monitoring 

Configuring NetScaler for monitoring by Citrix SCOM Management Pack for NetScaler

In order to access and communicate with NetScaler, Citrix SCOM Management Pack for NetScaler needs a NetScaler user account configured with proper privileges. This configuration step requires administrative access to NetScaler either through the SSH command-line interface (preferred) or through the NetScaler GUI. Depending on your choice, perform only one of the two procedures that follow. For better guidance, see also Citrix NetScaler documentation.

Set up the NetScaler Management Pack user account by using the NetScaler CLI

To set up the user account through the NetScaler CLI, do the following (the assumption is that the user account name is usrNetScalerMonitoring and the corresponding command policy is polNetScalerMonitoring):

  1. Log on to NetScaler with an existing administrator account and by using an SSH client, for example PuTTY.
  2. Run the following command to create a new command policy with proper permissions for NetScaler monitoring:
command Copy

add system cmdPolicy polNetScalerMonitoring ALLOW (^show\s+system\s+\S+)|(^show\s+system\s+\S+\s+.*)|(^show\s+configstatus)|(^show\s+configstatus\s+.*)|(^shell\s+nsconmsg\s+-K\s+\S+\s+.*)

For higher security, run the following command instead:

command Copy

add system cmdPolicy polNetScalerMonitoring ALLOW (^show\s+system\s+\S+)|(^show\s+system\s+\S+\s+.*)|(^show\s+configstatus)|(^show\s+configstatus\s (^shell\s+nsconmsg\s+-K\s+/var/nslog/newnslog\s+-d\s+consmsg\s+\|\s+grep\s+-E\s+'IP\s+address\s+conflict\|current\s+time')

    3. Run the following command to verify existence and allowed actions of the read-only policy:

command Copy

show cmdPolicy read-only

The command should generate an output similar to the following:

Output Copy

Command policy: read-only    Action: ALLOW

cmdspec: (^man.*)|(^show\s+(?!system)(?!configstatus)(?!ns ns\.conf)(?!ns savedconfig)(?!ns runningConfig)(?!gslb runningConfig)(?!audit messages)(?!techsupport).*)|(^stat.*)

Done

If the read-only policy does not exist, create one with the previously listed permissions. To update the command policy, use the set system cmdPolicy command.

    4. Run the following command to create a new system user:

command Copy

add system user usrNetScalerMonitoring

    5. Run the following commands to associate the user with the command policies:

command Copy

bind system user usrNetScalerMonitoring read-only 1

bind system user usrNetScalerMonitoring polNetScalerMonitoring 1

    6. Run the following command to verify configuration of the user account:

command Copy

show system user usrNetScalerMonitoring

The command should generate an output similar to the following:

Output Copy

User name: usrNetScalerMonitoring

Command Policy: read-only Priority:1

Command Policy: polNetScalerMonitoring Priority:1

Done

Set up the NetScaler Management Pack user account by using the NetScaler GUI

Note: Figures in this section reflect the GUI of NetScaler 11.1. GUI appearance in other NetScaler versions may be different.

To set up the user account through the NetScaler GUI, do the following:

  1. Launch a web browser and go to the NetScaler management host (host name or IP address). The login screen appears.

Figure NetScaler login screen

localized image

    2. Log in with credentials of an existing administrator account.
    3. In the NetScaler GUI, navigate to Configuration > System > User Administration > Command Policies.
    4. Add a new command policy with the following Command Spec regular expression:

command Copy

(^show\s+system\s+\S+)|(^show\s+system\s+\S+\s+.*)|(^show\s+configstatus)|(^show\s+configstatus\s+.*)|(^shell\s+nsconmsg\s+-K\s+\S+\s+.*)

For higher security, use the following regular expression:

command Copy

(^show\s+system\s+\S+)|(^show\s+system\s+\S+\s+.*)|(^show\s+configstatus)|(^show\s+configstatus\s+.*)|(^shell\s+nsconmsg\s+-K\s+/var/nslog/newnslog\s+-d\s+consmsg\s+\|\s+grep\s+-E\s+'IP\s+address\s+conflict\|current\s+time')

This command policy grants permissions to execute some show commands as well as the shell nsconmsg -K command to access the console message log on the NetScaler. The permissions are read-only.

Figure Creating a NetScaler command policy

localized image

    5. Click Create to create the command policy.

Important: Steps 6 to 19 apply only in case of a non-LDAP authentication. Steps 20 to apply only in case of the LDAP authentication.

    6. In the System > User Administration context, click Users.
    7. Click Add to open the Add System User dialog.

Figure Creating a system user in NetScaler

localized image

    8. Type the user name and password for the user account, and click Continue.
    9. In the Bindings pane, expand System Command Policy.
   10. In the User Command Policy Binding dialog, click >.

Figure The Command Policies dialog 

localized image

    11. In the Command Policies dialog, select the command policy created in the previous steps, then click Select.
    12. In the User Command Policy Binding dialog, set the Priority for the required command policies to 1.
    13. Click Bind.
    14. In the System User dialog, in the Bindings pane, expand System Command Policy.
    15. In the User Command Policy Binding dialog, click Add Binding, and then click >.
    16. In the Command Policies dialog, select the read-only policy.

The read-only command policy should be present in NetScaler by default. If the policy is missing, go back to step 3, create the read-only command policy and allow the following permissions:

command Copy

(^man.*)|(^show\s+(?!system)(?!configstatus)(?!ns ns\.conf)(?!ns savedconfig)(?!ns runningConfig)(?!gslb runningConfig)(?!audit messages)(?!techsupport).*)|(^stat.*)

    17. In the User Command Policy Binding dialog, set the Priority for the required command policies to 1.
    18. Click Bind.
    19. Click Close to close the dialog box, then click Save to save configuration of the new system user.

Figure Saving the configuration of the new system user for NetScaler monitoring

localized image

Important: Steps 20 to 22 apply only in case of the LDAP authentication.

    20. Run the following command to create necessary authentication policy and perform global binding (the assumption is that the policy is named Policy_LDAP):

command Copy

bind system global Policy_LDAP -priority 100

    21. Run the following command to create a user group with the same name as the user group in your Active Directory (as an example, if the Active Directory user account for NetScaler monitoring belongs to the NetScalerActiveDirectoryUserGroup group, add the system group NetScalerActiveDirectoryUserGroup to NetScaler. The group must therefore exist on both sides: in NetScaler and in Active Directory Users and Computers):

command Copy

add system group NetScalerActiveDirectoryUserGroup

    22. Run the following commands to bind the same command policies to the group as described for the NetScaler user account:

command Copy

bind system group NetScalerActiveDirectoryUserGroup -policy read-only 1

bind system group NetScalerActiveDirectoryUserGroup -policy polNetScalerMonitoring 1

Installing the product’s server-side part on the SCOM management server computer

The server-side part of Citrix SCOM Management Pack for NetScaler must be installed on the SCOM management server computer.

To install Citrix SCOM Management Pack for NetScaler on the SCOM management server computer, do the following:

  1. Log on to the management server computer. Use a user account that has local administrative privileges and SCOM administrative privileges.
  2. In Windows Explorer, locate the Citrix_SCOM_Management_Pack_for_NetScaler_<Version>.exe file (where <Version> is the current software version), and double-click it to invoke the installation process. Wait for the Setup Wizard to appear.
  3. In the Welcome page of the Setup Wizard, click Next.
  4. In the View Relevant Product Configuration page, click Next.
  5. In the License Agreement page of the Setup Wizard, carefully read the end user license agreement. If you accept the terms of the agreement, click Next.
  6. In the Destination Folder page, define the Citrix SCOM Management Pack for NetScaler installation folder. Citrix recommends that you install Citrix SCOM Management Pack for NetScaler to the default folder. Proceed as follows:
    • To install the product to the default folder listed in the Setup Wizard, no special actions are required.
    • To install the product to a different folder, follow the substeps:
      1. Click Change.
      2. In the Browse For Folder dialog box, browse to the desired installation folder, select it, and click OK.
  7. Click Next.
  8. In the Configure Post-Install Actions page of the Setup Wizard, decide whether the Setup Wizard should automatically import the included management packs into SCOM.
    • To let the Setup Wizard import the management packs, select the Automatically import the Management Pack option.
    • To import the management packs into SCOM manually at a later time, leave the Automatically import the Management Pack option unselected. For instructions on how to import or reimport the management packs, see Manually importing included management packs into SCOM.
  9. Click Install. The Setup Wizard displays the Installing the product page and starts copying the installation files.
  10. After the installation completes, the installation completion page appears.
    • If you let the Setup Wizard to automatically import the management packs, click Next. Else, click Finish to close the Setup Wizard, and skip the remaining steps of this procedure.
    • If you let the Setup Wizard to automatically import the management packs, it displays the Executing post-install actions page. Attend the import process.
  11. In the post-installation completion page, if you let the Setup Wizard to automatically import the management packs, review the management packs import log. Click Finish to close the Setup Wizard.

Configuring access to the shared folder for agent installation

Note: Steps of this procedure must be followed only once on a SCOM management server computer. In case you previously installed any Citrix SCOM Management Pack product (except Citrix SCOM Management Pack for License Server or Citrix SCOM Management Pack for XenServer) on the same computer, you do not need to repeat the steps. 

To configure access to the shared folder for agent installation, do the following:

  1. Log on to the SCOM management server computer. Use a user account that has local administrative privileges.
  2. Choose a local user account (local to the computer with the shared folder) or a domain user account that will have access to the shared folder, for the purpose of agent deployment and configuration.

    Important: Citrix recommends creating a new, dedicated user account that you will use only for deployment of the Citrix SCOM Management Pack for NetScaler Agent to SCOM resource pool members.

  3. Using an operating system administrative tool, add the user account to the local CitrixMPShareUsers user group.

Verifying the installation on the SCOM management server computer

To verify that the Citrix SCOM Management Pack for NetScaler installation on the SCOM management server computer is correct, do the following:

  1. Log on to the management server computer.
  2. Go to Start > Control Panel and click Programs and Features (actions of this step may differ on operating systems earlier than Windows Server 2016).
  3. Check for the presence of the following entry in the Name column:
    Citrix SCOM Management Pack for NetScaler
  4. To check if the CitrixMPShare shared folder is correctly configured, open a Command Prompt window and run the following commands in sequence (their outputs in case of success are also shown):
command Copy

net share | findstr -i CitrixMPShare

output Copy

CitrixMPShare

                   %ProgramData%\Citrix\CitrixMPShare

command Copy

net use \\<ManagementServerHostName>\CitrixMPShare

    /USER:<DomainName>\<UserName>

output Copy

The command completed successfully

command Copy

dir \\<ManagementServerHostName>\CitrixMPShare

output Copy

<FolderContents>

In these instances, %ProgramData% refers to the actual value of this operating system variable. <ManagementServerHostName> is the name of the SCOM management server computer. <DomainName> is the domain or computer name and <UserName> is the name of the user account that you chose in step 2 of the procedure documented in “Configuring access to the shared folder for agent installation”. <FolderContents> is the list of the contents of the CitrixMPShare folder.

Note: The shared folder is vital for installation of the Citrix SCOM Management Pack for NetScaler Agent and deployment of its configuration to the SCOM resource pool members.

Configuring SCOM agent to act as proxy on the SCOM resource pool members

On each member of the SCOM resource pool that is chosen for NetScaler monitoring, SCOM agent must be configured to act as a proxy agent. This configuration enables the agent to relay or forward information from or about other computes and network devices to the SCOM management server.

To configure the SCOM agent instances to act as proxy agents, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, expand Device Management, and then click Management Servers.
  3. For each management server computer, follow the steps:
    1. Right-click the host name, and select Properties.
    2. Click the Security tab.
    3. Select the Allow this agent to act as proxy and discover managed objects on other computers option.
    4. Click OK.

Installing Citrix SCOM Management Pack for NetScaler Agent on the SCOM resource pool members

On all members of the SCOM resource pool that is chosen for NetScaler monitoring, Citrix SCOM Management Pack for NetScaler Agent must be installed.

To find the members of a resource pool and install Citrix SCOM Management Pack for NetScaler Agent on them, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, expand Device Management > Network Management, and then click Network Devices.
  3. Identify discovered NetScaler network devices and the corresponding resource pool names.

Figure NetScaler network devices in the SCOM Operations console

localized image

    4. For the identified resource pool, find out its members.

localized image

    5. Log on to a member of the resource pool. Use a user account that has local administrative privileges.
    6. Copy the MPNSAgent.exe file from the \\<ManagementServeHostName>\CitrixMPShare\NetScaler MP shared folder to a location on the pool member.
    7. In Windows Explorer, locate the MPNSAgent.exe file, and double-click it to invoke the installation process.
    8. Follow instructions of the Setup Wizard.
    9. Repeat steps 5 to 8 for each additional resource pool member.

Verifying the installation on the SCOM resource pool members

To verify that the Citrix SCOM Management Pack for NetScaler Agent installation on a SCOM resource pool member is correct, do the following:

  1. Log on to the SCOM resource member computer.
  2. Go to Start > Control Panel and click Programs and Features (actions of this step may differ on operating systems earlier than Windows Server 2016).
  3. Check for the presence of the following entry in the Name column:

Citrix SCOM Management Pack Agent for NetScaler

       4. Go to Start > Administrative Tools and double-click Services.
       5. In the Name column of the Services window, locate the Citrix MPNS Agent service, and make sure that its status is to Started.

Tip: You can use Windows PowerShell to perform the verification. For example, to check if the program is correctly installed, run the following command:

command Copy

Get-WmiObject -Class Win32_product | ? {$_.Name -match "NetScaler" -and $_.Name -match "Agent"}

Manually importing included management packs into SCOM

For general instructions about how to import management packs into SCOM, see the How to Import an Operations Manager Management Pack webpage on the Microsoft TechNet website.

To import the sealed management packs for NetScaler, do the following:

  1. Log on to the management server computer.
  2. Launch the SCOM Operations console.
  3. In the Administration view, click Management Packs.
  4. In the Tasks pane, expand Actions, and then click Import Management Packs.
  5. In the Import Management Packs dialog box, click Add, and then select Add from disk.
  6. In the Online Catalog Connection dialog box, click No.
  7. In the Select Management Packs to import dialog box, browse to the %ProgramFiles%\Citrix\NetScaler MP folder, select the following management pack files, and then click Open.
  • Comtrade.Citrix.Library.mp
  • Comtrade.Citrix.NetScaler.Appliance.9.Discovery.mp
  • Comtrade.Citrix.NetScaler.Appliance.9.Library.mp
  • Comtrade.Citrix.NetScaler.Appliance.10.Discovery.mp
  • Comtrade.Citrix.NetScaler.Appliance.10.Library.mp
  • Comtrade.Citrix.NetScaler.Appliance.10.Monitoring.mp
  • Comtrade.Citrix.NetScaler.Device.mp
  • Comtrade.Citrix.NetScaler.Library.mp
  • Comtrade.Citrix.NetScaler.Modules.mpb
  • Comtrade.Citrix.NetScaler.Monitoring.mp

      8. Click Install.

Verifying the import of the included management packs

To verify that the import of the sealed management packs included in Citrix SCOM Management Pack for NetScaler 
was successful, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Monitoring view, expand the items in the left pane until they match the following figure.

Elements of Citrix SCOM Management Pack for NetScaler, as seen in the SCOM Operations console (part 1)

localized image

Elements of Citrix SCOM Management Pack for NetScaler, as seen in the SCOM Operations console (part 2)

localized image

    3. In the Administration view, expand Administration > Management Packs and click Installed Management Packs (the navigation pane structure may differ in SCOM versions earlier than 2016).
    4. Verify the following management pack versions are listed in the results pane:

Citrix Management Pack Library

1.0.32.0

Citrix NetScaler Appliance (v10.x and later) Component Library

1.17.87.0

Citrix NetScaler Appliance (v10.x and later) Discovery Library

1.17.87.0

Citrix NetScaler Appliance (v10.x and later) Monitoring Library

1.17.87.0

Citrix NetScaler Appliance (v9.x)  Discovery Library

1.17.87.0

Citrix NetScaler Appliance (v9.x) Component Library

1.17.87.0

Citrix NetScaler Appliance Component Library

1.17.87.0

Citrix NetScaler Device Discovery Library

1.17.87.0

Citrix NetScaler Module Library

1.17.87.0

Citrix NetScaler Monitoring Library

1.17.87.0

Configuring the NetScaler Appliance action account in SCOM

To configure Run As account in SCOM, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, in the left pane, expand Run As Configuration, and then click Accounts.
  3. In the Tasks pane, expand Actions, and then click Create Run As Account.
  4. In the Create Run As Account Wizard window, click Next.
  5. In the General Properties page, from the Run As account type drop-down list, select Basic Authentication, Simple Authentication, or Windows. If you are using LDAP, select Windows.
  6. In the Display name text box, type a name that the SCOM Operations console will use to refer to the newly created SCOM user account. Click Next.
  7. In the Credentials page, type credentials of the user account that you used in Configuring NetScaler for monitoring by Citrix SCOM Management Pack for NetScaler in the respective text boxes. Click Next.
  8. In the Distribution Security page, select a distribution security option. Citrix recommends that you select the More secure option.
  9. Click Create to save configuration data of the new account.
  10. Click Close to close the wizard.

To distribute the configured Run As account to NetScaler devices, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, in the left pane, expand Run As Configuration, and then click Profiles.
  3. In the results pane, in the Name column, double-click Citrix NetScaler Appliance Action Account.
  4. In the Run As Profile Wizard window, click Next twice.
  5. In the Run As Accounts page, click Add.
  6. In the Add a Run as Account dialog box, from the Run As account drop-down list, select the display name of the newly created Run As account.
  7. Select either the All targeted objects (less secure) or A selected class, group, or object (more secure) option. For general information on the distribution methods, see the Distribution and Targeting for Run As Accounts and Profiles webpage on the Microsoft TechNet website.
    Note: The remaining steps of this procedure apply to the more secure distribution method.
  8. Click Select and then select either Class, Group, or Object. The most appropriate choice depends on your NetScaler infrastructure.
    Note: The following few steps apply to the scenario when you select Object.
  9. In the Object Search dialog box, from the Look for drop-down list, select Node and then click Search.
  10. In the Available items list, select a NetScaler network device, and then click Add.
  11. Repeat step 10 for each additional NetScaler network device that you plan to monitor.
  12. Click OK to close the dialog box.
  13. Click OK to close the Add a Run As Account dialog box.
  14. Click Save to save the changes.
    Note: After saving the updated Run As profile, it may take some time for the updated configuration to become active on the targets. The required time depends on the state of the SCOM agent (HealthService) instances and overall load on the SCOM infrastructure.
  15. If you selected the More secure option in step 9 of the previous procedure, validate the Run As account distribution:
    1. Under More-secure Run As accounts, click the Run As account.
    2. In the Run As Account Properties dialog box, review the Selected computers list.
    3. Click OK to close the dialog box.
  16. Click Close to close the Run As Profile Wizard window.
  17. If you selected the More secure option in step 9 of the previous procedure, do the following:
    1. In the Administration view, in the left pane, expand Run As Configuration, and then click Accounts.
    2. In the results pane, in the Name column, double-click the Run As account.
    3. Click the Distribution tab.
    4. Click Add.
    5. Decide which of the following to distribute the Run As account to:
      • All members of the resource pool that is designated for NetScaler device monitoring
      • The designated resource pool itself

Citrix recommends that you choose the resource pool itself.

      f. In the Computer Search dialog box, from the Option drop-down list, select either Show management servers (for distribution to individual resource pool members) or Search by resource pool name (for distribution to the entire resource pool), and then click Search.
     g. Under Available items, select either all management servers of the designated resource pool (for distribution to individual resource pool members) or the resource pool itself (for distribution to the entire resource pool), and then click Add.
     h. Click OK to close the dialog box.
      i. Click OK to close the Run As Account Properties dialog box and save your changes.

For more information on Run As accounts and Run As profiles, see the Managing Run As Accounts and Profiles and How to Associate a Run As Account to a Run As Profile webpages on the Microsoft TechNet website.

Uninstall

This chapter contains instructions that you must follow to effectively uninstall Citrix SCOM Management Pack for NetScaler. Perform all procedures in the documented order of precedence.

Removing dependent management packs (customizations)

Important: Perform this procedure only if you have customized the management packs included in the product.

To remove the customizations that you made to the management packs included in NetScaler Management Pack, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, expand Administration > Management Packs and click Installed Management Packs (the navigation pane structure may differ in SCOM versions earlier than 2016).
  3. In the results pane, locate the management packs that depend on the management packs included in NetScaler Management Pack.
  4. For each such dependent management pack (except for Microsoft.SystemCenter.SecureReferenceOverride), follow the steps:
    1. Back up the management pack file.
    2. Right-click it and then click Delete.
    3. On the message stating that deleting the management pack might affect the scoping of some user roles, click Yes.

Removing included management packs

To remove the management packs included in Citrix SCOM Management Pack for NetScaler, do the following:

  1. Launch the SCOM Operations console and connect to the management server.
  2. In the Administration view, expand Administration > Management Packs and click Installed Management Packs (the navigation pane structure may differ in SCOM versions earlier than 2016).
  3. Remove references to the included management packs from the Microsoft.SystemCenter.SecureReferenceOverride management pack. To do this, perform the following steps:
    1. Identify which included management packs are referenced. In the Administration Management Packs context of the SCOM Operations console, right-click Microsoft.SystemCenter.SecureReferenceOverride and select Properties. In the dialog box, click the Dependencies tab.
    2. For each such referenced management pack, find out its ID. Right-click the referenced management pack. In the dialog box, take note of the value in the ID text box on the General tab.
    3. Export the Microsoft.SystemCenter.SecureReferenceOverride management pack.
    4. Make a copy of the file you exported the management pack to.
    5. Edit the originally exported file to remove all dependencies to the management packs from the Manifest References context (the Reference elements) and the Monitoring Overrides context (the SecureReferenceOverride elements), and then save the changes.
      Tip: For better tracking, increase the management pack version by adjusting the value of the Version element within the Identity element.
    6. Import back the altered Microsoft.SystemCenter.SecureReferenceOverride management pack from the modified file.

    4. In the SCOM Operations console, in the results pane, right-click Citrix NetScaler Appliance (v10.x and later) Monitoring Library.
    5. On the message stating that deleting the management pack might affect the scoping of some user roles, click Yes.
    6. Repeat steps 4 and 5 with the following management packs (in the presented order of precedence):

  • Citrix NetScaler Appliance (v10.x and later) Discovery Library
  • Citrix NetScaler Appliance (v10.x and later) Monitoring Library
  • Citrix NetScaler Appliance (v9.x) Discovery Library
  • Citrix NetScaler Appliance (v10.x and later) Component Library
  • Citrix NetScaler Appliance (v9.x) Component Library
  • Citrix NetScaler Monitoring Library
  • Citrix NetScaler Appliance Component Library
  • Citrix NetScaler Device Discovery Library
  • Citrix NetScaler Module Library

    7. Check if other Citrix SCOM Management Pack products are installed on the management server computer. If none of them is installed, repeat steps 4 and 5 with Citrix Management Pack Library.

Uninstalling the product from the SCOM resource pool members

To uninstall Citrix SCOM Management Pack for NetScaler Agent from a member of a resource pool, do the following:

  1. Log on to the member of the resource pool. Use a user account that has local administrative privileges.
  2. Make sure no product folders or files are in use by any user.
  3. Go to Start > Control Panel and click Programs and Features (actions of this step may differ on operating systems earlier than Windows Server 2016).
  4. Right-click Citrix SCOM Management Pack Agent for NetScaler and select Uninstall.
  5. In the Programs and Features dialog box, click Yes to confirm uninstallation.

Uninstalling the product from the SCOM management server computer

To uninstall Citrix SCOM Management Pack for NetScaler from the SCOM management server computer, do the following:

  1. Log on to the management server computer. Use a user account that has local administrative privileges and SCOM administrative privileges.
  2. Make sure no product folders or files are in use by any user.
  3. 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).
  4. Go to Start > Control Panel and click Programs and Features (actions of this step may differ on operating systems earlier than Windows Server 2016).
  5. Right-click Citrix SCOM Management Pack for NetScaler and select Uninstall. Wait for the Setup Wizard to appear.
  6. In the Welcome page of the Setup Wizard, click Uninstall.
  7. In the Uninstalling the product page, the Setup Wizard reports the uninstallation progress.
  8. In the Completion page of the Setup Wizard, click Finish.
  9. Delete the %ProgramData%\Citrix\CitrixMPShare\NetScaler MP folder.
    Caution: This action permanently deletes the Agent configuration data. You will be unable to reuse it at a later time.
  10. Check if other Citrix SCOM Management Pack products are installed on the management server computer. If none of them is installed, follow the steps:
    1. Stop sharing the CitrixMPShare shared folder.
    2. Delete the %ProgramData%\Citrix\CitrixMPShare folder.
    3. Using an operating system administrative tool, delete the local CitrixMPShareUsers user group.