FUJITSU Storage ETERNUS Software Active IQ Config Advisor 5.8. Quick Start Guide

| Contents |

Contents

Overview of Active IQ Config Advisor

Installing and setting up Active IQ Config Advisor

System requirements for Active IQ Config Advisor

Supported protocols for data collection

Installing Active IQ Config Advisor on Windows

Installing Active IQ Config Advisor on Mac OS X

Installing Active IQ Config Advisor on Linux

Hosting Active IQ Config Advisor with nginx (HTTPS)

Replacing nginx.conf file

Running nginx and Active IQ Config Advisor

Upgrading Active IQ Config Advisor

Collecting data using Active IQ Config Advisor

Collecting data using the solution-based collection method

Collecting data using ETERNUS AB/HB Series

Scheduling a data collection job

Setting up email notification

Editing a saved job

Creating user accounts

Comparing configurations

Viewing and analyzing the data

Importing collected data files

Uninstalling Active IQ Config Advisor

Troubleshooting

Resolving Active IQ Config Advisor launching error

Backing up the database

Changing the default timeout for command execution

Restarting the Active IQ Config Advisor server

Resetting the Admin account password

Updating data offline

Trademark

END USER LICENSE AGREEMENT FOR FUJITSU LTD. TOOLS

How to send comments about documentation and receive update notifications

Index

Overview of Active IQ Config Advisor

Active IQ Config Advisor is a configuration validation and health check application for Fujitsu systems that can

be deployed onsite for data collection and analysis. It can be used to check a Fujitsu system for the correctness

of hardware installation and conformance to Fujitsu recommended settings. It runs a series of commands

and checks for configurations with cabling, availability, and resiliency issues. The flexible data collection

architecture supports data collection from network, serial port, and Active IQ OneCollect file. It is used to

improve the quality of Fujitsu deployments during system setups, upgrades, and ongoing health checks.

You can extend the behavior of Active IQ Config Advisor and run Active IQ Config Advisor across your Fujitsu

deployments using the following profiles:

• ETERNUS AX/HX Series

• ETERNUS AB/HB Series

As you start using Active IQ Config Advisor, it is important that you understand some of the basic terms that

you can expect to see throughout the Active IQ Config Advisor user interface.

Table 1:

Persona

Description

General

Collects basic commands for the target device.

Diagnostic

Collects additional diagnostic commands and logs from the device other than the

ones that run in General mode.

Analysis

Runs only those commands that are required for analysis. Preferred persona for

running analysis in Active IQ Config Advisor.

Active IQ Config Advisor can be used in the following scenarios:

• System setup: Active IQ Config Advisor can be used during installation of new equipment, and adding

of new disk shelves. It can also be used during moving, and changing of equipment as it requires close

attention to cabling and conformance to Fujitsu best practices.

• Operational health checks: Active IQ Config Advisor can be used on a monthly or quarterly basis to detect

any new issues resulting from configuration changes or non-conformance to Fujitsu best practices.

• Periodic data collection and analysis: You can use Active IQ Config Advisor to run jobs periodically to do

the assessment.

Features in Active IQ Config Advisor

The features available in Active IQ Config Advisor are as follows:

• Active IQ Config Advisor can be installed on multiple platforms - Windows, Mac, and Linux (64-bit).

• Displays cumulative at-a-glance information about a job in the dashboard and individual profile

dashboards.

• Collects data and performs analysis through the Network profile for ETERNUS AX/HX Series profiles.

• Exports to PDF, Word and Excel reports for the ETERNUS AX/HX Series profiles.

• Merges reports from multiple jobs in PDF, Word, or Excel.

• Provides a command viewer, collection scheduler, saving projects (encryption)and job listing.

• Provides health check details, device details, storage configuration.

• Supports the following profiles ETERNUS AX/HX Series and ETERNUS AB/HB Series.

• Supports secure hosting and user management.

Using Active IQ Config Advisor dashboard

On the first launch of Active IQ Config Advisor, you will see an overlay screen. The information provided in this

screen will help you understand how you can use Active IQ Config Advisor.

Active IQ Config Advisor has tabs that help you use the application easily.

After the Active IQ Config Advisor is launched, the landing page appears:

Installing and setting up Active IQ Config Advisor

Before you start using Active IQ Config Advisor, you must download and install Active IQ Config Advisor.

System requirements for Active IQ Config Advisor

You must ensure that you have the required host system configuration, operating system, and browser to run

the Active IQ Config Advisor.

Active IQ Config Advisor can run on the following operating systems:

• Windows 7 (64-bit)

• Windows 8 (64-bit)

• Windows 10 (64-bit)

• Windows 2008 R2 Server (64-bit)

• Windows 2012 R2 Server (64-bit)

• Mac OS X 10.10 and later (64-bit)

• Red Hat Enterprise Linux (RHEL) 7.0 and later (64-bit)

• Ubuntu 7.0 and later (64-bit)

Active IQ Config Advisor supports the following browsers:

• Mozilla Firefox 55 and later

• Google Chrome 61 and later

• Apple Safari 11 and later

• Microsoft Edge 40 and later

Supported protocols for data collection

Active IQ Config Advisor supports some profiles that help you collect data from solutions. You should learn

more about these profiles to help you decide which one to use.

Each profile contains the credentials for the database associated with the profile. The credentials enable

Active IQ Config Advisor to connect to and work with the database. The stored credentials include the

username and password for accessing the host, repository, database, and the required information.

Solution-based collection types

Table 2:

Profile

Sub profile

Corresponding device

Supported protocol

ETERNUS AX/HX

• Network

• Cluster Node

• HTTPS and SSH

Series

• Serial

• Cluster Switch

• SSH

• Management Switch

• SSH

ETERNUS AB/HB

• Host

• Cluster Node

• HTTP(s) and SSH

Series

• ETERNUS AB/HB Series -

• Back-end FC switch

• SSH and Telnet

SMCLI

(Cisco and Brocade)

• ETERNUS AB/HB Series -

SANtricity Web Services

Proxy

| Installing and setting up Active IQ Config Advisor |

Installing Active IQ Config Advisor on Windows

You can install Active IQ Config Advisor either on your system or you can host it in a central server that can

be accessed by multiple users. You can install Active IQ Config Advisor in a central location either on a group,

organization, or company level. It supports Hyper Text Transfer Protocol Secure (HTTPS). Active IQ Config

Advisor provides necessary basic authentication to save your work. It supports up to 10 user accounts. User

management feature is available in the case of centrally hosted deployment.

Before you begin

• You must ensure that you have the required host system configuration, operating system, and browser to

run the Active IQ Config Advisor.

System requirements for Active IQ Config Advisor.

• You must have downloaded the Active IQ Config Advisor executable binary "ConfigAdvisor5.8_Win64.exe"

or "ConfigAdvisor5.8_Win64.zip for your platform.

http://www.fujitsu.com/global/support/.

About this task

You can read the following steps.

You have two options to install Active IQ Config Advisor on your system:

• Custom Install: You can host Active IQ Config Advisor in a centralized location. It also allows to modify the

installation and data directory paths.

• Express Install: You can install Active IQ Config Advisor in a default location. The install directory is saved

in the Programs Folder and Data directory in the user directory.

Procedure

1. Install Active IQ Config Advisor by completing the steps in the installation wizard.

The default installation folder for Active IQ Config Advisor on Windows operating system is as follows:

Note: In the Active IQ Config Advisor Setup wizard, select Yes if you want to perform User Management

tasks and want HTTPS for Active IQ Config Advisor.

Table 3:

Operating system

Default installation folder

Windows 64-bit

C:\Program Files\Fujitsu\ConfigAdvisor

ConfigAdvisor5.8_Win64.exe

You can change the default installation path to either a folder or drive of your choice.

2. Choose a different path for data directory, if you want to change the default path.

3. Launch Active IQ Config Advisor from the URL:http://localhost:8055/ca/#/. If you have enabled HTTPS, then

launch Active IQ Config Advisor from https://localhost.

Note: To configure the application to run on a different port, modify PORT value in the CONFIG file located

in the <user_home_directory>\Fujitsu\ConfigAdvisor\Config and restart the application (for example,

PORT = 8040). To host the Active IQ Config Advisor server centrally to be accessed from remote hosts,

you can edit the config file and append the IP address to bind to as prefix to port (for example: PORT =

0.0.0.0:8055 will make it open to all hosts on all IPs. Alternatively, PORT = <dedicated_IP>:8055 will make

it available on the specific IP configured on host).

What to do next

If you want to run Active IQ Config Advisor automatically during system startup, perform the following steps:

| Installing and setting up Active IQ Config Advisor |

1. Navigate to <Install_directory>\Fujitsu\ConfigAdvisor\>, right-click

‘ActiveIQConfigAdvisor.exe’ and select copy.

2. Find the Startup folder in All Programs and right-click it.

3. Click Open, and it opens up in the Windows Explorer.

4. Right-click anywhere inside that window and click the shortcut.

Active IQ Config Advisor shortcut should pop up in the folder, and the next time you log into Windows,

Active IQ Config Advisor automatically starts up.

Installing Active IQ Config Advisor on Mac OS X

You can install Active IQ Config Advisor on your Mac OS X system.

Before you begin

You must be running either Mac OS X 10.10.x or Mac OS X10.11.x on your system.

Procedure

1. Browse to the directory in which you have downloaded the tar.gz installer.

For more information about using Active IQ Config Advisor with HTTPS, see Hosting Active IQ Config Advisor

with nginx (HTTPS).

2. Extract it by running tar -xzf ConfigAdvisor5.8_mac64.tar.gz if you have admin privileges, or else run sudo

tar -xzf ConfigAdvisor5.8_mac64.tar.gz.

Note: If you are downloading Active IQ Config Advisor using the Chrome browser, it automatically extracts

in to a .tar file. In this case, run tar

-xf ConfigAdvisor5.8_Mac64.tar.gz.

3. Change directory (cd) to the extracted folder.

4. For secure site, run: "touch <install dir>/Fujitsu/ConfigAdvisor/plugins/common_utils/model/resources/

secure" and then start the ConfigAdvisor process.

5. If you want to customize the Active IQ Config Advisor data directory path, create a file with a name as

"data_dir.txt" under <install dir>/Fujitsu/ConfigAdvisor/ and enter the path where you want to place the

database and result files.

6. Type ./ConfigAdvisor, if you have admin privileges or sudo ./ConfigAdvisor. If you do not

have admin privileges, then press Enter.

Use ‘nohup ./ConfigAdvisor &’ to run process in the background. Active IQ Config Advisor will start

running on port 8055. Ensure that the port is free before running Active IQ Config Advisor. Database will be

saved in your home directory in the Fujitsu/config advisor/Db folder.

Note: To configure the application to run on a different port, modify PORT value in the CONFIG file located

in the <user_home_directory>/Fujitsu/ConfigAdvisor/Config and restart the application (for example,

PORT = 8040). To host the Active IQ Config Advisor server centrally to be accessed from remote hosts,

you can edit the config file and append the IP address to bind to as prefix to port (for example: PORT =

0.0.0.0:8055 will make it open to all hosts on all IPs. Alternatively, PORT = <dedicated_IP>:8055 will make

it available on the specific IP configured on host).

What to do next

If you want to run Active IQ Config Advisor automatically during system startup, perform the following steps:

1. Choose Apple menu > System Preferences, and click Users & Groups.

2. Select the user and click Login Items.

3. Click the Add button ‘+’ under the list on the right, select ‘config advisor’ from <install_dir>/

ConfigAdvisor.

4. Click Add.

| Installing and setting up Active IQ Config Advisor |

Installing Active IQ Config Advisor on Linux

You can install Active IQ Config Advisor on your Linux system through the command-line interface. You must

perform this task if you are installing Active IQ Config Advisor for the first time.

Before you begin

• Your Linux host system must be running the supported software versions: later than RHEL (later than 6.4),

and Ubuntu (later than 12.0).

• You must have downloaded the Active IQ Config Advisor executable binary for your platform.

• You must have the necessary privileges to install the application.

Procedure

1. Browse to the directory where you have downloaded the tar.gz installer.

For more information about using Active IQ Config Advisor with HTTPS, see Hosting Active IQ Config Advisor

with nginx (HTTPS)

2. Extract it by running tar -xzf ConfigAdvisor5.8_linux64.tar.gz *i*f you have admin privileges, or else run

sudo tar -xzf ConfigAdvisor5.8_linux64.tar.gz.

Note: If you are downloading Active IQ Config Advisor using the Chrome browser, it automatically extracts

in to a .tar file. In this case, run tar

-xf ConfigAdvisor5.8_Linux64.tar.gz.

3. Change directory (cd) to the extracted folder.

4. For secure site, run: "touch <install dir>/Fujitsu/ConfigAdvisor/plugins/common_utils/model/resources/

secure" and then start the ConfigAdvisor process.

5. If you want to customize the Active IQ Config Advisor data directory path, create a file with a name as

"data_dir.txt" under <install dir>/Fujitsu/ConfigAdvisor/ and enter the path where you want to place the

database and result files.

6. Type ./ConfigAdvisor if you have admin privileges or sudo ./ConfigAdvisor if you do not have

admin privileges, then press Enter.

Use ‘ nohup ./ConfigAdvisor & ’ to run process in the background. Active IQ Config Advisor will

start running on port 8055. Ensure that the port is free before running Active IQ Config Advisor. Database

will be saved in your home directory in the Fujitsu/ConfigAdvisor/Db folder.

Note: To configure the application to run on a different port, see Installing Active IQ Config Advisor on Mac

OS X

If you are not installing the application as root, use sudo while running the commands mentioned in the

preceding steps.

What to do next

If you want to run Active IQ Config Advisor automatically during system startup, perform the following steps:

1. Edit the rc.local file (vi /etc/rc.local).

2. Add a line at the end of file to start the Active IQ Config Advisor process (nohup /path_to_ConfigAdvisor/

ConfigAdvisor &).

3. Modify the permission for rc.local (chmod +x /etc/rc/local)

The Active IQ Config Advisor process will start up automatically in the next reboot.

Hosting Active IQ Config Advisor with nginx (HTTPS)

You can host Active IQ Config Advisor, at a centralized location, for using Active IQ Config Advisor with nginx

(HTTPS).

Note: To enable user management feature on Mac and Linux, edit the CONFIG file located at ~/Fujitsu/

ConfigAdvisor/Config/ and add this entry: HOSTED = TRUE

The information is applicable for the following operating systems:

| Installing and setting up Active IQ Config Advisor |

On Mac

• Command to install nginx - brew install nginx

Install paths:

• nginx executable install path - /usr/local/bin/nginx

• nginx config dir - /usr/local/etc/nginx

On Linux - RHEL

Command to install nginx - yum install nginx

Install paths:

• nginx executable install path - /usr/sbin/nginx

• nginx config dir - /etc/nginx

On Linux- Ubuntu

• Command to install nginx - sudo apt-get install nginx

Install paths:

• nginx executable install path - /usr/sbin/nginx

• nginx config dir - /etc/nginx

Generate SSL domain_name.key and domain_name.cert on the system:

Commands:

• sudo openssl genrsa 1024 > domain_name.key

• sudo chmod 400 domain_name.key

• sudo openssl req -new -x509 -nodes -sha1 -days 365 -key domain_name.key -

out domain_name.cert

Replacing nginx.conf file

You can replace nginx.conf file in Active IQ Config Advisor for using Active IQ Config Advisor with HTTPS.

Procedure

1. Copy nginx.conf from ConfigAdvisor install directory and replace it with the nginx.conf file that is located in

the config directory specified in Hosting Active IQ Config Advisor with nginx.

2. Edit the server_name with the IP address or host name, ssl_certificate with the path of domain_name.cert

generated on the system and ssl_certificate_key with the path of domain_name.key generated on the

system.

For example, server_name - 10.141.39.131 (IP address of the system); ssl_certificate /home /

domain_name.cert;

ssl_certificate_key /home / domain_name.key;

Running nginx and Active IQ Config Advisor

You can run nginx and Active IQ Config Advisor for using Active IQ Config Advisor with HTTPS.

Procedure

1. Go to nginx installed folder (for example, /usr/sbin) and type chmod 777 nginx (to provide all

permissions).

2. Type ./nginx -t to check if configuration is correct.

3. Kill all the earlier nginx processes running on the system: Use the command ps

-ef|grep nginx

kill -9 pid.

4. Run nginx as:

sudo ./nginx.

5. Extract the ConfigAdvisor install directory.

6. Navigate to the ConfigAdvisor install directory.

7. Create a file "https" in the ConfigAdvisor install directory. Use the command: touch https.

8. Run ./ConfigAdvisor.

Upgrading Active IQ Config Advisor

You can upgrade to a different version of Active IQ Config Advisor or reinstall the same version on Windows,

Mac, or Linux system. You can use one of the two options for upgrading Active IQ Config Advisor.

About this task

When you upgrade Active IQ Config Advisor and install it on your system, you will get two options:

Procedure

Select one of the options to upgrade Active IQ Config Advisor on your Windows system.

If you want to...

Then...

Perform a clean install

Click Yes for clean installation. The installer

will delete the database and perform a clean

installation.

Perform an upgrade

Click No to upgrade. The installer will retain the

database files, which in turn retains the user

preferences.

Select one of the options to upgrade Active IQ Config Advisor on Mac or Linux system.

If you want to...

Then...

Perform a clean install

a. You must delete database and Config file by

running rm -rf ~\Fujitsu\Config

Advisor.

b. Delete the older install directory.

c. Install the new version by running ./config

advisor from the extracted installer package

under <download path>\Fujitsu

\config advisor>.

Perform an upgrade

a. Delete the older install directory.

b. Install the new version by running ./config

advisor from the extracted installer package

under <download path>\Fujitsu

\config advisor>.

| Collecting data using Active IQ Config Advisor |

Collecting data using Active IQ Config Advisor

Active IQ Config Advisor enables you to collect data from different types of solutions.

About this task

Using Active IQ Config Advisor, you can collect data by using the following collection profile:

• Solution Based: This helps you collect data from a set of preconfigured solution stacks.

• Import Collected Data Files: This helps you to load the data collected from another system using either

Active IQ OneCollect or Active IQ Config Advisor and import the collected data files for analysis.

Collecting data using the solution-based collection method

Solution-based profile is a predefined profile. By using this profile, you can configure data collection for

solutions, such as ETERNUS AX/HX Series, ETERNUS AB/HB Series and other solutions.

About this task

You can read the following steps for installing the Active IQ Config Advisor.

To perform a minimal data collection, you should enter the credentials for switch, node, cluster, and server.

Procedure

1. Click Data Collection Jobs tab.

2. Choose Solution Based option from the Collection Type drop-down list.

3. From the Profile drop-down list, select the required profile, for example, ETERNUS AX/HX Series.

4. From the Sub profile drop-down list, select Network.

5. From the Persona drop-down list, select Analysis.

For more information about Personas, see

Overview of Active IQ Config Advisor.

6. Select the appropriate cluster switch model and management switch option.

7. Enter the credentials in the Hostname or IP, and Password fields.

8. Active IQ Config Advisor validates the credentials of solution(s) in two ways:

a) Auto validation for one solution: Enter the host name, username, and password and then move to the

next row, the validation of the previous solution starts automatically.

b) Manual validation for all the solution: Enter the host name, username, and password and then click

the Validate button.

9. By default, all the commands are selected for the solution. If you need to modify the commands, click the

Commands icon under the Actions column.

10. Click Save/Collect button to proceed with data collection.

Collecting data using ETERNUS AB/HB Series

ETERNUS AB/HB Series works with the Active IQ Config Advisor to enable data collection and validation using

any of the sub profiles Host, ETERNUS AB/HB Series-SMCLI and ETERNUS AB/HB Series SANtricity Web Services

Proxy. You can collect data using ETERNUS AB/HB Series.

About this task

Follow the steps to collect data using ETERNUS AB/HB Series.

| Scheduling a data collection job |

Scheduling a data collection job

You can create scheduled backup job by selecting an entire job start time and recurrence pattern for the saved

job. You can also view all backup jobs on the Saved Projects tab.

Before you begin

Active IQ Config Advisor must have at least one of the jobs saved for scheduling a job.

Procedure

Select a saved job.

Click the Edit Schedule icon.

In the Scheduler, enter the exact time that you want the scheduler to set for the saved job.

Click Save.

In the Recurrence Pattern pane, enter the details in the respective fields.

If you want to...

Then...

Set the interval

Select Interval from the Recurrence Pattern

drop-down list.

Select the Hours and Minutes from the drop-

down lists.

Enter the value (frequency of the schedule) in

the Occurrence field for the job to be scheduled.

Click Save Schedule.

Click Close.

Set for daily schedule

Select Daily from the Recurrence Pattern drop-

down list.

Select the Hours and Minutes from the drop-

down lists.

Enter the frequency of days in the Recur Every

field for the job to be scheduled.

Considering this is a daily schedule, if you enter

2 in the Recur Every field, the schedule set for a

saved job will repeat for 2 days and then expire.

Enter the value (frequency of the schedule) in

the Occurrence field for the job to be scheduled.

Click Save Schedule.

Click Close.

Set for weekly schedule

Select Weekly from the Recurrence Pattern

drop-down list.

In the Start Time drop-down list, enter the time

in the Hours and Minutes fields.

Select either one day of the week or all the days

of the week.

Enter the value (frequency of the schedule) in

the Occurrence field for the job to be scheduled.

Considering this is a weekly schedule, if you

enter 8 in the Occurrence field, the schedule set

for a saved job will repeat for 8 weeks and then

expire.

Click Save Schedule.

| Scheduling a data collection job |

If you want to...

Then...

f. Click Close.

6. Monitor the job progress and execution logs for scheduled jobs.

Setting up email notification

You can configure the settings for the Active IQ Config Advisor server to send alert notifications. You can

configure the corresponding mail server to be used and various notification mechanisms—for example, alert

notifications can be sent as emails.

Before you begin

The following information must be available:

• Email address from which the alert notification is sent.

• Host name, default port, username, and password to configure the SMTP server.

Procedure

1. On the home page, click Settings > Basic Settings.

2. Select the Enable Notifications for Scheduled Jobs checkbox, if you want to receive notifications for

scheduled jobs.

3. Select the Enable Notifications for Unscheduled Jobs checkbox, if you want to receive notifications for

unscheduled jobs.

4. Enter the information in the SMTP Host, Port, SMTP Username, SMTP Password, and Email Notification

Recipients fields.

5. Click Save.

Creating user accounts

If multiple people in your organization need to use Active IQ Config Advisor, then you need to create Active

IQ Config Advisor user accounts for each user. When you are using the User Management feature of Active IQ

Config Advisor, you can create two types of users: Admin and User. The Admin and User have the privilege to

create jobs, manage jobs, and manage users.

About this task

The two roles that are assigned to the users are Admin and User. The following table lists a few common

Active IQ Config Advisor user-interface operations.

Table 4:

Roles

Operation

Admin

You can add, delete, or edit user account(s). In

addition, you can also view and delete jobs, saved

projects, and scheduled jobs across all the users. You

also have the privilege to reset passwords for the

user accounts. As an Admin, you can assign one of

the users with the Admin privileges.

Note: You can create a maximum of 10 user

accounts.

User

As a user, you can only view and manage jobs that

you have created. You can create, delete, and change

the settings of only your account.

When you create a new user, the user is added to use Active IQ Config Advisor with applicable permission

settings.

Procedure

1. Click the User Management tab.

2. Click Create User.

The Create a User prompt is displayed.

3. In the Username box, enter your username.

4. In the Password box, enter the password.

5. Enter the email addresses of the role that you want to select for a particular account.

6. Select one of the roles, Admin or User, which you want to assign to the user.

7. Click Submit.

| Comparing configurations |

Comparing configurations

This feature allows you to view the difference between the two configurations selected for data collection.

About this task

You must select one job belonging to ETERNUS AX/HX Series network for comparing against the most popular

configuration for the ETERNUS AX/HX Series version derived from install base. You must select two jobs

belonging to ETERNUS AX/HX Series network for comparing configurations between the two jobs.

Procedure

Perform any one of the following two tasks for comparing the configurations:

If you want to...

Then...

Compare against the popular configurations:

On the Data Collection Jobs page, select the

This feature allows you to select one ETERNUS AX/

check box of the job name that you want to

HX Series job to compare against the most popular

compare against the popular configuration.

configuration.

Click the Compare against the popular

configurations button.

The comparison performed for the selected job

files is displayed.

You can click a slice of a pie chart to view the

values of the respective sections.

You can select the check box to filter the

difference in values existing in both the files.

Note: The user interface displays the difference,

whereas in the report that is exported shows all

the sections that are parsed for comparison.

After the data has been filtered, click the Export

button to export the data to a spreadsheet.

Config Compare: This feature allows you to select

On the Data Collection Jobs page, select the

two ETERNUS AX/HX Series jobs to compare against

check box of the two job names that you want to

each other.

compare.

Click the Config Compare button.

The comparison performed for the selected job

files is displayed.

You can click a slice of a pie chart to view the

values of the respective sections.

You can select the check box to filter the

difference in values existing in both the files.

Note: The user interface displays the difference,

whereas in the report that is exported shows all

the sections that are parsed for comparison.

After the data has been filtered, click the Export

button to export the data to a spreadsheet.

Viewing and analyzing the data

You can view results of the ETERNUS AX/HX Series and ETERNUS AB/HB Series profiles in Active IQ Config

Advisor. In addition, you can view the node, cluster switch, and management switch details. The results

include information about the device type, device name, model, operating system, and the firmware version.

About this task

You can view the results on the Data Collection Jobs page. After collecting the data for better user experience

and usability, Active IQ Config Advisor helps you to organize jobs and that can viewed under Group Name

column in the Data Collection Jobs tab.

Procedure

To view collected data, perform any one of the following methods:

If you want to...

Then...

View data of the recent completed job

Click the Data Collection Jobs tab.

Click View & Analyze icon.

The View & Analyze page displays the health

report, device summary, and storage utilization.

To view the detailed analysis, click the pie chart or

the device summary.

Click Data View to view the commands used in

the selected job.

Click the expand symbol (>>) to view the

collected data.

You can view the path of the file.

Click Export to export the job information.

View data for other jobs

Click the Data Collection Jobs tab.

Select the job name.

You can click the View & Analyze icon for viewing

the summary of the job name that you have

selected.

if you want to change the job, on the left-hand

side of the View & Analyze tab, click the job link.

View all the recent jobs that are listed out.

Select the job that you want to view for additional

information.

View the health report

Click the View & Analyze tab.

Click the pie chart under Health Report.

The detailed description is available of all the

configuration validations and health checks that

are run. You can select different segments of the pie

chart to view general information about the devices

listed. It also displays the configuration checks for

only the selected controllers or switches.

| Troubleshooting |

Troubleshooting

You can find information about how to troubleshoot some of the issues that you might come across when you

use Active IQ Config Advisor. You can also find explanations for the issues, possible causes, and solutions.

Resolving Active IQ Config Advisor launching error

Active IQ Config Advisor does not launch on Windows, Mac or Linux system after installation.

About this task

To launch Active IQ Config Advisor on either Windows, Mac, or Linux system, perform the following steps:

Procedure

In a browser, manually enter the URL:

http://localhost:8055/ca/

If you want to...

Then...

Resolve Active IQ Config Advisor launching error on

Check whether the Active IQ Config Advisor

Windows

process is running in the Task Manager in

Windows.

If the process is not running, go to the installation

directory, by default <C:\Program Files

\Fujitsu\Config Advisor> and launch

the Active IQ Config Advisor process by clicking

ActiveIQConfigAdvisor.exe.

If it still does not work, the port might be used by

other application (check netstat

-an).

To rectify this issue, edit the CONFIG file in the

user directory <user home directory>

\Fujitsu\Config Advisor\Config> and

set the PORT number to an available port. Restart

Active IQ Config Advisor.

If you are trying to access Active IQ Config Advisor

from the other systems, make sure the firewall

allows the port used by Active IQ Config Advisor.

Resolve Active IQ Config Advisor launching error on

Check whether the process is running by

Mac and Linux

executing ps aux | grep Active IQ

Config Advisor.

If the process is not running, go to the installation

directory, by default <install_dir>/

Config Advisor> and launch the Active IQ

Config Advisor process by running ./Config

Advisor.

If it still does not work, the port might be used by

other application (check netstat

-an).

To rectify this issue, edit the CONFIG file in the

user directory <user home directory>/

Fujitsu/Config Advisor/Config> and

set the PORT number to an available port. Restart

Active IQ Config Advisor.

| Troubleshooting |

If you want to...

Then...

If you are trying to access Active IQ Config Advisor

from the other systems, make sure the firewall

allows the port used by Active IQ Config Advisor.

Backing up the database

The device credentials, saved jobs, and user preferences are saved in the database.

About this task

If you want to delete Active IQ Config Advisor, it is advised to back up the database to avoid losing your saved

data.

Procedure

1. Navigate to <user_home_directory>\Fujitsu\Config Advisor\Db>.

2. Back up the database folder.

Changing the default timeout for command execution

You can change the default timeout for command execution using the COLLECTION_TIMEOUT variable in the

Config file.

Procedure

1. Open the Config file.

• Windows: <user_home_directory>\Fujitsu\Config Advisor\Config

• Mac and Linux: <user_home_directory>/Fujitsu/Config Advisor/Config

2. Change the value of COLLECTION_TIMEOUT to the desired time value (in seconds).

3. Save the file.

4. Restart the server.

The framework will include the new timeout value.

Restarting the Active IQ Config Advisor server

You can restart the server on a host using either Windows, Mac, or Linux.

Procedure

Use one of the following methods to restart the Active IQ Config Advisor server.

If you want to...

Then...

Restart Active IQ Config Advisor on Windows system

a. Right-click and select Start Task Manager.

b. Click Processes tab and select

activeiqconfigadvisor.exe.

c. Click End Process.

Restart Active IQ Config Advisor on Mac and Linux

a. Search for Active IQ Config Advisor process using

systems

ps aux | grep Config Advisor.

b. Note down the process ID of Active IQ Config

Advisor and kill the process using kill

<pid>.

| Troubleshooting |

If you want to...

Then...

c. Restart the process by running ./Config

Advisor from the Active IQ Config Advisor install

directory.

Resetting the Admin account password

You can reset the password if you have forgotten the password of Admin account.

Procedure

1. Open the command prompt or the terminal and navigate to Active IQ Config Advisor installation directory.

2. Enter the following:

a) On Windows, enter “ActiveIQConfigAdvisor.exe -m" followed by the password.

b) On Linux and Mac, enter "./ConfigAdvisor - c".

3. Upon prompting for password, type 'admin' password, press Enter.

4. Type it a second time to confirm it.

If the confirm password matches the password, "Password changed successfully" message will be

displayed.

5. If confirm password does not match, repeat steps 3 and 4.

Updating data offline

In the case of secure sites, no network access is available. You can still update the data offline.

Procedure

Perform the following methods to update either the resource file or open rules:

If you want to...

Then...

Update the resource_binary file

a. Download the resource_binary.zip folder.

b. Place the folder in the

ConfigAdvisorDataDirectory_Base/

replacing the resources_binary file.

Update the open rules

a. Download the zip file.

b. Extract the zip file into this path

{USERPROFILE}/ConfigAdvisorData/

openrules.

No part of this document covered by copyright may be reproduced in any form or by any means - graphic,

electronic, or mechanical, including photocopying, recording, taping, or storage in an electronic retrieval

system - without prior written permission of the copyright owner.

Software derived from copyrighted Fujitsu material is subject to the following license and disclaimer:

THIS SOFTWARE IS PROVIDED BY FUJITSU "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,

INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A

PARTICULAR PURPOSE, WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL FUJITSU BE LIABLE FOR ANY

DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Fujitsu reserves the right to change any products described herein at any time, and without notice. Fujitsu

assumes no responsibility or liability arising from the use of products described herein, except as expressly

agreed to in writing by Fujitsu. The use or purchase of this product does not convey a license under any patent

rights, trademark rights, or any other intellectual property rights of Fujitsu.

END USER LICENSE AGREEMENT FOR FUJITSU LTD. TOOLS

IMPORTANT - READ CAREFULLY: This End User License Agreement ("EULA") is a legal agreement between

You either as an individual or as an authorized representative of a business entity (hereafter referred to as

"You" and/or "Your"), and Fujitsu Ltd. ("Fujitsu"). Fujitsu is willing to license to You the Fujitsu software product

accompanying this EULA, which includes, without limitation, computer software features, authorized updates

and upgrades or other supplements to the software, images, music, text and/or animations incorporated into

the software, media, printed materials, or online or electronic documentation, provided by Fujitsu or made

available for download (collectively referred to as the "Software"). Your download, installation and/or use of

the Software constitutes acceptance of all of the terms stated herein. If You do not agree with all of these

terms, You must promptly return the Software to Fujitsu or the authorized reseller from which You obtained

the Software.

1. License Grant. Subject to payment of applicable fees, if any, and the limitations and restrictions set forth

herein, Fujitsu and its licensors grant to You a non-exclusive, non-transferable, worldwide, limited, royalty-free

license, without right of sublicense, to install and use the Software, in accordance with the terms contained

in the user documentation accompanying the Software (the "Documentation"). Use of the Software outside

the scope of the Documentation is unauthorized and shall constitute a material breach of this EULA. Fujitsu's

licensors shall be a direct and intended third party beneficiary of this EULA and may enforce their rights

directly against You in the event of Your breach of this EULA. The Software is licensed, not sold, to You.

2. License Restrictions.

2.1 Standard Use Restrictions. Subject to any express restrictions contained within the Documentation, You

shall not nor shall You allow any third party to: (a) decompile, disassemble, decrypt, extract, or otherwise

reverse engineer or attempt to reconstruct or discover any source code or underlying ideas, algorithms, or file

formats of, or of any components used in the Software by any means whatever; (b) remove or conceal any

product identification, copyright, patent or other notices contained in or on the Software or Documentation;

or restricted feature, function, service, application, protocol, operation, or capability without first purchasing

the applicable license(s) and/or obtaining a valid license enablement key from Fujitsu, even if such feature,

function, service, application, protocol, operation or capability is technically achievable without a key; (e)

sell, lease, rent, lend, sublicense, distribute or otherwise transfer in whole or in part the Software or the

applicable license enablement key to another party or to a different storage controller or cluster; or (f) modify

the Software, incorporate it into or with other software, or create a derivative work of any part of the Software.

Your modification of the Software will breach this EULA, and such derivative work is and shall be owned

entirely by Fujitsu or its licensors. You hereby assign and agree to assign to Fujitsu or the licensor of the

Software all right, title and interest in and to said derivative work. You acknowledge that the Software is not

designed, licensed or intended for use in the design, construction, operation or maintenance of any nuclear

facility, aircraft operation, air traffic control or life support system. Fujitsu disclaims any express or implied

warranty of fitness for such uses. If You use the Software for such applications, You agree to indemnify, defend

and hold Fujitsu and its licensors harmless from all claims, actions, losses, liabilities, damages, costs and

expenses (including attorney fees) arising out of or relating to such prohibited uses.

You agree to use Software which Fujitsu has embedded in the Fujitsu equipment ("Embedded Software")

solely as embedded in, and for execution on, Fujitsu equipment You originally purchased from Fujitsu or its

authorized resellers.

2.2 Support. Fujitsu and its licensors are under no obligation to support the Software or to provide You with

updates, unless otherwise agreed in writing by an authorized representative of Fujitsu. If Fujitsu, at its sole

option, supplies updates to You, the updates will be considered part of the Software, and subject to the terms

of this EULA.

3. Intellectual Property Rights. The Software is protected by intellectual property and copyright laws and

treaties worldwide, and may contain trade secrets of Fujitsu or its licensors, who have and maintain exclusive

right, title and interest in and to the Software, and reserve and retain all rights not expressly granted to

You herein. No right, title or interest in or to any trademark, service mark, logo or trade name of Fujitsu or

its licensors is granted under this EULA. All title and intellectual property rights in and to software content

which is not contained in the Software, but may be accessed or used through use of the Software, is the

product belonging to the respective content owner and may be protected by patents, intellectual property and

| END USER LICENSE AGREEMENT FOR FUJITSU LTD. TOOLS |

may be governed by the respective terms and conditions of use relating to such content.

4. Audit. You agree to give Fujitsu or its licensors and its independent accountants the right to examine

Your books, records, systems and usage associated with the Software during regular business hours upon

reasonable notice to verify compliance with this EULA. If such audit discloses non-compliance with this EULA,

You shall promptly cure such non-compliance, plus promptly pay the reasonable costs of conducting such

audit.

5. Termination. This EULA is effective until terminated. Fujitsu may terminate this EULA immediately and

without notice if You fail to comply with any term of this EULA. Termination of this EULA shall not relieve You

from Your obligations to immediately pay Fujitsu any sums owed hereunder or under any other agreement

with Fujitsu. Upon termination, all rights to use the Software will cease, and You shall promptly destroy the

original and all copies of the Software and any license enablement keys in Your possession or under Your

control. Termination is not an exclusive remedy and all other remedies otherwise entitled by law shall remain.

Sections 2 through 10 shall survive termination of this EULA.

6. Disclaimer of Warranty. THE SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS"

WITHOUT ANY WARRANTY OF ANY KIND. ALL EXPRESS AND IMPLIED CONDITIONS, REPRESENTATIONS, AND

WARRANTIES, INCLUDING, ANY IMPLIED WARRANTY OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS

FOR A PARTICULAR PURPOSE, ANY WARRANTY OF NONINFRINGEMENT, OR ANY WARRANTY THAT THE SOFTWARE

IS ERROR-FREE ARE HEREBY DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE

LEGALLY INVALD.

7. Limitation of Liability. THE TOTAL LIABILITY OF FUJITSU, ITS LICENSORS, DISTRIBUTORS AND RESELLERS

FOR ANY DAMAGE OR CLAIM ARISING FROM USE OF THE SOFTWARE OR THE ACCOMPANYING DOCUMENTATION

SHALL NOT EXCEED THE AMOUNT ACTUALLY PAID BY YOU FOR THE SOFTWARE OR US$100.00, WHICHEVER

IS GREATER. FUJITSU AND ITS LICENSORS, DISTRIBUTORS AND RESELLERS ARE NOT LIABLE FOR ANY DIRECT,

INDIRECT, INCIDENTAL, EXEMPLARY, SPECIAL, OR CONSEQUENTIAL DAMAGES; LOST OR CORRUPTED DATA, LOSS

OF PROFITS, SAVINGS, OR REVENUES; PROCUREMENT OF SUBSTITUTE GOODS, INTERRUPTION OF BUSINESS, OR

FOR ANY OCCURRENCE BEYOND THEIR CONTROL, RELATED TO THE USE OF OR INABILITY TO USE THE SOFTWARE,

RELATED CONTENT THROUGH THE SOFTWARE, THE PROVISION OF OR FAILURE TO PROVIDE SUPPORT OR OTHER

SERVICES, OR OTHERWISE IN CONNECTION WITH ANY PROVISION OF THIS EULA. IN NO EVENT SHALL FUJITSU'S

LICENSORS BE LIABLE FOR ANY DAMAGES OF ANY KIND INCLUDING DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR

CONSEQUENTIAL DAMAGES (WHICH SHALL INCLUDE WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS

OR PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)

WHETHER BASED ON CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING OUT OF THE USE OF OR INABILITY TO

USE THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

8. U.S. Government and Export Regulations. The Software is a Commercial-Off-The-Shelf ("COTS") product

developed at private expense; no portion of the Software has been developed with U.S. Government, State

or other public-sector funds; the Software contains trade secrets and confidential commercial or financial

information exempt from disclosure by 5 U.S.C. Section 552(B) (3) and (4) (Freedom Of Information Act) and

18 U.S.C. Section 1905 (Trade Secrets Act); and the ownership of the Software and any reproductions shall

remain with Fujitsu. The Software is provided to U.S. Government Agencies other than the U.S. Department

of Defense ("DOD") with RESTRICTED RIGHTS and all supporting Documentation is provided with LIMITED

RIGHTS. Use, duplication, or disclosure by the U.S. Government is subject to the restrictions as set forth in

the Commercial Computer Software - Restricted Rights clause at FAR 52.227-19(b)(2). If the sale is to a DOD

agency, the Government's rights in Software, supporting Documentation, and technical data are governed by

the restrictions in the Technical Data Commercial Items clause at DFARS 252.227-7015 and the Commercial

Computer Software and Commercial Computer Software Documentation clause at DFARS 227-7202. Contractor/

Manufacturer is: Fujitsu Limited, 1-1, Kamikodanaka 4-chome, Nakahara-ku, Kawasaki-shi, Kanagawa-ken

211-8588, Japan. Except as expressly licensed hereunder, all rights are reserved.

The Software is subject to U.S. export control laws and may be subject to export or import regulations in other

countries. You agree to comply with all applicable regulations and obtain any applicable licenses or other

authorizations to export, re-export, or import the Software.

9. Third Party Software.

9.1 Notwithstanding other statements in this EULA, third party software including free, copyleft and open

source software components (collectively referred to as "Third Party Software") are distributed in compliance

with the particular licensing terms and conditions attributable to the Third Party Software. Fujitsu provides the

Third Party Software to You "AS IS" without any warranties or indemnities of any kind.

| END USER LICENSE AGREEMENT FOR FUJITSU LTD. TOOLS |

9.2 Copyright notices and licensing terms and conditions applicable to the Third Party Software are available

for review with the Software documentation included on the media on which You received the Software within

a "NOTICES" file (e.g., NOTICES.pdf or NOTICES.txt) included within the downloaded files, and/or reproduced

within the materials or Documentation accompanying the Software.

10. General. You may not transfer Your rights under this EULA without Fujitsu's prior written approval. Fujitsu

does not waive any of its rights under this EULA by delaying to exercise its rights, or exercising only part

of its rights at any time. Any notice, report, approval or consent required or permitted by this EULA shall

be in writing. If any provision of this EULA shall be adjudged by any court of competent jurisdiction to be

unenforceable or invalid, that provision shall be limited or eliminated to the minimum extent necessary so

that the obligations of the parties shall remain in full force and effect and enforceable. This EULA shall be

deemed to have been made in, and shall be construed pursuant to, the laws of Japan, excluding its conflicts of

law provisions. The United Nations Convention on Contracts for the International Sales of Goods is specifically

disclaimed. You acknowledge that breach of this EULA would cause irreparable injury to Fujitsu for which

monetary damages would not be an adequate remedy and You agree that Fujitsu shall be entitled to seek

equitable relief in addition to any remedies it may have hereunder or at law. You acknowledge and agree

that Fujitsu reserves the right to control all aspects of any lawsuit or claim that arises or results from Your

use of the Software. Any amendments or waivers shall be effective only if made in writing by non-preprinted

agreements clearly understood by both parties to be an amendment or waiver and signed by an authorized

representative of each party. This EULA is the final and complete agreement between the parties relating to

the license of the Software hereunder and prevails over any conflicting or additional terms of any quote, order,

acknowledgment, or similar communication between the parties.