Agents Administration - Tests
 

Default Parameters for WemSrvSqlNetTest

This test monitors the availability and response time of the WEM database server from an external agent perspective.

This page depicts the default parameters that need to be configured for the WemSrvSqlNetTest test.

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • By default, the DATABASE IP is set to none indicating that the Microsoft SQL server connected to the target Citrix WEM Broker and the Citrix WEM Broker are installed on the same host. However, if the Microsdot SQL Server is installed on a different host, then specify the IP address of the Microsoft SQL server connected to the target Citrix WEM Broker in the DATABASE IP text box.

  • Specify the DATABASE PORT number through which the Microsoft SQL server communicates with the target Citrix WEM Broker. By default, 1433 is displayed here.

  • In the INSTANCE text box, enter the name of a specific Microsoft SQL instance that is to be monitored. The default value of this parameter is “default”. To monitor a Microsoft SQL instance named “CFS”, enter this as the value of the Instance parameter.

  • By default, the target Citrix WEM Broker needs to be configured with the Microsoft SQL server 2008 and above. Therefore, while monitoring the Microsoft SQL server 2008, provide the name of a SQL USER with the CONNECT SQL, VIEW ANY DATABASE, and VIEW SERVER STATE roles.

  • Specify the password of the above-mentioned USER in the PASSWORD text box.

  • Confirm the PASSWORD by retyping it in the CONFIRM PASSWORD text box.

  • If the target Citrix WEM Broker being monitored is an SSL-enabled server, then set the SSL flag to Yes. If not, then set the SSL flag to No.

  • By default, none is displayed in the DOMAIN text box. If the ‘SQL server and Windows’ authentication has been enabled for the server being monitored, then the Domain can continue to be none. On the other hand, if ‘Windows only’ authentication has been enabled, then, in the DOMAIN text box, specify the Windows domain in which the managed Microsoft SQL server exists. Also, in such a case, the USERNAME and PASSWORD that you provide should be that of a user authorized to access the monitored SQL server.

  • In some Windows networks, NTLM (NT LAN Manager) may be enabled. NTLM is a suite of Microsoft security protocols that provides authentication, integrity, and confidentiality to users. NTLM version2 ("NTLMv2") was concocted to address the security issues present in NTLM. By default, the ISNTLMV2 flag is set to No, indicating that NTLMv2 is not enabled by default on the target Microsoft SQL host. Set this flag to Yes if NTLMv2 is enabled on the target host.

  • Specify the name of the database to connect to in the DATABASE text box. The default is “CitrixWem”. To monitor multiple databases, ensure that the database names are provided as a colon-separated list. Alternatively, you can use the semi-colon as the separator for the database names.

  • Specify the select QUERY to execute. The default is “SELECT * FROM master.dbo.spt_monitor”. If the target Microsoft SQL database server is installed as case sensitive, then the value of query parameter must be case sensitive. If multiple databases are specified in the DATABASE text box, then you will have to provide multiple queries here separated by a semi-colon(;) - for eg.,SELECT * FROM master.dbo.spt_monitor; select * from alarm. Every Database being monitored, should have a corresponding Query specification.

  • If the value chosen for IS PASSIVE is Yes, then the MS SQL server under consideration is a passive server in a SQL cluster. No alerts will be generated if the server is not running. Measures will be reported as “Not applicable” by the agent if the server is not up.

  • Once the above values are provided, click on the UPDATE button to register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz*” and $port will be changed to “80” when configuring a test.