Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section contains a brief walkthrough walk through for Solutions enabler deployment, for the purpose of monitoring by SQL Workload Analysis. for the full procedure and options of Solutions
Enabler deployment, see also the Solutions enabler Installation Guide document, which can be found in the document set on the EMC web site.

Info
titleNote

...

A user with the administrator role is needed to complete the following procedure.

On the SQL

...

Workload Analysis server

...

  1. Install Solutions Enabler.

      ...

        1. Select the destination folder.

      ...

        1. Select the Setup Type (use: Complete)

      ...

        1. On the Services List, leave the default settings for the Stordeamon Services.

      ...

        1. Click Next.

      ...

        1. Click Install.

      ...

      1. If your SQL Server instance stores its data on CLARiiON or VNX storage arrays, Statistics Logging should be enabled. The following procedure should be done per storage array:

          ...

            1. Open Navisphere GUI or Unisphere web GUI. Typically, this will require a user with Storage Administrator rights and the URL of the Navisphere software.

          ...

            1. Right-click on the APM storage System (or on CLARiiON unit ID in Unisphere GUI) and select Properties.
              Image Added

          ...

            1. On the General tab, select Statistics Logging.

          ...

            1. Click Apply.

          ...

            1. Click OK.

          ...

            1. Click File > Save and Exit.

          ...

          1. Initialize Solutions Enabler (building the symapi\db\symapi_db.bin file).

              ...

                1. Open a

              ...

                1. Windows command prompt.

              ...

                1. Navigate to the directory in which the EMC Solutions Enabler is installed.

              ...

                1. Execute: SYMCLI\BIN\symcfg.exe discover -all
                  The "No devices were found" message is expected and does not indicate an error.

              On each monitored server

              ...

              1. Install Solutions Enabler.

                  ...

                    1. Select the destination folder.

                  ...

                    1. Select he Setup Type (use: Complete)

                  ...

                    1. On the Service List, use the defaults and also check the SYMAPI daemon checkbox.

                  ...

                    1. Click Next.

                  ...

                    1. Click Install.

                  ...

                  1. If your SQL Server instance stores its data on CLARiiON or VNX storage arrays , the monitored server should be authorized using a SYMCLI command as follows:

                      ...

                        1. Make sure you have the array's Storage Processors (SP) hostname or IP address, and the array's administrator username and password.

                      ...

                        1. Open the command prompt.

                      ...

                        1. Navigate to the directory in which EMC Solutions Enabler is installed.
                        2. Execute: SYMCLI\BIN\symcfg.exe authorization add -host {VNX-SP} -username {VNX Administrator} -password {VNX Administrator Password}

                      ...

                      1. If your SQL Server instance stores its data on Symmetrix (DMX or VMAX) storage arrays, gatekeeper devices must be installed.

                          ...

                            1. Gatekeeper device is a small device (less than 3 MB) used by Solutions Enabler to improve the communication with the storage array. The assistance

                          ...

                            1. of a storage administrator is

                          ...

                            1. required.

                          ...

                            1. To verify which storage units and devices are attached to a monitored server, execute: SYMCLI\BIN\syminq.exe
                              The following table shows an example of the command's output.

                              DeviceProductDevice
                              NameTypeVendorIDRevSer NumCap (KB)
                              \\.\PHYSICALDRIVE0 SEAGATEST15150WHP12029942394194157
                              \\.

                          ...

                            1. \PHYSICALDRIVE1 EMCSYMMETRIX5265930523614224000
                              \\.\PHYSICALDRIVE2 EMCSYMMETRIX5265930524614224000
                              \\.\PHYSICALDRIVE3 EMCSYMMETRIX5265930525614224000
                              \\.\PHYSICALDRIVE4GKEMCSYMMETRIX5265930501612880
                              \\.\PHYSICALDRIVE5GKEMCSYMMETRIX5265930511612880
                            2. Gatekeeper devices are marked with GK in the

                          ...

                            1. Type column.

                          ...

                            1. The two most left digits (93 in this example) are the suffix of unit ID.

                          ...

                            1. If gatekeeper devices are missing, ask the storage administrator to define them. To verify, execute SYMCLI\BIN\syminq.exe and check its output once again.

                          ...

                          1. If the monitored SQL Server instance runs on a VMware guest server, the monitored server should be authorized using a SYMCLI command as follows:

                              ...

                                1. Make sure you have the ESX server hostname or IP address, and the ESX server's administrator username and password.

                              ...

                                1. Open a command prompt.

                              ...

                                1. Navigate to the directory in which EMC Solutions Enabler is installed.

                              ...

                                1. Execute: SYMCLI\BIN\symcfg.exe authorization add -host {ESX server} -username {ESX server Administrator} -password {ESX server Administrator Password} -vmware

                              ...

                              1. If the monitored SQL Server instance runs on a Microsoft Hyper-V guest server, the monitored server should be authorized using a SYMCLI command as follows:

                              ...

                              1. Info
                                titleNote

                                Only pass-through devices are supported. Devices configured as VHD are not supported.

                              ...

                                1. Make sure you have the Hyper-V hostname or IP address, and Hyper-V's administrator username and password.

                              ...

                                1. Open a command

                              ...

                                1. prompt.

                              ...

                                1. Navigate to the directory in which EMC Solutions Enabler is installed.

                              ...

                                1. Execute: SYMCLI\BIN\symcli.exe authorization add -host {Hyper-V hostname} -username {Hyper-V Administrator} -password {Hyper-V Administrator Password} -hyperv

                              ...

                              1. Initialize Solutions Enabler (building the symapi\db\symapi_db.bin file}.

                                  ...

                                    1. Open a Windows command prompt.

                                  ...

                                    1. Change to the directory in which the EMC Solutions Enabler is installed.

                                  ...

                                    1. Execute the discover command:
                                      SYMCLI\BIN\symcfg.exe discover -all
                                      This time, "No devices were found" message should be considered an error. If no devices were found, retry carefully steps 1 to 6. If still not found

                                  ...

                                    1. , open a support case using the

                                  ...

                                    1. Precise community portal.

                                  ...

                                    1. If your SQL Server instance stores its data on Symmetrix (DMX or VMAX) storage arrays, execute SYMCLI\BIN\symcfg.exe list
                                      Its output

                                  ...

                                    1. should list all attached Symmetrix storage units. Each of the units that are actually used to store SQL Server DB files should be marked as local in the

                                  ...

                                    1. Attachment column.

                                  ...

                                    1. See example:

                                  ...

                                    1. SymmetrixAttachmentModelVersion
                                      000190103692RemoteDMX3-245773
                                      000190765393LocalVMAX-15875
                                    2. If your SQL Server

                                  ...

                                    1. instance stores its data on VNX or CLARiiON storage arrays, execute SYMCLI\BIN\symcfg.exe list -clariion
                                      Its output should list all attached VNX and CLARiiON storage units.

                                  Verifying Solutions Enabler's Deployment and Configuration

                                  The last verification step should be done on each monitored serer. It should be verified regardless of the storage array series (SYMMETRIX or CLARiiON).

                                  To manually verify that Solutions Enabler was successfully deployed and configured:1.

                                  1. Select a database file

                                  ...

                                  1. that is stored on an EMC sorage array (file size must be > 0).

                                  ...

                                  1. Open a Windows command prompt.

                                  ...

                                  1. Navigate to the directory in which the EMC Solutions Enabler is installed.

                                  ...

                                  1. Execute: SYMCLI\BIN\symrslv.exe file <full path and name of the selected DB file>

                                  ...

                                  1. The output should contain a table with the following column titles:
                                    Size, Array, Dev, Offset, PPdevName, Offset, and Attr.
                                    Array and Dev should present EMC unit and EMC device. If "N/A" is presented instead, then EMC Solutions Enabler failed to map the file. In this case, open a support case using the

                                  ...

                                  1. Precise community portal.

                                  ...

                                   

                                  SQL Workload Analysis makes SQL Server performance tuning easy.

                                   

                                  Need more help? Search the Idera Customer Support Portal.