The following is a Primus(R) eServer  solution:

ID: emc148982
Domain: EMC1
Solution Class: 3.X  Compatibility

Goal       How do I automate collecting .NAR  files?

Goal       Scripting .NAR file dumps prior to FLARE Release  24

Goal       Scripting .NAR file for FLARE Release 24 and  later

Fact       Product: CLARiiON CX4  Series

Fact       Product: CLARiiON CX3  Series

Fact       Product: CLARiiON CX  Series

Fact       Product: CLARiiON FC  Series

Fact       EMC SW: Navisphere Analyzer (versions prior to  Release 24)

Fact       EMC SW: Navisphere Analyzer (Release 24 and  later)

Symptom    Need a script to automate retrieving .NAR file  dumps every 24 hours to a Windows server.

Change     Customer  site has two CX700 arrays and one CX600 array and is running Navisphere Analyzer  to collect performance data for analysis.

Fix       

With Analyzer Release 24 and later, you can use the Navisphere GUI to start  Analyzer using the Periodic Archiving function that will automatically create  and store Analyzer archives on the array (Periodic Archiving is enabled by  default). These archives can then be manually retrieved using the GUI interface  (Tools\Analyzer\Archive\Retrieve) or by using the Navisphere Analyzer CLI  commands (see the Navisphere Analyzer Command Line Interface (CLI) manual  available on Powerlink).  If you need to script this function (retrieving the archives), you can use  Navisphere Analyzer CLI archiveretrieve command to perform the same functions  (creating and retrieving the current archive in one operation).

IMPORTANT: The function of the  archiveretrieve command is really a "create and retrieve" command. When you  issue the command, archiveretrieve will create a new archive  file based on the contents of the current archive buffer. If the buffer holds 10  or more data points, a new archive will be created and downloaded to your  workstation. The name of this file depends on the -File switch  - this is the filename that you assign. If the buffer contains less than 10 data  points, the command will take the date from the last archive created (if one  exists on the array), rename the file to what you gave in the -File  and download to your workstation. There are conditions where  the data may appear to be from an older archive with a new name. If you just  need to use Navisphere CLI to download existing archives from the array, use the  "analyzer -list" command to list all the available archives and use the  "analyzer -f " to retrieve the files. The -File   is the name from the -List command. You can also use the "-analyzer -path  " if you want to list all archives stored on the array and  retrieve one or more files.

• naviseccli -h IP_Address_SP -username -password  -scope <0|1> analyzer -archive -list  -- lists all  archives stored on the array
• naviseccli -h IP_Address_SP -username -password  -scope <0|1> analyzer -archive -all  -- this command  requires user input - retrieves all archives stored on the array to the  directory where the command is run from. Add the -path to  specify the download location. Add the -o switch to download ALL archives  without requiring user input
• naviseccli -h IP_Address_SP -username -password  -scope <0|1> analyzer -archive -path   --  this command will list all the archives stored on the array and requires user  input - allows you to select one or more of the listed archives to download to  the location . The -o switch does not work for this  command.
• naviseccli -h IP_Address_SP -username -password  -scope <0|1> analyzer -archive -file   --  this command requires user input in the basic mode - allows you to selectively  download one archive to the directory where the command is run from. You supply  the . Add the -path to specify the download  location. Add the -o switch to download without requiring user input. You can  use this command for scripting. You must know the name of the archive that you  want to download - run the -list command to get list of stored  archives.

Caution! Remember that if Analyzer is not licensed on the  array the archive files will be encrypted for Release 24 and later. The archive  filename suffix will be .NAZ. If Analyzer is licensed the suffix will be .NAR.  When using the batch program below, make sure you use the correct suffix. If  using unlicensed Analyzer and you name the archive .NAR when you try to open the  file, you will get an error message saying that the file is encrypted and that  you must contact Support to read the file.

With Analyzer Release 22 and earlier, no Periodic Archiving  function automatically creates the archives. You will need to manually retrieve  the archive using the Navisphere GUI (which creates and retrieves the archive in  one operation) or use a CLI script to create and retrieve the archive (the JAVA  archiveretrieve.jar command). With Analyzer Release 22 and  earlier you must install the optional Analyzer Enabler in order to use Analyzer.  It is disabled if not licensed.

In either case, you should review the Navisphere On-Line Help for additional  information about using Analyzer and also the Navisphere Analyzer CLI manual  (available from Powerlink) for additional information about the different CLI  commands. Below are some examples of the methods used to automate retrieving the  archives from the array.

Scripting for FLARE releases prior to Release 26

Sometimes it is useful and necessary to automate the collection of Navisphere  Analyzer .NAR files in order to review the performance of the array.

By creating a small .BAT file that runs the Navisphere  archiveretrieve.jar command, you can set up a Windows scheduler  task to run the .BAT file at different times throughout the day. The  archiveretrieve.jar command will work for all operating  system versions of Navisphere Host Agent/CLI package. The structure of the batch  file will differ for each operating system. This example is for Windows.

The following BAT file commands will create and collect the NAR/NAZ files  from the array and store them in a subdirectory called \archive off the  C:\Programs Files\EMC\Navisphere CLI directory. The .BAT file should be created  in the "\Navisphere CLI" directory in order to run correctly. Since the  archiveretrieve.jar command is a Java command and requires that  you use the security model for Java, you must add the username/password of a  global user on the array (or create a security file).

You will need to add the IP address for both SP A and SP B. You should also  change "serial#" to the last four digits of the array serial number or  some other identifier:

For example,  "-4736-CX700-SPA.nar" would identify the NAR file as coming  from a CX700 array with the last four digits of the array serial number of  4736.

For /f "tokens=2-4  delims=/ " %%a in ('date /t') do (set date=%%a-%%b-%%c)

Scripting for FLARE Release 26 and  later

JAVA commands will not work with Release 26.

If you run the -archiveretrieve command before the next 10 Archive Interval  data points have been collects, the file retrieved will be the last one created.  Remember that the -archiveretrieve command will create and retrieve a  new archive, it will not retrieve specific archives already stored on  the array.

The files created with the -archiveretrieve command will remain on the array. There is a limit to the number of archives  stored and when this limit is reached, the oldest archives will be  overwritten.

You can use the Release 24 Java commands for use with  Release 24 and earlier arrays, but not with Release 26 arrays.

The  analyzer “.jar” files will not be installed when you install Release 26 CLI. If  you install over Release 24 and already have the “.jar” files, you will have the  option to keep them.

New Analyzer subcommands with Release 26 CLI will  work the same as the Java commands now work. You can run these commands against  an array running Release 26 and later and with FLARE releases of 19, 22 and 24.  (You can now use the same script for all arrays as long as they all have the  most current flare release from 19 to 26).

• -archiveretrieve
• -archivedump
• -archivemerge

The script below will only work on arrays where analyzer is enabled and  running AND (for Release 24 and later) that Periodic Archiving is Disabled AND  “Stop Automatically After” is not enabled.

1. Use a .BAT file to retrieve archives. In this example,  “getnar.bat” is  used.
2. Find a Windows workstation (management workstation) and install the latest  Navisphere CLI Release 26.
3. Create a bat file, getnar.bat (see sample script below), in the c:\program  files\emc\navisphere cli\ directory.
4. Then create a new directory called \archive off the "navisphere cli"  directory.
5. Modify the parameters in the commands to match your  system:
   
   Naviseccli –h xxx.xxx.xxx.xxx -User xxxx -Password xxxx -Scope 0  analyzer -archiveretrieve -File %date%-%time%-serial#-SPx.nar -Location  "c:\program files\emc\navisphere cli\archive"
   
   You will need the IP  address for SP A and SP B and the username\password of a global admin user on  the array that you intend to run the batch file against. Change the -file  parameter to give the archive a name that matches the array, maybe the last 4  digits of the serial number.
6. Then create a Scheduled Task in Windows to run the batch file every xx  interval where  xx is based on the archive interval that you have set on the  array.
      
   • If the archive interval is 600 seconds, run the program every 24 hours
   • If the archive interval is 300 seconds, run the program every 12 hours
   • If the archive interval is 120 seconds, run the program every 5 hours
   • If the archive interval is 60 seconds, run the program every 2.5  hours

----------------------------------------------------------------------------------------------------------------------------------------------

For  /f "tokens=2-4 delims=/ " %%a in ('date /t') do (set  date=%%a-%%b-%%c)

For /f "tokens=1-3 delims=: " %%a in ('time /t') do  (set time=%%a-%%b-%%c)

Naviseccli -User xxxx -Password xxxx -Scope 0  -Address xxx.xxx.xxx.xxx analyzer –archiveretrieve -File  %date%-%time%-serial#-SPA.nar -Location "c:\program files\emc\navisphere  cli\archive"

Naviseccli -User xxxx -Password xxxx -Scope 0 -Address  xxx.xxx.xxx.xxx analyzer –archiveretrieve -File %date%-%time%-serial#-SPB.nar  -Location "c:\program files\emc\navisphere  cli\archive"