Load Array Attributes and Values and Assign to Arrays
Function: The Load Array Attributes utility provides an efficient method of assigning attributes to a large number of arrays.
Take the following steps to load array attributes and values:
4. Create a report template using a Report Template Designer.
Once attribute values are assigned to hosts, a Report Template Designer report can query the database to report on arrays, filtered by the attributes that you’ve created to categorize them.
Create a CSV File of Arrays, Attributes, and Values
In preparation for loading array attributes, you will need to enter information into a spreadsheet from which you will create a comma-separated values (CSV) file. The table in the spreadsheet should be in the following format:
Columns
• One column lists the arrays, which must already exist in the APTARE IT Analytics database.
• Each additional column lists attributes and values.
Rows
• First (Header) Row - Enter the object type—in this case, Array Name—followed by attribute names. Note that any column may be used for the list of array names. When you run the utility, you’ll indicate which column contains the array names. The header row is information only and is not processed as a data row.
• Subsequent rows list arrays, followed by the attribute values that you are assigning to each array.
Execute the Load Array Attribute Utility
Before You Begin
Bulk Load utilities must be run in SQLPLUS as user APTARE. The load_package utility is located in:
/opt/aptare/database/stored_procedures (Linux)
\opt\oracle\database\stored_procedures (Windows)
To assign attributes to arrays
Note: This utility only assigns attributes to active arrays. If an array exists in the system, but it is inactive, the log will indicate that no attribute was assigned.
2. Save the table as a comma-separated file (for example, ArrayAttributes.csv).
3. Log in to the Portal server.
4. At the command line:
su - aptare
5. At the command line, launch sqlplus:
sqlplus <pwd>/<pwd>
• Example: sqlplus portal/portal
6. Execute the following at the SQL prompt:
SQL> Execute load_package.loadArrayAttributeFile('pathname_and_filename', 'domain_name',array_name_column_num,'log_path_name','log_file_name','check_valid_value');
Where:
'pathname_and_filename' | Full path + filename (enclosed in single straight quotes) of the CSV file you created. |
'domain_name' | Name (enclosed in single straight quotes) of the APTARE IT Analytics domain in which the arrays reside. See Finding the Domain Name. |
array_name_column_num | Column number in the csv file where the array names are listed. These arrays must already exist in the APTARE IT Analytics database. Typically, this would be column 1. |
'log_path_name' | Full path (enclosed in single straight quotes) where the log file will be created/updated. Verify that you have write access to this directory. Example: 'C:\tmp' Optional: If you do not specify a path and log file name, only error messages will be written to the scon.err file. To omit this parameter, enter: '' |
'log_file_name' | Filename of the log where execution status and errors messages are written. Example: 'ArrayAttributeLoad.log' Optional: If you do not specify a path and log file name, only error messages will be written to the scon.err file. To omit this parameter, enter: '' |
'check_valid_value' | 'Y' or 'N' Indicates if you want the utility to check if the values provided in this file are among the existing possible values for the attributes. Y or N must be enclosed in single straight quotes. |
Example:
Execute load_package.loadArrayAttributeFile('C:\myfiles\ArrayAttributes.csv',
'QA_Portal',1,'C:\tmp','ArrayAttributeLoad.log','Y');
7. Restart the Portal services so that the newly added attributes become available in the Dynamic Template Designer.
Verify the Array Attributes Load
To verify that the attribute load took effect:
1. In the Portal, go to Tools > Templates > SQL Template Designer.
2. To verify Array attributes, use the following query in the SQL Template Designer:
select * from aps_v_storage_array_attribute
