This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
OnCommandreg Report 11Installation and Administration Guide
NetApp Inc495 East Java DriveSunnyvale CA 94089 USATelephone +1 (408) 822-6000Fax +1 (408) 822-4501Support telephone +1 (888) 4-NETAPPDocumentation comments doccommentsnetappcomInformation Web wwwnetappcom
Part number 215-06768_A0September 2012
Contents
Understanding OnCommand Report 6OnCommand Report features 6
What you can do with OnCommand Report 6
Questions you can answer with OnCommand Report 7
OnCommand Report architecture 7
Where to find more information about OnCommand Report 8
Videos for OnCommand Report 9
OnCommand Report on the web 9
OnCommand Report documentation 9
Planning your OnCommand Report deployment 10Installation requirements for OnCommand Report 10
Web browser requirements 12
Data ONTAP versions that OnCommand Report supports 12
DataFabric Manager server requirements 13
Information you need about DataFabric Manager servers 15
Deploying OnCommand Report 16Downloading the OnCommand Report installer 16
Installing OnCommand Report 16
List of ports used by OnCommand Report 17
Configure Server panel 18
Installing OnCommand Report on Windows Server 2008 19
Completing OnCommand Report upgrade tasks 20
Preparing to migrate report schedule 20
Upgrading OnCommand Report 21
Migrating report schedules 22
Uninstalling OnCommand Report 23
Configuring OnCommand Report 24Logging in to the OnCommand Report Administration Console 24
Getting started with OnCommand Report 25
Obtaining your license key 26
Validating your license key 26
License Configuration dialog box 27
Table of Contents | 3
Configuring data acquisition from your DataFabric Manager servers 27
Adding information about your DataFabric Manager servers 27
Editing information about your DataFabric Manager servers 30
Deleting information about your DataFabric Manager servers 31
Testing connections to DataFabric Manager servers 31
Setting the data acquisition schedule for DataFabric Manager servers 32
Initiating data acquisition from DataFabric Manager servers 32
Updating reports with acquired data 33
Monitoring reporting data status with the ETL option 33
User accounts in OnCommand Report 34
Adding user accounts 35
Manage Users dialog box 36
Editing user accounts 38
Changing passwords for user accounts 38
Deleting user accounts 39
Creating DataFabric Manager server users 39
Enabling and configuring LDAP 40
Auditing user activity 41
Configuring AutoSupport for troubleshooting help 41
AutoSupport Configuration dialog box 42
Configuring OnCommand Report to send emails 43
Backing up the OnCommand Report database 43
Restoring the database 44
Exporting custom reports 44
Importing custom reports 45
Reconfiguring OnCommand Report 46
Monitoring the status of data acquisition 47DataFabric Manager servers view 47
Troubleshooting OnCommand Report 50Troubleshooting data acquisition 50
Restarting the OnCommand Report server 53
Sending AutoSupport information to technical support 54
Troubleshooting view 54
Logs view 55
Copyright information 56Trademark information 57
4 | OnCommandreg Report 11 Installation and Administration Guide
How to send your comments 58Index 59
Table of Contents | 5
Understanding OnCommand Report
OnCommand Report provides comprehensive reporting of your NetApp storage infrastructure Youcan consolidate data from your DataFabric Manager servers and then view predesigned reports andcreate your own custom reports These reports can help you optimize your storage and improvecapacity planning
OnCommand Report featuresOnCommand Report provides visibility to NetApp storage resources in the data center WithOnCommand Report administrators can consolidate data from multiple DataFabric Manager servers
OnCommand Report performs the following actions
bull Identifies your NetApp storage environmentbull Displays inventory and capacity information such as growth capacity utilization overcommitted
capacity deduplication effects and space reservationbull Provides information about controllers status of controllers (for example active-active status)
and resource groupsbull Enables the consolidation of data from multiple DataFabric Manager serversbull Enables you to create and customize reportsbull Enables you to group data in reports by using constructs supported by the DataFabric Manager
server for example resource groups
OnCommand Report operates as agent-less software that runs on Microsoft Windows
What you can do with OnCommand ReportStorage administrators and managers use OnCommand Report to gain insight into storage resourcesin their environment assess the impact of growth and capacity utilization statistics and improveresource utilization
OnCommand Report enables storage administrators to accomplish the following tasks
bull Gain global visibility into storage network assets such as aggregates vFiler units disks volumesand controllers to understand their availability relationship and usage at a resource group or anenterprise level
bull Improve capacity planning by identifying free and used capacitybull Make correct storage-related decisions based on accurate reports
6 | OnCommandreg Report 11 Installation and Administration Guide
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Contents
Understanding OnCommand Report 6OnCommand Report features 6
What you can do with OnCommand Report 6
Questions you can answer with OnCommand Report 7
OnCommand Report architecture 7
Where to find more information about OnCommand Report 8
Videos for OnCommand Report 9
OnCommand Report on the web 9
OnCommand Report documentation 9
Planning your OnCommand Report deployment 10Installation requirements for OnCommand Report 10
Web browser requirements 12
Data ONTAP versions that OnCommand Report supports 12
DataFabric Manager server requirements 13
Information you need about DataFabric Manager servers 15
Deploying OnCommand Report 16Downloading the OnCommand Report installer 16
Installing OnCommand Report 16
List of ports used by OnCommand Report 17
Configure Server panel 18
Installing OnCommand Report on Windows Server 2008 19
Completing OnCommand Report upgrade tasks 20
Preparing to migrate report schedule 20
Upgrading OnCommand Report 21
Migrating report schedules 22
Uninstalling OnCommand Report 23
Configuring OnCommand Report 24Logging in to the OnCommand Report Administration Console 24
Getting started with OnCommand Report 25
Obtaining your license key 26
Validating your license key 26
License Configuration dialog box 27
Table of Contents | 3
Configuring data acquisition from your DataFabric Manager servers 27
Adding information about your DataFabric Manager servers 27
Editing information about your DataFabric Manager servers 30
Deleting information about your DataFabric Manager servers 31
Testing connections to DataFabric Manager servers 31
Setting the data acquisition schedule for DataFabric Manager servers 32
Initiating data acquisition from DataFabric Manager servers 32
Updating reports with acquired data 33
Monitoring reporting data status with the ETL option 33
User accounts in OnCommand Report 34
Adding user accounts 35
Manage Users dialog box 36
Editing user accounts 38
Changing passwords for user accounts 38
Deleting user accounts 39
Creating DataFabric Manager server users 39
Enabling and configuring LDAP 40
Auditing user activity 41
Configuring AutoSupport for troubleshooting help 41
AutoSupport Configuration dialog box 42
Configuring OnCommand Report to send emails 43
Backing up the OnCommand Report database 43
Restoring the database 44
Exporting custom reports 44
Importing custom reports 45
Reconfiguring OnCommand Report 46
Monitoring the status of data acquisition 47DataFabric Manager servers view 47
Troubleshooting OnCommand Report 50Troubleshooting data acquisition 50
Restarting the OnCommand Report server 53
Sending AutoSupport information to technical support 54
Troubleshooting view 54
Logs view 55
Copyright information 56Trademark information 57
4 | OnCommandreg Report 11 Installation and Administration Guide
How to send your comments 58Index 59
Table of Contents | 5
Understanding OnCommand Report
OnCommand Report provides comprehensive reporting of your NetApp storage infrastructure Youcan consolidate data from your DataFabric Manager servers and then view predesigned reports andcreate your own custom reports These reports can help you optimize your storage and improvecapacity planning
OnCommand Report featuresOnCommand Report provides visibility to NetApp storage resources in the data center WithOnCommand Report administrators can consolidate data from multiple DataFabric Manager servers
OnCommand Report performs the following actions
bull Identifies your NetApp storage environmentbull Displays inventory and capacity information such as growth capacity utilization overcommitted
capacity deduplication effects and space reservationbull Provides information about controllers status of controllers (for example active-active status)
and resource groupsbull Enables the consolidation of data from multiple DataFabric Manager serversbull Enables you to create and customize reportsbull Enables you to group data in reports by using constructs supported by the DataFabric Manager
server for example resource groups
OnCommand Report operates as agent-less software that runs on Microsoft Windows
What you can do with OnCommand ReportStorage administrators and managers use OnCommand Report to gain insight into storage resourcesin their environment assess the impact of growth and capacity utilization statistics and improveresource utilization
OnCommand Report enables storage administrators to accomplish the following tasks
bull Gain global visibility into storage network assets such as aggregates vFiler units disks volumesand controllers to understand their availability relationship and usage at a resource group or anenterprise level
bull Improve capacity planning by identifying free and used capacitybull Make correct storage-related decisions based on accurate reports
6 | OnCommandreg Report 11 Installation and Administration Guide
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Configuring data acquisition from your DataFabric Manager servers 27
Adding information about your DataFabric Manager servers 27
Editing information about your DataFabric Manager servers 30
Deleting information about your DataFabric Manager servers 31
Testing connections to DataFabric Manager servers 31
Setting the data acquisition schedule for DataFabric Manager servers 32
Initiating data acquisition from DataFabric Manager servers 32
Updating reports with acquired data 33
Monitoring reporting data status with the ETL option 33
User accounts in OnCommand Report 34
Adding user accounts 35
Manage Users dialog box 36
Editing user accounts 38
Changing passwords for user accounts 38
Deleting user accounts 39
Creating DataFabric Manager server users 39
Enabling and configuring LDAP 40
Auditing user activity 41
Configuring AutoSupport for troubleshooting help 41
AutoSupport Configuration dialog box 42
Configuring OnCommand Report to send emails 43
Backing up the OnCommand Report database 43
Restoring the database 44
Exporting custom reports 44
Importing custom reports 45
Reconfiguring OnCommand Report 46
Monitoring the status of data acquisition 47DataFabric Manager servers view 47
Troubleshooting OnCommand Report 50Troubleshooting data acquisition 50
Restarting the OnCommand Report server 53
Sending AutoSupport information to technical support 54
Troubleshooting view 54
Logs view 55
Copyright information 56Trademark information 57
4 | OnCommandreg Report 11 Installation and Administration Guide
How to send your comments 58Index 59
Table of Contents | 5
Understanding OnCommand Report
OnCommand Report provides comprehensive reporting of your NetApp storage infrastructure Youcan consolidate data from your DataFabric Manager servers and then view predesigned reports andcreate your own custom reports These reports can help you optimize your storage and improvecapacity planning
OnCommand Report featuresOnCommand Report provides visibility to NetApp storage resources in the data center WithOnCommand Report administrators can consolidate data from multiple DataFabric Manager servers
OnCommand Report performs the following actions
bull Identifies your NetApp storage environmentbull Displays inventory and capacity information such as growth capacity utilization overcommitted
capacity deduplication effects and space reservationbull Provides information about controllers status of controllers (for example active-active status)
and resource groupsbull Enables the consolidation of data from multiple DataFabric Manager serversbull Enables you to create and customize reportsbull Enables you to group data in reports by using constructs supported by the DataFabric Manager
server for example resource groups
OnCommand Report operates as agent-less software that runs on Microsoft Windows
What you can do with OnCommand ReportStorage administrators and managers use OnCommand Report to gain insight into storage resourcesin their environment assess the impact of growth and capacity utilization statistics and improveresource utilization
OnCommand Report enables storage administrators to accomplish the following tasks
bull Gain global visibility into storage network assets such as aggregates vFiler units disks volumesand controllers to understand their availability relationship and usage at a resource group or anenterprise level
bull Improve capacity planning by identifying free and used capacitybull Make correct storage-related decisions based on accurate reports
6 | OnCommandreg Report 11 Installation and Administration Guide
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
How to send your comments 58Index 59
Table of Contents | 5
Understanding OnCommand Report
OnCommand Report provides comprehensive reporting of your NetApp storage infrastructure Youcan consolidate data from your DataFabric Manager servers and then view predesigned reports andcreate your own custom reports These reports can help you optimize your storage and improvecapacity planning
OnCommand Report featuresOnCommand Report provides visibility to NetApp storage resources in the data center WithOnCommand Report administrators can consolidate data from multiple DataFabric Manager servers
OnCommand Report performs the following actions
bull Identifies your NetApp storage environmentbull Displays inventory and capacity information such as growth capacity utilization overcommitted
capacity deduplication effects and space reservationbull Provides information about controllers status of controllers (for example active-active status)
and resource groupsbull Enables the consolidation of data from multiple DataFabric Manager serversbull Enables you to create and customize reportsbull Enables you to group data in reports by using constructs supported by the DataFabric Manager
server for example resource groups
OnCommand Report operates as agent-less software that runs on Microsoft Windows
What you can do with OnCommand ReportStorage administrators and managers use OnCommand Report to gain insight into storage resourcesin their environment assess the impact of growth and capacity utilization statistics and improveresource utilization
OnCommand Report enables storage administrators to accomplish the following tasks
bull Gain global visibility into storage network assets such as aggregates vFiler units disks volumesand controllers to understand their availability relationship and usage at a resource group or anenterprise level
bull Improve capacity planning by identifying free and used capacitybull Make correct storage-related decisions based on accurate reports
6 | OnCommandreg Report 11 Installation and Administration Guide
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Understanding OnCommand Report
OnCommand Report provides comprehensive reporting of your NetApp storage infrastructure Youcan consolidate data from your DataFabric Manager servers and then view predesigned reports andcreate your own custom reports These reports can help you optimize your storage and improvecapacity planning
OnCommand Report featuresOnCommand Report provides visibility to NetApp storage resources in the data center WithOnCommand Report administrators can consolidate data from multiple DataFabric Manager servers
OnCommand Report performs the following actions
bull Identifies your NetApp storage environmentbull Displays inventory and capacity information such as growth capacity utilization overcommitted
capacity deduplication effects and space reservationbull Provides information about controllers status of controllers (for example active-active status)
and resource groupsbull Enables the consolidation of data from multiple DataFabric Manager serversbull Enables you to create and customize reportsbull Enables you to group data in reports by using constructs supported by the DataFabric Manager
server for example resource groups
OnCommand Report operates as agent-less software that runs on Microsoft Windows
What you can do with OnCommand ReportStorage administrators and managers use OnCommand Report to gain insight into storage resourcesin their environment assess the impact of growth and capacity utilization statistics and improveresource utilization
OnCommand Report enables storage administrators to accomplish the following tasks
bull Gain global visibility into storage network assets such as aggregates vFiler units disks volumesand controllers to understand their availability relationship and usage at a resource group or anenterprise level
bull Improve capacity planning by identifying free and used capacitybull Make correct storage-related decisions based on accurate reports
6 | OnCommandreg Report 11 Installation and Administration Guide
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Questions you can answer with OnCommand ReportAdministrators can use OnCommand Report to answer many questions that can help them understandtheir storage environment better
The following are examples of the types of questions that you can answer by using OnCommandReport
bull How much storage do we have what are the attributes of these storage objects and what is theirstatus
bull How much purchased storage are we actually usingbull Where are the wasted or unused licenses that we can recoverbull What CIFS shares and NFS exports do we havebull What is the distribution of assets in our environment
OnCommand Report architectureOnCommand Report acquires and consolidates data from multiple DataFabric Manager servers Thedata from these servers includes inventory information about your NetApp storage You can manageand view the data by using the Administration Console and the Reporting Connection
The following illustration shows the OnCommand Report architecture
OnCommand Report comprises the following main components
OnCommandReport server
The OnCommand Report server obtains data from DataFabric Manager serversand provides access to the Administration Console and the ReportingConnection The server can obtain data from multiple DataFabric Managerservers at the same time
Understanding OnCommand Report | 7
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
To obtain data from DataFabric Manager servers OnCommand Reportperforms the following actions
bull Remotely accesses and acquires data from the DataFabric Manager serverdatabases by accessing read-only views
bull Consolidates the data in the OnCommand Report databasebull Extracts transforms and loads the data into the data warehouse three hours
from the start of acquiring the data from the DataFabric Manager serversFor example if data acquisition starts at 300 pm then ETL starts at 600pm
The data warehouse is a repository that the reporting engine uses to accessdata After the data is in the data warehouse it is available for use in reports
AdministrationConsole
The Administration Console is a web-based interface that helps you performthe following tasks
bull Validating your licensebull Configuring data acquisition from DataFabric Manager serversbull Troubleshooting data acquisitionbull Monitoring the status of data acquisitionbull Configuring user accountsbull Configuring AutoSupport for troubleshooting helpbull Backing up and restoring the database
ReportingConnection
The Reporting Connection is a web-based interface that helps you perform thefollowing tasks
bull Viewing predesigned reports and create your own custom reports by usingQuery Studio
bull Scheduling reports for email distributionbull Making backup of custom reportsbull Restoring custom reports
Where to find more information about OnCommand ReportFind more information about OnCommand Report on the NetApp web site and in other OnCommandReport documentation
8 | OnCommandreg Report 11 Installation and Administration Guide
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Videos for OnCommand ReportYou can access how-to videos that show you how to perform some actions in OnCommand ReportThe videos are located on the OnCommand Report Customer Community a private forum forcustomers
Access the following videos on the Customer Community using this link OnCommand Reportvideos
Note You need a user name and password for this community To obtain them click the Becomea Member link
Lists the prerequisites needed to install OnCommand Report Explainshow to configure licenses and DataFabric Manager servers andprovides troubleshooting information
OnCommand Report UserGuide
Provides an overview of the OnCommand Report product describeshow to use the many predesigned reports and explains how to createyour own report using the Query Studio report authoring tool
Understanding OnCommand Report | 9
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Planning your OnCommand Report deployment
You need to perform several steps before you can install OnCommand Report
Planning your deployment involves the following steps
bull Reviewing installation prerequisitesbull Reviewing Web browser requirementsbull Reviewing the storage systems that OnCommand Report supportsbull Reviewing DataFabric Manager server requirementsbull Gathering information about your DataFabric Manager servers
Installation requirements for OnCommand ReportBefore you install OnCommand Report you must ensure that the host meets the installationprerequisites
Component Requirement
Operatingsystem
One of the following operating systems
bull Windows Server 2003 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 Enterprise Edition or Standard Edition (64-bit)bull Windows Server 2008 R2 Enterprise Edition or Standard Edition (64-bit)
These operating systems are supported on a physical machine or a virtual machineYou must run the virtual machine on VMware ESX server version 40 or higher
CPU bull For 300 storage systems 24 GHz Dual core Pentium processors or equivalentbull For 300 to 600 storage systems 24 GHz Quad Core Pentium processors or
equivalent
Memory bull For 300 storage systems 8 GBbull For 300 to 600 storage systems 16 GB
10 | OnCommandreg Report 11 Installation and Administration Guide
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Component Requirement
Disk space 14 GB
Note If OnCommand Report is installed on a drive other than where theoperating system is installed then OnCommand Report requires 4 GB disk spacein the system drive (where the operating system is installed) and 10 GB space inthe other drive (where OnCommand Report is installed)
For example if C drive is the system drive and you install OnCommand Reportin D drive then C drive must have a minimum of 4 GB space available and Ddrive must have a minimum of 10 GB space available
Software You must not install OnCommand Report on a host that runs any of the following
bull DataFabric Manager serverbull OnCommand Insight (previously known as SANscreen)
Network bull A network connection to the hosts where your DataFabric Manager servers areinstalled
bull Access to the following ports
bull 80bull 443bull 3306bull 8080bull 9300
Note You can change these ports by choosing a custom installation Youmust ensure that these ports are not used by any other applications in thesystem For more information about the ports see List of ports used byOnCommand Report
Permissions A user account with administrator-level privileges to install OnCommand Report
Remoteconnectivity
Internet connectivity to allow WebEx access or a remote desktop connection tofacilitate installation and post-installation support
Accessibility HTTP or FTP access to the internet
Virus scan You must disable antivirus scans before you install OnCommand Report You mustreenable the scans after the installation is complete
For the latest information about OnCommand Report installation requirements see theInteroperability Matrix Tool
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Data ONTAP versions that OnCommand Report supportsYou can use OnCommand Report to view and create reports that include data from specific storagesystems
OnCommand Report can report on NetApp storage systems that use the following versions
bull Data ONTAP 7xbull Data ONTAP 8x (7-Mode only)
For the latest information about currently supported Data ONTAP versions see the InteroperabilityMatrix Tool
12 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
DataFabric Manager server requirementsOnCommand Report can acquire data from DataFabric Manager servers that meet specificrequirements
Requirement Description
Supportedversion
OnCommand Report supports DataFabric Manager server 40 401 50 501502
Number ofstorage systems
You can configure OnCommand Report to collect data from any number ofDataFabric Manager servers It is best if you configure OnCommand Report tocollect data for no more than 600 storage systems
Note To identify the number of storage systems for which OnCommandReport currently has data you can view the Storage Systems detail report oryou can add the Storage Count data element to a report For informationabout reports see the OnCommand Report User Guide
Database useraccount
You must ensure that each DataFabric Manager server has a database useraccount that is enabled for database access OnCommand Report uses thisaccount to access read-only views from the DataFabric Manager serverdatabase For information about how to manage database user accounts see theOnCommand Unified Manager Operations Manager Administration Guide
Planning your OnCommand Report deployment | 13
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Requirement Description
Enabled databaseviews
OnCommand Report requires access to the following read-only views in theDataFabric Manager server database These views are enabled by default If youhave disabled the views you need to reenable them For information about howto manage database views see the OnCommand Unified Manager OperationsManager Administration Guide
The following are the read-only views in the DataFabric Manager serverdatabase
14 | OnCommandreg Report 11 Installation and Administration Guide
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Information you need about DataFabric Manager serversAfter you install OnCommand Report you must configure it to acquire data from your DataFabricManager servers You must gather this information about each of your DataFabric Manager serversso that you can enter it during initial product configuration
To acquire data from your DataFabric Manager servers OnCommand Report requires the followinginformation about each server
bull IP address or a fully qualified domain namebull Port for the DataFabric Manager servers database (the default port is 2638)bull User name and password for the database accountbull Version
Planning your OnCommand Report deployment | 15
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Deploying OnCommand Report
To deploy OnCommand Report you need to download the product installer and then run theinstallation wizard After the installation is complete you can get the product up and running
About this task
You must have administrator-level access privileges to download and install this product Otherwisean error message is displayed
Downloading the OnCommand Report installerDownload the OnCommand Report installer from the NetApp Support Site
Before you begin
You must have a login to the NetApp Support Site at supportnetappcom
Steps
1 Log in to the host where you want to install OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
After you finish
Install OnCommand Report
Installing OnCommand ReportYou must run the installation wizard to install OnCommand Report You must use this procedurewhen installing OnCommand Report on a system other than Windows Server 2008
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
16 | OnCommandreg Report 11 Installation and Administration Guide
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Navigate to the directory where you downloaded the installation file
3 Run OnCommand Report-arch-version-buildmsi
4 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Related concepts
Configuring data acquisition from your DataFabric Manager servers on page 27
User accounts in OnCommand Report on page 34
Related tasks
Getting started with OnCommand Report on page 25
Logging in to the OnCommand Report Administration Console on page 24
Validating your license key on page 26
Related references
Configure Server panel on page 18
Installation requirements for OnCommand Report on page 10
List of ports used by OnCommand ReportOnCommand Report uses several ports and you must ensure that these ports are not used by anyother applications in the system
The following table provides a list of the default ports used by OnCommand Report
Port Number Can be modified
1090 No
1091 No
1098 No
1099 Yes
1527 No
4446 No
Deploying OnCommand Report | 17
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Port Number Can be modified
4712 No
4713 No
5445 No
5455 No
5500 No
5501 No
8009 No
8080 Yes
8083 No
9300 Yes
9334 No
9362 No
9399 No
Note For information about the ports that can be modified see Configure Server panel topic
Related tasks
Installing OnCommand Report on page 16
Related references
Configure Server panel on page 18
Configure Server panelYou can use the Configure Server panel to modify the ports that OnCommand Report uses Thispanel appears when you select a custom installation
You can modify the following ports
Portal Port (HTTP) Used to access the Administration Console through a Web browser by usingHTTP You use the Administration Console to configure OnCommandReport The default port is 80
Secured Portal Port(HTTPS)
Used to access the Administration Console through a Web browser by usingHTTPS The default port is 443
18 | OnCommandreg Report 11 Installation and Administration Guide
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Internal DatabasePort (SQL)
Used internally as an access point to the MySQL database that is installedwith OnCommand Report The default port is 3306
Reporting HTTPServer Port
Used to access the Reporting Connection through a Web browser You usethe Reporting Connection to view and create reports The default port is8080
Reporting EnginePort
Used to access the reporting engine that enables you to view and createreports The default port is 9300
Related tasks
Installing OnCommand Report on page 16
Installing OnCommand Report on Windows Server 2008You must run the installation wizard to install OnCommand Report on Windows Server 2008 andWindows Server 2008 R2
Before you begin
Installation prerequisites must be met
About this task
When you run the installation wizard you can select a typical installation or a custom installation Ifyou need to modify the default ports that OnCommand Report uses select the custom installationotherwise select the typical installation
Steps
1 Log in to the host where you want to install OnCommand Report as a user with administrator-level privileges
2 Open the Administrator command prompt
Note This is different from a normal command prompt
3 Navigate to the directory where you downloaded the installation file
4 Type the following file name
OnCommand Report-arch-version-buildmsi
5 Click Enter
6 Complete the steps in the installation wizard to install OnCommand Report
After you finish
Configure OnCommand Report
Deploying OnCommand Report | 19
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Completing OnCommand Report upgrade tasksTo complete the OnCommand Report upgrade you must manually back up the existing reportschedules upgrade to the next version of OnCommand Report and then manually restore theexisting report schedules You must do this because OnCommand Report does not automaticallyback up and restore report schedules during upgrade
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Preparing to migrate report scheduleOnCommand Report does not automatically back up report schedules during the upgrade You mustmanually back up the existing report schedules before upgrading OnCommand Report
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click Administer OnCommand Insight Report content
3 In the Administration page click the Status tab and then click Schedules in the left pane
4 In the left pane click Advanced options
5 From the Type list select Query and then click Apply
A list of existing report schedules is displayed in the right pane
6 In the report schedule you want to migrate click the drop-down list and then click Setproperties to view the location of the report
You must make a note of the report location that you want to manually migrate after the versionupgrade and click Ok
7 In the report schedule that you want to migrate click the drop-down list and then click Modifythe schedule
You must make a note of the schedule properties from the Schedules page such as FrequencyOptions Start time End time and Prompt values
8 Click Ok
Related concepts
Completing OnCommand Report upgrade tasks on page 20
20 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Related tasks
Migrating report schedules on page 22
Upgrading OnCommand Report on page 21
Upgrading OnCommand ReportTo upgrade OnCommand Report to the latest release you must fulfill several prerequisites anddownload and install the software
Before you begin
bull Installation prerequisites must have been met For more information about the prerequisites seeInstallation requirements for OnCommand Report
bull You must have administrator-level access privileges to install this productbull Ensure that you have completed the prerequisites for migrating report schedulesbull Ensure that you have saved the custom reports in OnCommand Report version packagebull Ensure that you have used Microsoft Windows files and folders naming conventions for your
custom report namesElse during the upgrade the custom reports will not be backed up
About this task
Note
1 You cannot back up custom reports saved in the My Folders and dashboard style customreports Also you cannot backup the report email scheduling configuration settings through theReporting Connection
2 If you make any changes to the predesigned reports then the changes will not be restored afterthe upgrade
Steps
1 Log in to the host where you want to install the new version of OnCommand Report
2 Download the installation file from the NetApp Support Site at supportnetappcom
3 Navigate to the directory where you downloaded the installation file and run
OnCommand Report-arch-version-buildmsi
4 Start the installation wizard and follow the prompts on the wizard to complete the installation
The Backup and Restore database option is enabled by default To change the backup locationclick Browse If you disable the Backup and Restore database option then you will lose yourdata
Deploying OnCommand Report | 21
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Note Backing up the database can take several minutes
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Reconfiguring OnCommand Report on page 46
Preparing to migrate report schedule on page 20
Migrating report schedules on page 22
Related references
Installation requirements for OnCommand Report on page 10
Migrating report schedulesOnCommand Report does not automatically restore report schedules during the upgrade You mustmanually restore the existing report schedules after upgrading OnCommand Report
Before you begin
Ensure that you have completed the prerequisites for migrating report schedules
Steps
1 Log in to the Reporting Connection by using the administrator credentials
2 In the Welcome page click OnCommand Report content
3 Navigate to the report that you want to set the schedule for and click the Schedule icon on theright side of the pane
4 Enter the schedule properties that you noted down while preparing to migrate the report schedulesand click Ok
Schedule properties could include any of the following options Frequency Options Start timeEnd time and Prompt values
Related concepts
Completing OnCommand Report upgrade tasks on page 20
Related tasks
Upgrading OnCommand Report on page 21
Preparing to migrate report schedule on page 20
22 | OnCommandreg Report 11 Installation and Administration Guide
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Uninstalling OnCommand ReportYou can uninstall OnCommand Report
Steps
1 Log in to the host as a user with administrator-level privileges
2 Click Start gt Control Panel
3 Select the program settings for your operating system
If the operating system is Then
Windows Server 2003 Select Add or Remove Programs
Windows Server 2008 Select Programs and Features
4 Uninstall OnCommand Report version
Deploying OnCommand Report | 23
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Configuring OnCommand Report
You can use the Administration Console to configure OnCommand Report so that users can view andcreate reports from the Reporting Connection
You can perform the following tasks to configure OnCommand Report
bull Validating your licensebull Managing data acquisition from DataFabric Manager serversbull Configuring AutoSupport for troubleshooting helpbull Managing user accountsbull Backing up and restoring databull Triggering manual data acquisitionbull Triggering the manual extract transform and load (ETL) operation
Logging in to the OnCommand Report AdministrationConsole
You can access the OnCommand Report Administration Console through a Web browser You canuse the Administration Console to configure OnCommand Report
Before you begin
Web browser requirements must be met
About this task
OnCommand Report ships with the following default user account
bull User name adminbull Password admin123
You must use this user account when you log in to the Administration Console for the first time Youshould change the password for this user account after you log in
Steps
1 Enter the following URL in your Web browser httphosthttp_port
host is the IP address or host name of the host where OnCommand Report is installed
http_port is the port that uses an HTTP connection This port is known as the portal port Thedefault port is 80
24 | OnCommandreg Report 11 Installation and Administration Guide
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
2 At the login screen enter your user name and password
The Administration Console appears
Related tasks
Changing passwords for user accounts on page 38
Related references
Web browser requirements on page 12
Getting started with OnCommand ReportAfter you install OnCommand Report you must configure it so that you can start viewing andcreating reports
About this task
You must log out of the OnCommand Report portal and log in again every time the services arerestarted
Steps
1 Log in to the Administration Console
2 Select Configure gt License
3 In the License Configuration dialog box enter your license key and click OK
4 When you see the prompt to restart services click OK
The services are restarted and you are redirected to the login page
5 Log back in to the Administration Console
6 Select Configure gt DataFabric Manager server
7 In the Edit Configuration dialog box add information about one or more DataFabric Managerservers
Related tasks
Initiating data acquisition from DataFabric Manager servers on page 32
Configuring OnCommand Report to send emails on page 43
Related references
License Configuration dialog box on page 27
AutoSupport Configuration dialog box on page 42
Configuring OnCommand Report | 25
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Edit Configuration dialog box on page 28
Manage Users dialog box on page 36
Obtaining your license keyTo use OnCommand Report you must obtain either an evaluation license key or a production licensekey
Step
1 Choose the type of license key you want to obtain
If you want Then do the following
An evaluation license Place a request at OnCommand Insight Customer Community
A production license Contact your NetApp sales representative
Related information
OnCommand Report Customer Community httpscommunitiesnetappcomcommunitynetapp_partners_networkstorage_management_softwareoncommandinsightview=overview
Validating your license keyYou need to validate your license key to enable OnCommand Report features
Before you begin
You must have an evaluation license key or a production license key
Steps
1 From the Administration Console select Configure gt License
2 In the License Configuration dialog box enter your license key
3 Click OK
The service is automatically restarted
Related references
License Configuration dialog box on page 27
26 | OnCommandreg Report 11 Installation and Administration Guide
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
License Configuration dialog boxUse the License Configuration dialog box to validate your license key
Details area
License Status The status of your license
License Validity The date that your license will expire
Options
Enter License Key Enter your license key The license key enables OnCommand Report features
Related tasks
Validating your license key on page 26
Configuring data acquisition from your DataFabric Managerservers
You can consolidate data from multiple DataFabric Manager servers and the reports that are based onthat data To do this you must configure data acquisition from your DataFabric Manager servers
Configuring data acquisition involves the following steps
bull Adding information about your DataFabric Manager servers to OnCommand Reportbull Testing the connection from the DataFabric Manager servers to OnCommand Reportbull Setting a data acquisition schedule
Note If you make any changes to the Poll Daily At timings when the acquisition is in progressthen the data acquisition is terminated prematurely
Adding information about your DataFabric Manager serversBefore you generate reports you must provide OnCommand Report with information about yourDataFabric Manager servers After you provide this information OnCommand Report can acquiredata from the DataFabric Manager servers
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click Add
Configuring OnCommand Report | 27
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
3 In the Add DataFabric Manager Server dialog box specify the details for the DataFabricManager server that you want to add
You must enter a unique name and IP or a fully qualified domain name for a DataFabric Managerserver
4 To disable the automatic testing of the connection to the DataFabric Manager server clear theTest connection check box
The Test connection option only tests the connectivity to the DataFabric Manager server butdoes not verify the DataFabric Manager server version or if the DataFabric Manager serverdatabase views are enabled
5 Click OK
Related references
Edit Configuration dialog box on page 28
DataFabric Manager server requirements on page 13
Information you need about DataFabric Manager servers on page 15
Edit Configuration dialog box
You can use the Edit Configuration dialog box to manage information about your DataFabricManager servers OnCommand Report uses this information to acquire data from the servers
You can perform the following tasks from this dialog box
bull Add information about a new DataFabric Manager serverbull Modify information about a DataFabric Manager serverbull Delete information about a DataFabric Manager serverbull Test the connection from OnCommand Report to a DataFabric Manager serverbull Set the data acquisition schedule
Options
Add Enables you to add information about your DataFabric Manager server
Edit Enables you to edit information about a DataFabric Manager server
Delete Enables you to delete the selected row from the table After you delete a row andsave your changes OnCommand Report no longer acquires data from theDataFabric Manager server
Test connection Enables you to test the connection between OnCommand Report and theDataFabric Manager servers
Poll Daily At Enables you to set the time of day that OnCommand Report acquires data fromall DataFabric Manager servers
28 | OnCommandreg Report 11 Installation and Administration Guide
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Lists
Name Name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host The host name or IP address of the host where the DataFabric Manager serveris installed
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Port The port for the DataFabric Manager servers database The default port is2638
Connection Status The connection status to your DataFabric Manager server
Related tasks
Adding information about your DataFabric Manager servers on page 27
Testing connections to DataFabric Manager servers on page 31
Setting the data acquisition schedule for DataFabric Manager servers on page 32
Editing information about your DataFabric Manager servers on page 30
Deleting information about your DataFabric Manager servers on page 31
You can use the Add DataFabric Manager dialog box to add a new DataFabric Manager serverOnCommand Report uses this information to acquire data from the servers
Content
Name Enter a name for the DataFabric Manager server Names must be unique and arerestricted to 255 alphanumeric characters
Host Enter the host name or IP address of the host where the DataFabric Managerserver is installed
Port Enter the port for the DataFabric Manager servers database The default port is2638
User Name Enter the user name for the database account on the DataFabric Manager server
Password Enter the password for the user that you specified
Version Select the version of the DataFabric Manager server
Configuring OnCommand Report | 29
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Test connection Lets you disable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Editing information about your DataFabric Manager serversYou can edit information about a DataFabric Manager server by changing the servers name IPaddress port or user credentials For example you might do this if you regularly change thepassword for the user account or if you upgrade your DataFabric Manager server to a new version
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name that you want to modify and clickEdit
3 In the Edit DataFabric Manager Server dialog box modify the server details
4 To test the connection to your DataFabric Manager servers select Test Connection
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
5 Click OK
Related references
Edit Configuration dialog box on page 28
Edit DataFabric Manager Server dialog box
You can use the Edit DataFabric Manager server dialog box to edit information about a DataFabricManager server
Content
Name You must enter a name for the DataFabric Manager server Names must beunique and are restricted to 255 alphanumeric characters
Host You must enter the host name or IP address of the host where the DataFabricManager server is installed
Port You must enter the port for the DataFabric Manager servers database Thedefault port is 2638
User Name You must enter the user name for the database account on the DataFabricManager server
Password You must enter the password for the user that you specified
30 | OnCommandreg Report 11 Installation and Administration Guide
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Version The version of the DataFabric Manager server See the Interoperability MatrixTool for information about supported versions
Test connection Lets you enable the option to test the status of the connection betweenOnCommand Report and the DataFabric Manager server
Deleting information about your DataFabric Manager serversYou can delete information about a DataFabric Manager server from OnCommand Report After youdelete the DataFabric Manager server information OnCommand Report no longer collects data fromthe DataFabric Manager server
About this task
When you delete a DataFabric Manager server OnCommand Report deletes all the data that itacquired from that DataFabric Manager server As a result reports do not include data from theDataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the name of the DataFabric Manager server that youwant to delete
3 Click Delete
4 When you see the prompt to confirm the deletion of the DataFabric Manager server click Yes
5 Click OK
Related references
Edit Configuration dialog box on page 28
Testing connections to DataFabric Manager serversYou can test the connection from OnCommand Report to your DataFabric Manager servers Youmight do this after you add a new DataFabric Manager server or to troubleshoot issues with anexisting DataFabric Manager server
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box click the server name and then click Test connection
Configuring OnCommand Report | 31
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
The Connection Status field displays the results of the test A green tick mark indicates that aconnection was established and a cross mark indicates that the connection was not established
Related references
Edit Configuration dialog box on page 28
Setting the data acquisition schedule for DataFabric Manager serversOnCommand Report acquires data from DataFabric Manager servers on a daily basis You can setthe time that you want OnCommand Report to poll all DataFabric Manager servers For exampleyou can set the time to 200 am every day
Steps
1 From the Administration Console click Configure gt DataFabric Manager server
2 In the Edit Configuration dialog box from the Poll Daily At drop-down list select the time thatyou want OnCommand Report to poll the DataFabric Manager servers
3 Click OK
Related references
Edit Configuration dialog box on page 28
Initiating data acquisition from DataFabric Manager serversYou can initiate data acquisition from your DataFabric Manager servers You might do this if you donot want to wait for the next scheduled poll time
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts newly collecteddata from the OnCommand Report database transforms it for the Data Warehouse and loads it in theData Warehouse where it is available for use in reports
You cannot initiate data acquisition if OnCommand Report is currently acquiring data from theserver
Steps
1 In the Manage DataFabric Manager servers view select a server from the list
2 Click Poll Now
The Poll Now button is disabled if data acquisition from DataFabric Manager servers is inprogress
OnCommand Report initiates data acquisition from the selected server
32 | OnCommandreg Report 11 Installation and Administration Guide
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
3 To initiate the ETL process in the Poll now confirmation box select Build ETL
If you do not want to update the Data Warehouse now with newly polled data clear Build ETL
4 In the Poll now confirmation box click Yes
Updating reports with acquired dataOnCommand Report updates the predesigned reports with newly acquired data on a regular basisBut if you want to update the reports immediately you can do so with the Build ETL option
About this task
Three hours from the start of OnCommand Report acquiring data from your DataFabric Managerservers it runs the extract transform and load (ETL) process This process extracts the acquired datafrom the OnCommand Report database transforms it into a data model that can be used in thereports and loads it into the Data Warehouse where it is available for use in reports
Steps
1 To initiate the ETL process select Administration gt Build ETL
2 In the confirmation message click Yes
Monitoring reporting data status with the ETL optionOnCommand Report updates predesigned reports with newly acquired data on a regular basis Butyou can update report data immediately using the Build ETL option You can then determinewhether the Extract Transform and Load (ETL) process has completed You should do this beforerunning reports so that the reports have the most up-to-date data
About this task
The ETL process extracts the acquired data from the OnCommand Report database transforms it intoa data model that can be used in the reports and loads it into the Data Warehouse where it isavailable for use in reports
The following diagram illustrates the process
Configuring OnCommand Report | 33
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Steps
1 From the Administration Console select the ETL Status tab
The Status indicates Success Failed or Aborted
2 If the ETL status is Aborted initiate an ETL build again by selecting Administration gt BuildETL
3 In the confirmation message click Yes
User accounts in OnCommand ReportYou can use the OnCommand Report Administration console to create user accounts and assign rolesso that users can view and create reports from the reporting connection
OnCommand Report includes the following types of users
Admin The user who manages user accounts and performs advanced functions AnAdmin can perform the following tasks
bull Log in to OnCommand Report Administration Consolebull Manage user accounts and assign rolesbull Enable and disable LDAPbull Modify predesigned reportsbull Create custom reports and save thembull Use advanced authoring features such as creating complex filters
formatting style and formatting multi-lingual supportbull View current past and up-coming activities and manage schedulesbull Manage content for exports imports consistency and report updatesbull Access Query Studio and Cognos Viewer
34 | OnCommandreg Report 11 Installation and Administration Guide
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
bull Configure printersbull Access public folders
ServerAdministrator
The members of the LDAP group who are assigned with the ServerAdministrator role A Server Administrator can perform the following tasks
bull Log into OnCommand Report Administration Consolebull Manage reporting user accounts and assign rolesbull Manage DataFabric Manager serversbull Enable and disable LDAPbull Make backup of database and restore itbull View logs audit logs and ETL jobsbull Configure and manage AutoSupport
Note The Server Administrator cannot modify or delete a user assigned withthe Admin role or view reports in the Reporting Connection
Report Author View predesigned reports
Save predesigned reports in public folders and modify them
Create custom reports and save them in public folders
Schedule reports
Report Viewer View predesigned reports
View custom reports
This table provides information about the maximum number of user accounts you can assign a roleto
User role Maximum accounts
Admin 1
Report Author 2
Report Viewer 10
Adding user accountsYou can use the OnCommand Report Administration Console to add a new user account Having adifferent user account for each person provides a way of controlling the access rights individualpreferences and accountability
Before you begin
The following actions must be completed
bull Passwords should be determined
Configuring OnCommand Report | 35
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
bull Users should be assigned an appropriate role
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click Add
3 In the Add User dialog box enter the user account information
You must enter a unique user name
4 Click OK
Related references
Manage Users dialog box on page 36
Add User dialog box
You can use the Add User dialog box to add user accounts
Options
User Name Enter the name assigned to the new user (alphanumeric including a-z A-Zand 0-9) This name is used to log into the reporting connection and is case-sensitive
Role Select the role that defines the access privileges for the user
New Password Assign a password for the user
Confirm Password Enter the password again to verify
Manage Users dialog boxYou can use the Manage Users dialog box to add user accounts edit user accounts and delete useraccounts You can also use this dialog box to enable and configure LDAP
General Settings
User Name The name assigned to the new user (alphanumeric including a-z A-Z and 0-9) Thisname is used to log into the reporting connection and is case-sensitive
Role The role that defines the access privileges for the user
Add Enables you to add user accounts
Edit Enables you to edit existing user accounts
Delete Enables you to delete existing user accounts
36 | OnCommandreg Report 11 Installation and Administration Guide
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
LDAP Settings
User PrincipalName
The attribute that identifies each user in the LDAP server The default nameis userPrincipalName which is globally unique OnCommand Reportmatches the contents of this attribute with the user name
The default value for Active Directory is sAMAccountName
Role The LDAP attribute that identifies the user role (defaults to memberOf)
DistinguishedName
The LDAP attribute that identifies the user distinguished name (defaults todistinguishedName)
Referral Indicates whether to follow the path to other domains if there are multipledomains in the enterprise You must always use the default (follow)
Timeout (msec) The length of time to wait for a response from the LDAP server beforetiming out in milliseconds (defaults to 2 seconds which is adequate in allcases and should not be modified)
LDAP Servers The IP address or DNS name to identify the LDAP server typically providedin this format ldap ltldap-server-addressgtport or use thedefault port ldapltldap-server-addressgt
Domain The LDAP node where OnCommand Report should start looking for theLDAP users (typically the top-level domain for the organization) Forexample DC=domainDC=com
ServerAdministrators
The group within the active directory server whose members are allowed towork with admin portal
The value of the role attribute that identifies the user as having Administratorprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Authors The group within the active directory server whose members are allowed towork with reporting connection with reporting author role
The value of the role Attribute that identifies the user as having ReportAuthor privileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Report Viewers The group within the active directory server whose members are allowed towork with reporting connection with reporting viewer role
The value of the role Attribute that identifies the user as having Guestprivileges
Note If you want to modify the value for this field you must disableLDAP first and then enable it
Configuring OnCommand Report | 37
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Directory LookupUser
The name of the user who has credentials to perform the lookup task in theactive directory
User Password The password of the directory lookup user
Confirm UserPassword
The option to confirm the password of the directory look up user
Editing user accountsYou can use the OnCommand Report Administration Console to modify an existing new useraccount
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name that you want to modify and click Edit
3 In the Edit User dialog box modify the information
4 Click OK
Edit User dialog box
You can use the Edit User dialog box to change the password for a user account defined on the localserver
Options
User Name The name assigned to the user
Role The option to change the user role You can change the user role to ReportAuthor or Report Viewer
Old Password The existing password that is assigned to a user
The Old Password option is available only when you change the passwordfor the Administrator user role
New Password The option to specify a new password for the user
Confirm Password The option to verify the new password
Changing passwords for user accountsYou can use the OnCommand Report Administration Console to change the password for a useraccount defined on the local server
Steps
1 In the Administration console select Configure gt Users
38 | OnCommandreg Report 11 Installation and Administration Guide
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
2 Click the User Name that you want to modify and click Edit
The Old Password option is available only when you change the password for theAdministrator user role
3 To change the password for a Report Author or a Report Viewer select the Change Passwordcheck box
4 In the New Password field specify the new password
5 In the Confirm Password field specify the same password as specified in the New Passwordfield
6 Click OK
Deleting user accountsYou can use the OnCommand Report Administration Console to delete an existing user account inReporting Connection You cannot delete the administrative user
Steps
1 In the Administration Console click Configure gt Users
2 In the General Settings tab click the User Name and click Delete
3 When you see the prompt to confirm the deletion click Yes
4 Click OK
Creating DataFabric Manager server usersYou can use the command-line interface in the DataFabric Manager server to create a database userand enable access to the database A database user can use the login credentials to connect to theDataFabric Manager server and acquire data for OnCommand Report
Before you begin
You must ensure that you have the access privileges to create a database user
Steps
1 To create a new database user enter the following command
dfm database user create -u DBUserName -p Password
Note The user name must start with an alphabetic or or _ (underscore) characters After thefirst character user name can include alphanumeric or _ $ characters
2 To enable database access to the new user enter the following command
dfm database access enable -u DBUserName
Configuring OnCommand Report | 39
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Note DB users have read-only access to DB views and to query the views
For more information about adding local users to the host see OnCommand Unified ManagerOperations Manager Administration Guide
Enabling and configuring LDAPThe LDAP server authenticates users grants administrative access assigns group membership andapplies permission settings to LDAP users For LDAP authentication to work you must configurethe OnCommand Report server to work with your existing LDAP servers
About this task
You can also import LDAP certificates The import options enable the OnCommand Report server toimport SSL certificates from the LDAP server The SSL certificates make LDAP traffic confidentialand secure
Steps
1 In the Administration Console click Configure gt Users
2 In the Manage Users dialog box click the LDAP Settings tab
3 Select the Enable LDAP check box
4 Enter the information in the Main Attribute section
The LDAP Settings window contains default values and these values are valid for the ActiveDirectory
5 Select the Import Certificate From Server check box to import the LDAP certificates
6 Enter the information in the Groups section
7 In the Directory lookup section enter the user name and password and confirm the password
You must do this only if you have modified the default values in the Attributes section else theLDAP settings will not be saved
8 Click OK
Related references
Manage Users dialog box on page 36
40 | OnCommandreg Report 11 Installation and Administration Guide
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Auditing user activityYou can view the actions that users have performed in the Administration Console For example youcan identify the user who deleted DataFabric Manager server connection information
Steps
1 From the Administration Console click the Troubleshooting tab
2 In the left pane click Audit Logs
The Audit Logs view appears
Audit Logs view
You can use the Audit Logs view to view the actions that users have performed in the AdministrationConsole
Audit Logs list
The Audit Logs list displays the actions that were performed in the Administration Console
Audit ID The ID of the action that was performed
Action The action that the user performed which is any of the following
bull DataFabric Manager server addedbull DataFabric Manager server name updatedbull DataFabric Manager server password updatedbull DataFabric Manager server removedbull DataFabric Manager server updated
User Name The name of the user who performed the action
Time The date and time that the action took place The date is displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed Time is displayed in the format of HHMM AMPM
Description A description of the action
Configuring AutoSupport for troubleshooting helpYou can configure OnCommand Report to periodically send information to technical supportAutoSupport is enabled by default you can keep it turned on or choose to turn it off
About this task
All NetApp products are equipped with automated capabilities to provide the support for customersThis AutoSupport periodically sends predesigned specific information to technical support NetApp
Configuring OnCommand Report | 41
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
uses this information to ensure the correct operation of OnCommand Report and to help you maintainthe integrity of your data center
No data is forwarded unless you first configure OnCommand Report to do so
The information is forwarded by using HTTPS The files do not contain clear text passwordsInstead the backup includes the hashed representation of user passwords and is encrypted for devicepasswords
OnCommand Report sends the information daily between 1000 pm and 200 am
Steps
1 From the Administration Console click Configure gt AutoSupport
2 In the AutoSupport Configuration dialog box modify the settings
3 Click OK
Related tasks
Sending AutoSupport information to technical support on page 54
Related references
AutoSupport Configuration dialog box on page 42
AutoSupport Configuration dialog boxYou can use the AutoSupport Configuration dialog box to enable or disable AutoSupport
Options
Enable AutoSupport AutoSupport is enabled by default You can clear the AutoSupport checkbox to disable AutoSupport
Customer Name You must enter the name of your company
Send Method OnCommand Report uses HTTPS to send information to NetApp
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
42 | OnCommandreg Report 11 Installation and Administration Guide
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Configuring OnCommand Report to send emailsTo email reports through the Reporting Connection you must configure OnCommand Report to useyour email server
Steps
1 On the host where OnCommand Report is installed select Start gt IBM Cognos 10-64 gt IBMCognos Configuration
2 In the Explorer pane under Data Access select Notification
3 In the Notification - Component Properties pane enter information about your mail server
4 Select Save Configuration and close IBM Cognos Configuration
Backing up the OnCommand Report databaseYou can back up the OnCommand Report server database and configuration settings You mightwant to do this before you install uninstall or upgrade OnCommand Report to ensure that there is nodata loss
Before you begin
You must ensure that you have sufficient disk space to make the backup
Steps
1 In the Administration Console click Administration gt Backup
You might get a message if there is insufficient disk space to make the backup
2 When you see the Backup prompt click OK
3 OnCommand Report prompts you to save the file on your computer Click Save
4 Navigate to the folder where you want to save the file and click Save
Do not change the file name extension
After you finish
Wait while the entire database is backed up before performing other tasks
Configuring OnCommand Report | 43
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Restoring the databaseYou can restore your OnCommand Report database from a backup file This operation cannot bereversed and completely replaces your current OnCommand Report data
Before you begin
You must have a backup of the current version
Steps
1 In the Administration Console click Administration gt Restore
2 In the Restore window click Browse to choose the file that you want to restore and clickRestore
If you are using Internet Explorer you must not specify the file path in the text field Instead youmust click the Browse button to choose the file If you specify an incorrect file path the restoreaction might go on infinitely
3 When you see the Database restored successfully prompt click OK
This completely replaces your current OnCommand Report information by using data from theselected file
Note You must perform a build ETL only then the data will be available for reporting
Exporting custom reportsYou can share custom reports with other users by making a backup of the reports and exporting themto the deployment folder
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
2 Click the Configuration tab and then in the left pane click Content Administration
3 In the toolbar click New Export
4 In the New Export wizard specify a name for the backup file and click Next
44 | OnCommandreg Report 11 Installation and Administration Guide
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
5 In the deployment method page ensure that the Select public folders and directory contentoption is selected and click Next
6 Click Add and select OnCommand Report version
7 Select the custom reports folder and move it to the right pane by clicking the arrow pointing rightand click OK
8 Complete the tasks in the New Export wizard and click Finish
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 The exported reports are saved in the OnCommand Report deployment directory OCRInstallDircognosc10_64deployment folder copy and save the custom report zip filethat you created in a different location
Importing custom reportsImporting the custom reports enable you to use the custom reports that are created by other users inthe deployment folder instead of creating them again
Before you begin
You must have administrator-level access privileges to perform this task
Steps
1 Copy the file that has to be imported to the deployment directory of the Cognos installation OCRInstallDircognosc10_64deployment folder
2 In the Reporting Connection toolbar click Launch gt Administer OnCommand ReportContent
3 Click the Configuration tab and then in the left pane click Content Administration
4 In the toolbar click New Import
The previously created backup is displayed in the list
5 Select the report from the list and click Next
6 In the New Import wizard specify a name for the import and click Next
7 Select the folder that you want to import and click Next
Note If you already have a folder with the same name then click the Pencil icon and changethe name to Custom_report_original so that it does not overwrite the existing folder
8 Complete the tasks in New Import wizard and click Finish
Configuring OnCommand Report | 45
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
9 In the Run with options page click Run
10 Select the View the details of the report after closing the dialog check box and click OK andin the summary page click Close
11 In the View Run History Details page click Close
Reconfiguring OnCommand ReportThe product settings are configured and committed during the installation of OnCommand Reportbased on the RAM size If you have increased or decreased the RAM size since the installation thenyou might want to reconfigure OnCommand Report so that memory is reallocated to each service asper the new RAM size
Before you begin
bull You must have administrator-level access privileges to perform this task Otherwise an errormessage is displayed
bull You must reconfigure OnCommand Report only if the RAM size is 8 GB or more Else an errormessage is displayed and the reconfiguration is terminated
Steps
1 From the Start menu click OnCommand Report gt Reconfigure OnCommand Report
2 When you see the reconfiguration confirmation message click OK
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Result
Memory is reallocated to OnCommand Report as per the new RAM size
46 | OnCommandreg Report 11 Installation and Administration Guide
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Monitoring the status of data acquisition
You can monitor the status of data acquisition from your DataFabric Manager servers to identifyissues with data acquisition
About this task
You can identify whether data acquisition completed successfully or if it failed If data acquisitionhas failed you can view the event log to determine why it failed You can use this information tocorrect the problem
Note You monitor the status of data acquisition through the DataFabric Manager server viewThis view automatically appears when you log in to the Administration Console
Steps
1 In the Administration Console click Configure gt DataFabric Manager server
The DataFabric Manager server view displays information about configured DataFabric Managerservers
2 Optional From the DataFabric Manager server view select a DataFabric Manager server todisplay the event log for that server
Note If you make any changes to the Poll Daily At timings when acquisition is in progressthen the data acquisition is terminated prematurely
Related references
Troubleshooting data acquisition on page 50
DataFabric Manager servers viewYou can use this view to monitor the status of data acquisition from your DataFabric Managerservers DataFabric Manager servers appear in this view after you configure OnCommand Report toacquire data from them
Options
Poll Now After you select a server from the table select Poll Now to initiate an immediateacquisition of data from the server
You can also initiate Poll Now on multiple DataFabric Manager servers
47
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Note This option is disabled if OnCommand Report is currently acquiring datafrom the server
Clear EventLog
After you select a server from the table select Clear Event Log to clear the eventsthat appear in the Event Log table
Refresh Select to refresh the information that appears in the Status view
Note This view automatically refreshes every 30 seconds
DataFabric Manager servers list
This table displays currently configured DataFabric Manager servers and the status of dataacquisition from those servers
DataFabricManagerServer
The name of the DataFabric Manager server
DataFabricManagerServer Host
The name or IP address of the host where the DataFabric Manager server isinstalled
Status The status of data acquisition from the server which is any of the following
Acquiring OnCommand Report is acquiring data from the server
Acquisitionservice is notrunning
OnCommand Report cannot acquire data because theacquisition service is not running To correct the issue usethe Windows Services utility to restart the OnCommandInsight Acquisition service
Failure Data acquisition failed The event log providesinformation about why data acquisition failed
The failed status is highlighted in red
Stand-by OnCommand Report is waiting until the scheduled time toacquire data from the server This status appears after youadd a new DataFabric Manager server to OnCommandReport
Success Data acquisition completed successfully
Last LoggedEvent
The date and time of the last logged event Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the hostwhere OnCommand Report is installed
48 | OnCommandreg Report 11 Installation and Administration Guide
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Event Log list
This table displays information about the events that took place when OnCommand Report attemptedto acquire data from the selected DataFabric Manager server
Event The name of the data acquisition event which is any of the following
Acquiring Device OnCommand Report was acquiring data from the server
Error Data acquisition failed The error message describes why dataacquisition failed
Stand-by OnCommand Report was waiting until the scheduled time toacquire data from the server
Success Data acquisition completed successfully
TimesOccurred
The number of times the event occurred For example the value in this column canindicate that data acquisition completed successfully 10 times
From The date and time the event started Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
To The date and time the event ended Dates are displayed in the format ofMMDDYY Time is displayed according to the time zone setting on the host whereOnCommand Report is installed
Related tasks
Monitoring the status of data acquisition on page 47
Initiating data acquisition from DataFabric Manager servers on page 32
Related references
Troubleshooting data acquisition on page 50
Monitoring the status of data acquisition | 49
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Troubleshooting OnCommand Report
You might run into issues when you use OnCommand Report You can troubleshoot any issuesrelated to data acquisition If you need help you can send AutoSupport information to technicalsupport
Troubleshooting data acquisitionIf OnCommand Report cannot acquire data from your DataFabric Manager servers an error appearsin the Administration Console in the DataFabric Manager server view You can troubleshoot theseerrors to fix the problem
Note To troubleshoot some of the errors you might need to work with the DataFabric Managerserver database For information about how to work with the database see the OnCommandUnified Manager Operations Manager Administration Guide
Error Description To fix the error
Error connecting JZ006Caught IOExceptionjavanetConnectExceptionConnection timed out connect
OnCommand Report cannotconnect to the DataFabricManager server at the specifiedIP address
bull Verify that the IP addressyou entered in OnCommandReport is correct
bull Verify that the DataFabricManager server is running
bull Test the connection betweenOnCommand Report andthe DataFabric Managerserver
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forStorage-List
OnCommand Report cannotaccess one or more of thefollowing DataFabric Managerserver database views
bull Verify that database accessis enabled for the databaseuser account
bull Enable the database views
Error retrieving data Failed torunbuild Object query forNetworkInterface-List
OnCommand Report cannotaccess the interfaceViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forvFiler-List
OnCommand Report cannotaccess the vFilerViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forAggregate-List
OnCommand Report cannotaccess the aggregateViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forDisk-List
OnCommand Report cannotaccess the diskView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forAggrToDisk-Mappings
OnCommand Report cannotaccess the plexView orraidGroupView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forVolume-List
OnCommand Report cannotaccess the volumeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Troubleshooting OnCommand Report | 51
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forSnapshot-List
OnCommand Report cannotaccess the snapshotView orsnapReserveView databaseview from the DataFabricManager server database
Enable the database views
Error retrieving data Failed torunbuild Object query forQTree-List
OnCommand Report cannotaccess the qTreeViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query for Lun-List
OnCommand Report cannotaccess the lunView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query foriGroup-List
OnCommand Report cannotaccess the igroupViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forlunIGroup-Mappings
OnCommand Report cannotaccess thelunIGroupMapView databaseview from the DataFabricManager server database
Enable the database view
Error retrieving data Failed torunbuild Object query forQuota-List
OnCommand Report cannotaccess the userQuotaViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query foruserIdToName-Mappings
OnCommand Report cannotaccess the userMapView oruserAliasView database viewfrom the DataFabric Managerserver database
Enable the database views
Error retrieving data Failed torunbuild Object query forNFSExport-List
OnCommand Report cannotaccess the nfsExportViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
52 | OnCommandreg Report 11 Installation and Administration Guide
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Error Description To fix the error
Error retrieving data Failed torunbuild Object query forCIFSShare-List
OnCommand Report cannotaccess the cifsShareViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forResGroupToObj-Mappings
OnCommand Report cannotaccess theresGroupMembersViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forCommentName-List
OnCommand Report cannotaccess thecommentNamesViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Error retrieving data Failed torunbuild Object query forObjComment-List
OnCommand Report cannotaccess the objCommentViewdatabase view from theDataFabric Manager serverdatabase
Enable the database view
Related tasks
Monitoring the status of data acquisition on page 47
Testing connections to DataFabric Manager servers on page 31
Editing information about your DataFabric Manager servers on page 30
Related references
DataFabric Manager servers view on page 47
Restarting the OnCommand Report serverYou can restart the OnCommand Report server You might restart the server if it stopped or totroubleshoot issues
About this task
Note The Start menu also provides shortcuts to start and stop OnCommand Report
Troubleshooting OnCommand Report | 53
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Steps
1 From the program list in the Start menu click NetApp gt OnCommand Report gt RestartOnCommand Report
2 When you see the restart confirmation message click OK
Sending AutoSupport information to technical supportIf you enabled AutoSupport OnCommand Report sends AutoSupport information on a nightly basisYou can also initiate this process rather than waiting for OnCommand Report to send theinformation
Before you begin
AutoSupport must be enabled to send information to technical support
Note In OnCommand Report AutoSupport is enabled by default
Steps
1 In the Administration Console click Administration gt Send AutoSupport
2 Click OK to continue
OnCommand Report sends AutoSupport information to technical support
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Related references
Troubleshooting view on page 54
Troubleshooting viewYou can use the Troubleshooting view to troubleshoot issues with data acquisition from yourDataFabric Manager servers
Options
Logs Displays the list of OnCommand Report logs
Audit Logs Displays the actions that users have performed in the Administration Console
Refresh Refreshes the list of logs
54 | OnCommandreg Report 11 Installation and Administration Guide
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Related tasks
Configuring AutoSupport for troubleshooting help on page 41
Sending AutoSupport information to technical support on page 54
Initiating data acquisition from DataFabric Manager servers on page 32
Logs viewThe Logs view table displays the list of OnCommand Report logs Technical support uses these logsto troubleshoot issues You can select a log from the table to display the last 50 lines from the logfile
Note OnCommand Report saves these log files in the directory where you installed the product
Logs list
Log File The name of the log file
Size (KB) The size of the log file
Description A description of the log
Troubleshooting OnCommand Report | 55
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Copyright information
Copyright copy 1994ndash2012 NetApp Inc All rights reserved Printed in the US
No part of this document covered by copyright may be reproduced in any form or by any meansmdashgraphic electronic or mechanical including photocopying recording taping or storage in anelectronic retrieval systemmdashwithout prior written permission of the copyright owner
Software derived from copyrighted NetApp material is subject to the following license anddisclaimer
THIS SOFTWARE IS PROVIDED BY NETAPP AS IS AND WITHOUT ANY EXPRESS ORIMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEWHICH ARE HEREBY DISCLAIMED IN NO EVENT SHALL NETAPP BE LIABLE FOR ANYDIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIALDAMAGES (INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTEGOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHERIN CONTRACT STRICT LIABILITY OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE
NetApp reserves the right to change any products described herein at any time and without noticeNetApp assumes no responsibility or liability arising from the use of products described hereinexcept as expressly agreed to in writing by NetApp The use or purchase of this product does notconvey a license under any patent rights trademark rights or any other intellectual property rights ofNetApp
The product described in this manual may be protected by one or more US patents foreign patentsor pending applications
RESTRICTED RIGHTS LEGEND Use duplication or disclosure by the government is subject torestrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and ComputerSoftware clause at DFARS 252277-7103 (October 1988) and FAR 52-227-19 (June 1987)
56 | OnCommandreg Report 11 Installation and Administration Guide
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
Trademark information
NetApp the NetApp logo Network Appliance the Network Appliance logo AkorriApplianceWatch ASUP AutoSupport BalancePoint BalancePoint Predictor Bycast CampaignExpress ComplianceClock Cryptainer CryptoShred Data ONTAP DataFabric DataFort DecruDecru DataFort DenseStak Engenio Engenio logo E-Stack FAServer FastStak FilerViewFlexCache FlexClone FlexPod FlexScale FlexShare FlexSuite FlexVol FPolicy GetSuccessfulgFiler Go further faster Imagine Virtually Anything Lifetime Key Management LockVaultManage ONTAP MetroCluster MultiStore NearStore NetCache NOW (NetApp on the Web)Onaro OnCommand ONTAPI OpenKey PerformanceStak RAID-DP ReplicatorX SANscreenSANshare SANtricity SecureAdmin SecureShare Select Service Builder Shadow TapeSimplicity Simulate ONTAP SnapCopy SnapDirector SnapDrive SnapFilter SnapLockSnapManager SnapMigrator SnapMirror SnapMover SnapProtect SnapRestore SnapshotSnapSuite SnapValidator SnapVault StorageGRID StoreVault the StoreVault logo SyncMirrorTech OnTap The evolution of storage Topio vFiler VFM Virtual File Manager VPolicy WAFLWeb Filer and XBB are trademarks or registered trademarks of NetApp Inc in the United Statesother countries or both
IBM the IBM logo and ibmcom are trademarks or registered trademarks of International BusinessMachines Corporation in the United States other countries or both A complete and current list ofother IBM trademarks is available on the web at wwwibmcomlegalcopytradeshtml
Apple is a registered trademark and QuickTime is a trademark of Apple Inc in the United Statesandor other countries Microsoft is a registered trademark and Windows Media is a trademark ofMicrosoft Corporation in the United States andor other countries RealAudio RealNetworksRealPlayer RealSystem RealText and RealVideo are registered trademarks and RealMediaRealProxy and SureStream are trademarks of RealNetworks Inc in the United States andor othercountries
All other brands or products are trademarks or registered trademarks of their respective holders andshould be treated as such
NetApp Inc is a licensee of the CompactFlash and CF Logo trademarks
NetApp Inc NetCache is certified RealSystem compatible
57
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
Troubleshooting view
Logs view
Copyright information
Trademark information
How to send your comments
Index
How to send your comments
You can help us to improve the quality of our documentation by sending us your feedback
Your feedback is important in helping us to provide the most accurate and high-quality informationIf you have suggestions for improving this document send us your comments by email to doccommentsnetappcom To help us direct your comments to the correct division include in thesubject line the product name version and operating system
You can also contact us in the following ways
bull NetApp Inc 495 East Java Drive Sunnyvale CA 94089 USbull Telephone +1 (408) 822-6000bull Fax +1 (408) 822-4501bull Support telephone +1 (888) 463-8277
58 | OnCommandreg Report 11 Installation and Administration Guide
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
DataFabric Manager serversadding 27database user account 13database views 13deleting information about 31editing 30gathering information 15monitoring data acquisition 47monitoring ETL status 33setting data acquisition schedule 32starting data acquisition 32supported versions 13testing connections 31updating reports 33
disk space requirements 10documentation
videos 9downloading installer 16
E
email configuring 43errors troubleshooting 50ETL process
initiating 33monitoring 33
I
installingon Windows Server 2008 19other than Windows 2008 16prerequisites 10
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support
OnCommand Reportadministrative login information 24architecture 6 7default ports 17features 6getting started 25logging in 24migrating report schedules 20 22overview 6questions you can answer 7reconfiguring 46upgrading 20 21what you can do with it 6
OnCommand Report restarting 53operating system requirements 10
P
passwords 38planning your deployment 10port requirements 10
R
Reporting Connectionoverview 7
reportsexporting 44monitoring ETL status 33updating with newly acquired data 33
requirementsCPU 10
DataFabric Manager servers 13disk space 10memory 10network 10operating system 10ports 10restoring databases 44web browser 12
S
scheduling data acquisition 32
T
troubleshootingconfiguring AutoSupport 41data acquisition 50OnCommand Report 50sending AutoSupport information 54
U
uninstalling 23user accounts
add users view 36 38adding 35auditing user activity 41changing password 38configuring LDAP 40creating 35deleting 39editing 38managing 36 37types of 34
V
videos 9
W
web browser requirements 12
60 | OnCommandreg Report 11 Installation and Administration Guide
Contents
Understanding OnCommand Report
OnCommand Report features
What you can do with OnCommand Report
Questions you can answer with OnCommand Report
OnCommand Report architecture
Where to find more information about OnCommand Report
Videos for OnCommand Report
OnCommand Report on the web
OnCommand Report documentation
Planning your OnCommand Report deployment
Installation requirements for OnCommand Report
Web browser requirements
Data ONTAP versions that OnCommand Report supports
DataFabric Manager server requirements
Information you need about DataFabric Manager servers
Deploying OnCommand Report
Downloading the OnCommand Report installer
Installing OnCommand Report
List of ports used by OnCommand Report
Configure Server panel
Installing OnCommand Report on Windows Server 2008
Completing OnCommand Report upgrade tasks
Preparing to migrate report schedule
Upgrading OnCommand Report
Migrating report schedules
Uninstalling OnCommand Report
Configuring OnCommand Report
Logging in to the OnCommand Report Administration Console
Getting started with OnCommand Report
Obtaining your license key
Validating your license key
License Configuration dialog box
Configuring data acquisition from your DataFabric Manager servers
Adding information about your DataFabric Manager servers
Edit Configuration dialog box
Add DataFabric Manager Server dialog box
Editing information about your DataFabric Manager servers
Edit DataFabric Manager Server dialog box
Deleting information about your DataFabric Manager servers
Testing connections to DataFabric Manager servers
Setting the data acquisition schedule for DataFabric Manager servers
Initiating data acquisition from DataFabric Manager servers
Updating reports with acquired data
Monitoring reporting data status with the ETL option
User accounts in OnCommand Report
Adding user accounts
Add user view
Manage Users dialog box
Editing user accounts
Edit user view
Changing passwords for user accounts
Deleting user accounts
Creating DataFabric Manager server users
Enabling and configuring LDAP
Auditing user activity
Audit Logs view
Configuring AutoSupport for troubleshooting help
AutoSupport Configuration dialog box
Configuring OnCommand Report to send emails
Backing up the OnCommand Report database
Restoring the database
Exporting custom reports
Importing custom reports
Reconfiguring OnCommand Report
Monitoring the status of data acquisition
DataFabric Manager servers view
Troubleshooting OnCommand Report
Troubleshooting data acquisition
Restarting the OnCommand Report server
Sending AutoSupport information to technical support