HPE 3PAR 3.0 StoreServ Management Console Administrator's Guide
Mainos
Mainos
HPE 3PAR StoreServ Management
Console 3.0 Administrator’s Guide
Abstract
This document describes the HPE 3PAR StoreServ Management Console (SSMC). The audience for this document includes storage administrators who monitor and manage system configurations and resource allocation for HPE 3PAR StoreServ
Storage Systems.
Part Number: QL226-99206
Published: November 2016
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or copying. Consistent with FAR
12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website.
Acknowledgments
Microsoft ® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
Java ® and Oracle® are registered trademarks of Oracle and/or its affiliates.
Red Hat ® and Red Hat Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and other countries.
Contents
1 HPE 3PAR StoreServe Management Console (SSMC)......................................6
2 SSMC compatibility and interoperability..............................................................8
3 SSMC deployment model..................................................................................13
4 Federation requirements for SSMC...................................................................14
5 Security settings for SSMC................................................................................15
6 Installing SSMC.................................................................................................17
7 Configuring SSMC.............................................................................................20
8 HPE 3PAR Excel add-in for System Reporter in SSMC....................................24
9 CA certificates in SSMC....................................................................................26
Creating an SSMC CA-signed browser certificate using a non-keytool method......................28
Contents 3
10 Using SSMC....................................................................................................31
11 Uninstalling SSMC...........................................................................................35
Uninstalling SSMC in a Windows 8, Windows 10, or Windows Server 2012 environment................35
12 Troubleshooting for SSMC installation and configuration................................37
13 Support and other resources...........................................................................47
4 Contents
Glossary...............................................................................................................49
A Open source code ............................................................................................50
Contents 5
1 HPE 3PAR StoreServe Management Console (SSMC)
The HPE 3PAR StoreServ Management Console (SSMC) is a standalone product that you install as a single package. SSMC provides contemporary browser-based interfaces, including a Main console and an Administrator console, for monitoring 3PAR StoreServ Storage System.
•
Main Console— includes links to information and tutorials for monitoring and managing
your storage, including functionality for Block Persona, File Persona, Replication, Security,
Federation, Optimization, and System Reporter.
•
Administrator Console—Add, edit, connect, disconnect, and remove StoreServ systems.
Accept certificates, and view connected and disconnected systems.
More information
HPE 3PAR StoreServ Management Console Release Notes
HPE 3PAR StoreServ Management Console User Guide
HPE 3PAR StoreServ Management Console Online Help
SSMC feature summary (limited)
The following list provides a limited overview of SSMC features. For additional details, and for information about using these features, see the HPE 3PAR StoreServ Management Console
User Guide.
6
TIP:
Some SSMC features require a specific HPE 3PAR OS version. See the HPE 3PAR
StoreServ Management Console Release Notes for OS-dependent details
•
GENERAL—View storage system capacities, performance, activity, and state. View or
change schedules and global settings. Change the layout of your dashboard screen by moving, removing, and adding panels. Choose the screen you want to list in the compact version of the main menu.
•
BLOCK PERSONA—Create, edit, and delete CPGs, virtual volume sets, virtual volumes,
host sets, hosts, and virtual volume templates. Convert and tune actions for virtual volumes.
Export and unexport virtual volumes and virtual volume sets. Create, edit, delete, and promote snapshots (virtual copies) and clones (physical copies). Stop and resync clones (physical copies). Start data migration actions for virtual volumes, virtual volume sets, hosts, and host sets.
•
FILE PERSONA—Create, edit, and delete file personas, FPGs, virtual file servers, file stores,
and file shares. View static route settings in VFS view. Allows multi-select on LHS view.
View online FSCK status and FPG version in FPG view.
•
STORAGE SYSTEMS—Includes options for managing Controller Nodes, Drive Enclosures,
Federations, Physical Drives, Ports, and Systems. Detailed views include:
Controller Nodes – Short and expanded default views, so you can manage Schematics,
Adapter Cards, Power Supplies, Microcontrollers, System Fans, Internal Drives, Batteries,
Performance, Activity, and Maps.
Drive Enclosures – Pane views include Summary, Capacity Summary, SSD Summary, FC
Summary, and NL Summary, so you can manage Schematics, Magazines, Interface Cards,
Power Supplies, Cooling Fans, Physical Drives, SFPs, Activity, and Maps.
Federations – Manage peer links, recommended zones, Peer Motions, activity, maps, and
subsets of virtual volumes in a VVset. Create, edit, delete, and auto-detect federation
configurations; add, edit, or remove migration sources; synchronize Federation, import configuration, start Peer Motion. Manage Peer Motion migrations (one instance of SSMC at a time), and change the managing instance of SSMC if the current instance becomes
HPE 3PAR StoreServe Management Console (SSMC)
unavailable. Create and manage storage federations (managed by a single SSMC instance only).
Physical Drives – Pane views include Summary, Capacity, Connectivity, Error Counts, and
State, so you can manage schematics, performance, activity, and maps.
Ports – From the Summary or Error rates pane, manage schematics, settings, hosts,
sessions, performance, activity, and maps. Available actions include edit, edit label, set offline, reset port, initialize, disable interface, enable interface, clear, and reload.
Systems – Pane views include Device Type Capacity, System Capacity, Ports, Physical
Drives, Capacity, so you can manage configuration, capacity, compaction, encryption, System
Reporter, settings, services, software, licenses, layout, performance, activity, and maps.
Available actions include edit, locate, stop locate, tune, refresh snapshot efficiency, add license, enable encryption, and export. The summary view for Controller Nodes, Physical
Drives, and Drive Enclosures Includes a Safe to remove feature.
•
SYSTEM REPORTER—Short and expanded pane views include Charts, Schedules,
Summary, and Activity, so you can Create, Create multiple reports, Edit, Make private, Make public, Delete, and Reset zoom. You can also increase the size of a System Reporter volume on a storage system. The report feature provides on-node sampling with high availability. If a node failure occurs, data collection continues because the 3PAR OS automatically starts
System Reporter on a different node.
IMPORTANT:
The System Reporter “compare by” functionality is only available on systems running 3PAR OS 3.2.2 and later.
•
STORAGE OPTIMIZATION—Create, edit, enable, disable, and delete Priority Optimization
configurations. Edit, enable, and disable Adaptive Flash Cache configurations.
•
REPLICATION—Support for Remote Copy group operations: Create, edit, delete, start,
stop, sync, failover, recover, and restore; start Peer Motion actions; add Remote Copy links, remove Remote Copy links and Remote Copy groups. SSMC 2.2 and later supports 1-to-1,
N-to-1,1-to-N, and M-to-N configurations. Other remote copy configurations require the HPE
3PAR Management Console (MC) or 3PAR OS Command Line Interface. SSMC 2.3 and later supports SLD remote copy configuration and the revert failover, switch failover, and switchover group operations.
•
SECURITY—Manage StoreServ users, LDAP (including replications from one connected
storage system to another), roles, user connections, and domains.
•
VMWARE—Create and delete VMware storage containers, and view VMware virtual
machines configured for use with SSMC.
For information on the windows associated with each heading, see Main Console quick tours in HPE 3PAR StoreServ Management Console User Guide. For instructions on using these features, see HPE 3PAR StoreServ Management Console Online Help.
SSMC feature summary (limited) 7
2 SSMC compatibility and interoperability
For the most current and detailed information on supported browsers, server models, firmware, and operating systems, see SPOCK. Or see
Accessing SSMC information in SPOCK
.
Accessing SSMC information in SPOCK
1.
Log into SPOCK.
2.
In the left navigation pane of the SPOCK Home page, scroll down to Software, and then click Array Software: 3PAR.
3.
Scroll down to HPE 3PAR Operating System Software: Array Software, and then select the latest version of SSMC under HPE 3PAR StoreServ Management Console.
System requirements
Minimum system requirements include:
•
Supported 64-bit operating system (see ???
•
Core i5 dual core CPU
•
4GB of installed RAM (see
for recommended memory and core sizing)
•
2 GB free disk space
•
1366 x 768 or better screen resolution
•
Federation membership and compatibility requires the following:
◦
3PAR Operating System 3.2.2 or later
◦
Peer Motion, Storage Federation, and Online Import licenses
◦
Cabling and port configuration requirements
IMPORTANT:
A storage federation can be managed by a single SSMC instance only.
Recommended system requirements include:
•
Core i5 or i7 quad core CPU
•
8 GB RAM (see
for recommended memory and core sizing)
Guidance for server sizing:
Table 1 Server sizing information
nl
CPU cores/ system memory
2 4 8 16 32
32,000
2 cores
4 GB
2 cores
4 GB
4 cores
4 GB
8 cores
4 GB
16 cores
4 GB
64,000
2 cores
8 GB
2 cores
8 GB
4 cores
8 GB
8 cores
8 GB
16 cores
8 GB
Total # of objects
1
128,000
2 cores
16 GB
2 cores
16 GB
4 cores
16 GB
8 cores
16 GB
16 cores
16 GB
256,000+
2 cores
32 GB
2 cores
32 GB
4 cores
32 GB
8 cores
32 GB
16 cores
32 GB
8 SSMC compatibility and interoperability
1
Objects include all of the object types shown in the SSMC Main Menu
The SSMC server uses up to 65% of system RAM, which can impact other software installed on the machine. Hewlett Packard Enterprise recommends installing SSMC on a dedicated system
(not a laptop). SSMC does not support laptop power saving features.
Supported browsers for SSMC
SSMC supports the following browsers (64-bit preferred):
•
Microsoft Internet Explorer
•
Microsoft Edge
•
Google Chrome
•
Mozilla Firefox
Supported HPE 3PAR StoreServ arrays for SSMC
•
HPE 3PAR StoreServ 7000 Storage
•
HPE 3PAR StoreServ 8000 Storage
•
HPE 3PAR StoreServ 10000 Storage
•
HPE 3PAR StoreServ 20000 Storage
SSMC 2.2 and later allows you to connect and manage a maximum of 32 3PAR StoreServ
Storage arrays.
Supported HPE 3PAR Operating Systems for SSMC
•
HPE 3PAR 3.1.3 (includes all MUs)
•
HPE 3PAR 3.2.1 (includes all MUs)
•
HPE 3PAR 3.2.2 (includes all MUs)
Storage system management with SSMC and MC
You can manage supported storage systems concurrently using SSMC and MC. SSMC provides most of the MC functionality. However, until all MC features are fully integrated with SSMC, you must perform some actions using MC or the HPE 3PAR Command Line Interface (3PAR CLI).
For information about MC, see the version-specific MC user guide.
For information about the 3PAR CLI, see the HPE 3PAR OS 3.2.2 Command Line Interface
Reference and the HPE 3PAR OS 3.2.2 Command Line Interface Administrator's Manual.
More information
HPE Storage Information Library
Supported browsers for SSMC 9
SSMC and MC feature comparison
The following table describes the features supported in SSMC as compared to what was available in MC.
Category
VMware Vvol
Management
Features
Storage container management nl
Virtual machine mapping
DAR Encryption Hardware
Management
FIPS 140–2 Support
Configuring and displaying iSCSI VLAN tag support on Ports
Health Management Events
Peer Motion Data Migration
Federation
Provisioning
Data Mobility
Adaptive Optimization
Adaptive Flash Cache
MC 4.7
No
Yes
Yes
No
Yes
Yes
No
Yes
No
Remote Copy
Dynamic Optimization cMLC SSD Support
Deduplication
Yes
Yes
Yes
Compact CPG
Templates
Physical Copy (Clone)
Convert Virtual Volume
Yes
Yes
Yes
Yes
Create RC Configuration
Yes
Edit RC Configurations (add new systems)
Yes
Configure RC Port
Create RC Group
Start RC Group
Edit RC Group
Yes
Yes
Yes
Yes
Delete RC Group
Stop RC Group
Sync RC Group
Failover
Revert Failover
Recover
Restore
Yes
Yes
Yes
Yes
Yes
Yes
Yes
SSMC 3.0
Yes (NEW!)
Yes
Display only
Yes
No
Yes
Yes
Yes
Yes
(3PAR OS 3.2.1 and later)
Yes
Yes
Yes
(3PAR OS 3.2.1 MU2 and later)
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes (Virtual Volume only)
Yes
Yes
Yes
Yes
10 SSMC compatibility and interoperability
Category Features
Peer Persistence
Security & Domains Domain Management
Performance and
Reports
LDAP
NGEN: Security
AO Configurations
CPG
Physical Drives
Ports (Data)
MC 4.7
Yes
Yes
Region I/O Density
Cumulative Region
IO Density
Space Moved
Region I/O Density
Cumulative Region
IO Density
Space
Yes
Yes
Yes
PD Usage —Total
IOPS
I/O Time and Size
Distribution
Yes
Space
Performance
Statistics
Disks – Total
Throughput
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
VLUNs
Virtual Volumes
Virtual Volume Set
Domain
Controller Node
Hosts – Total
Throughput
Peers – Total
Throughput
RCFCs – Total
Throughput
RCIPs – Total
Throughput
I/O Time and Size
Distribution
Performance
Statistics
I/O Time and Size
Distribution
Performance
Statistics
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Space
QoS
QoS
CPU Performance
Yes
Yes
Yes
Yes
Cache Performance
Yes
Storage system management with SSMC and MC 11
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
SSMC 3.0
Yes
Yes
Yes
No
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Category
Custom Charts
Features
Logical Drives I/O Time and Size
Distribution
Space
Performance
Statistics
Physical Drives
Logical Drives
Virtual Volumes
VLUNs
Ports (Data)
Ports (Control) iSCSI iSCSI Session
CMP Node
Virtual Volume Cache (was CMP VV)
CPUs
Remote Copy Link
Remote Copy VV
FCOE
QoS
Node links
MC 4.7
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
SSMC 3.0
No
No
No
Yes
No
Yes
Yes
Yes
Yes
Yes
Yes (New!!)
Yes
Yes (New!!)
Yes
Yes
Yes
Yes (New!!)
Yes
Yes
12 SSMC compatibility and interoperability
3 SSMC deployment model
SSMC is server based, meaning that the SSMC server runs continuously to monitor storage arrays. Users log into the SSMC Server with their web browser to view management data.
Management tools for the StoreServ arrays, like SSMC, must open network sessions with the arrays to monitor activity and provide management functions. This means that SSMC opens multiple network sessions from each instance of the management server to each array that it manages. Even after a user closes the browser session, the SSMC server continues to monitor the arrays, which means it holds connections to the arrays open in order to gather data.
Do not install SSMC on individual desktop or laptop systems. Install SSMC on a single server instance only, with desktop and laptop clients connecting to the server using the SSMC web interface.
The default URL for communicating with the SSMC server is https://SSMC.SERVER.COM:8443.
You can configure this port after you complete the SSMC installation (see
).
SSMC also has a screen that lets the user manage the connections to the array. Users can access this screen from the SSMC Security menu under Connections.
See the HPE 3PAR StoreServ Management Console User Guide for additional information.
More information
Hewlett Packard Enterprise Information Library
13
4 Federation requirements for SSMC
Federation systems and migration sources used with SSMC must meet the following requirements:
•
Federation systems require:
◦
Two ports configured in peer mode (must be from partner nodes, and do not require identical slot and port numbers). Used exclusively for inter-system communication and data transfer, and cannot be used for host I/O.
◦
Ports cabled to the fabric switch and in ready state (requires 3PAR OS 3.2.2 or later).
•
Migration sources for a federation require:
◦
Two ports configured in host mode or free (must be from partner nodes and do not require identical slot and port numbers).
◦
Ports cabled to the fabric switch and in ready state.
14 Federation requirements for SSMC
5 Security settings for SSMC
SSMC requires specific ports for communication. Hewlett Packard Enterprise also recommends configuring an LDAP server as an authentication method for connecting to a 3PAR StoreServ array.
Inbound and outbound port settings
To allow inbound communication from a browser, SSMC uses inbound port 8443 (default). You can change this port to another secured port setting without reinstalling SSMC (see
Changing the default SSMC inbound port
).
To communicate with an array, SSMC uses outbound port 5783. You cannot change this port.
SSMC also uses port 443 to communicate with Hewlett Packard Enterprise StoreFront Remote and retrieve version information about SSMC and the HPE 3PAR operating system.
For the most current port information, see the Site Planning Guide for your platform, available from the HPE Storage Information Library.
LDAP settings
The LDAP server is an authentication method for connecting to the 3PAR StoreServ Storage
System array (see LDAP Authentication Best Practices). For configuration information, see
Changing the default SSMC inbound port
After installing SSMC, you can change the inbound port between the client browser and the
SSMC server without reinstalling SSMC.
1.
Shut down the SSMC server:
Windows command: sc stop ssmc
Linux command: service ssmc stop
2.
Edit the jetty-ssl.xml file:
Windows location: C:\Program Files\Hewlett Packard Enterprise
Enterprise\SSMC\ssmcbase\etc\jetty-ssl.xml
Linux location: /opt/hpe/ssmc/ssmcbase/etc/jetty-ssl.xml
3.
Locate the following line in the file, and then specify the new port number, default=”port_number”
:
Windows location: <Set name="port"><Property default="8443"
deprecated="ssl.port" name="jetty.ssl.port"/></Set>
Linux location: <Set name="port"><Property name="jetty.ssl.port"
deprecated="ssl.port" default="8443" /></Set>
4.
Save the file, and then restart the service.
Windows command: sc start ssmc
Linux command: service ssmc start
IMPORTANT:
In Windows, if you are using the desktop shortcut to open SSMC, you must also change the port number in the Web Document tab of the Properties dialog box. The format is https://<localhost>:<port number>/.
Changing the default SSMC inbound port 15
Setting up LDAP using the HPE 3PAR CLI
1.
Set the LDAP service account fields: setauthparam -f ldap-service-account <account_name> setauthparam -f ldap-servce-account-password <password>
2.
Set the cert field and object attribute fields: setauthparam -f ldap-2FA-cert-field <value> setauthparam -f ldap-2FA-object-attr <value>
More information
LDAP Authentication Best Practices
16 Security settings for SSMC
6 Installing SSMC
SSMC is available for various Windows and Linux environments, and includes silent install options for both. For information on downloading the SSMC installation package, see Hewlett Packard
Enterprise Software Depot. SSMC does not support remote installation, installation using a symbolic link, or other installation methods.
IMPORTANT:
If you are upgrading from an earlier version of SSMC, the upgrade process overwrites the CA certificate. If you have imported a CA certificate to replace the SSMC self-signed certificate, you must import your CA certificate again. See the HPE 3PAR StoreServ Management
Console Administrator's Guide for instructions.
For information about configuring and using SSMC, see HPE 3PAR StoreServ Management
Console 3.0 Administrator Guide.
Prerequisites
•
Configure security settings (ports and LDAP) (see
Security settings for SSMC (page 15) )
on the server where you will install SSMC
•
Make sure all Federated systems and migration sources meet the requirements for Federation
(see
Federation requirements for SSMC (page 14) ).
Installing SSMC in a Windows environment
IMPORTANT:
Hewlett Packard Enterprise does not ship installation CDs with the system. If you selected the LTU (License to Use) as the physical delivery method when ordering your system, use the installation media that shipped at the time of your order. If you selected electronic delivery, see the Hewlett Packard Enterprise e-Software Delivery Confirmation email for detailed instructions.
To install SSMC in a Windows environment:
1.
Double-click the setup file to start the installation wizard.
2.
If prompted, select your preferred language. Otherwise, read the Introduction screen, and then click Next.
3.
Accept the License Agreement, and then click Next.
TIP:
If you are reinstalling or upgrading SSMC and you did not remove existing data, the system prompts you to keep or remove this information. Select Yes to keep pre-existing data. Select No to remove all previous SSMC data.
4.
Select a destination folder for the installation or accept the default folder (recommended), and then click Next.
5.
Enter the secure TCP port number that the browser uses to access SSMC, or keep the default port 8443 (recommended), and then click Next. [add link to changing port]
The summary screen displays the settings you selected and the amount of disk space required for the installation.
6.
To accept these settings and continue with the installation, click Install. To change these settings, click Previous until you see the screen containing the settings you want to change.
If the system does not meet the minimum installation requirements, the installer displays an error message. For information on error messages, see
“Windows installation issues for
.
The Installing... screen displays the progress of the installation.
Prerequisites 17
When the installation is complete, the system displays the following message:
If you are using a firewall to protect this system, please ensure that the inbound SSMC TCP port 8443 is accessible from an outside system.
7.
Click Next to complete the installation.
8.
Click Done to exit the installation wizard.
Using the SSMC silent install option with Windows
Use default settings
1.
Open a command prompt window.
2.
Run the installer with the -i silent option
Use non-default settings
1.
Open a command prompt window.
2.
Generate a response file by running the installer with the -r <response file> option.
3.
Run the installer using the -i silent -f <response file> option.
Installing in a Linux environment
Prerequisites
Because SSMC requires the use of libraries not found in the headless version of Linux, be sure that you have the headfull version installed for your environment.
Procedure
1.
As superuser, execute the following command to start the installation: sh HPESSMC-<version number>-linux-x86_64.bin.HPb
OR
You can change the file permissions and start the installation with the following commands: chmod 775 HPESSMC-<version number>-linux-x86_64.bin.HPb
./HPESSMC-<version number>-linux-x86_64.bin.HPb
2.
Enter Yes to accept the displayed End User License Agreement (EULA).
3.
Enter the secure TCP port number the browser uses to access SSMC, or press the Enter key to accept the default port 8443 (recommended).
The summary message displays the settings you selected, plus the amount of disk space required for installation.
If the system does not meet the minimum installation requirements, the installer displays an error message. For information on error messages, see
“Linux installation issues for SSMC” (page 41) .
Using the silent install option in Linux
1.
Extract the files from the bin.HPb package using the Linux command: sh HPESSMC-<version number>-linux-x86_64.bin.HPb --tar xvf
This extracts the file hpessmc-<version number>-x86_64.rpm.
2.
Execute the following Linux commands to install the product: chmod 775 hpessmc-<version number>-x86_64.rpm
rpm –i hpessmc-<version number>-x86_64.rpm
18 Installing SSMC
If you want to change the default secure port, you must do so manually after the installation.
3.
Once installed, enter the Linux command to start the service: service ssmc start
Installing in a Linux environment 19
7 Configuring SSMC
Process overview:
1.
2.
Setting the SSMC Administrator credentials (page 20)
3.
Adding storage systems to SSMC (page 22)
4.
Connecting to SSMC managed systems from the Administrator Console (page 23)
More information
CA certificates in SSMC (page 26)
Accessing SSMC
Use one of the following methods to access SSMC.
From the system on which it is installed
•
Windows: Double-click the SSMC program icon on your desktop. Your browser opens to the URL https://<localhost>:<port_number>.
•
Linux: Open your browser, and then enter the following location in the address bar using port number 8443, or the secure port number you entered during installation: https://<localhost>:<port_number>
.
From a remote system
To access SSMC from a remote system, open a supported browser and enter https://<server name or IP>:<port_number>
.
TIP:
If your browser displays a message indicating a problem with the website security certificate, you can safely continue to the website. To remove the windows message, see
“CA certificates in SSMC” (page 26)
.
Setting the SSMC Administrator credentials
The first time you open SSMC after installation, the system prompts you to set up the user name and password for the administrator account in SSMC. This account provides access to the SSMC
Administrator Console only.
1.
Access the newly installed SSMC (see
).
20 Configuring SSMC
2.
At the system prompt, click Set credential.
3.
In the Set Administrator Credential dialog, enter the user name for the administrator account.
User names must be at least two characters long and contain no spaces. You can use any characters, including UTF-8.
4.
Enter the password for the account. Passwords must be 8 to 32 characters and contain at least one uppercase character, one lowercase character, one digit, and one nonalphanumeric character.
5.
Enter the password again to confirm.
6.
Click Set.
After setting the administrator credential, you must log in to the Administrator Console and add a 3PAR StoreServ Storage System before you can continue.
Logging in to the Administrator Console
1.
Access SSMC (see
).
•
If this is the first time you have logged in to SSMC, select Administrator Console in the dialog box that appears.
•
For subsequent log in to the Administrator Console, select the Administrator Console check box on the SSMC login screen.
•
For subsequent log in to the Main Console, make sure the check box for Administrator
Console is unchecked.
Logging in to the Administrator Console 21
2.
Enter the SSMC administrator user name and password.
3.
Click Login.
•
The Administrator Console displays in a new browser window.
•
The first time you attempt to display the Administrator Console, your browser might issue a warning that pop up windows from the host (SSMC server) are not allowed. In most cases, you can click the warning icon to enable pop-up windows.
Adding storage systems to SSMC
1.
From the Administrator Console, select Actions, and then click Add.
2.
In the Add Storage Systems dialog box, enter the DNS names or IP addresses of the storage systems to add, separated by commas or spaces. (Or you can press Enter key on the keyboard after each system name or IP address.)
•
If you want to add multiple storage systems at the same time, they must have the same credentials.
•
You can add up to 32 3PAR StoreServ Storage System for each SSMC server.
3.
Enter the credentials for the storage systems.
4.
To connect to the storage systems immediately, select the Connect to the systems check box.
If you do not select this check box, you can connect after you add a system by selecting the storage system, and then selecting Actions—>Connect.
5.
Click Add.
22 Configuring SSMC
6.
If the value in State Description indicates that certificate acceptance is required, select that storage system, and then select Actions—>Accept certificate (see
CA-signed array certificates” (page 29)
).
After making the connection to the storage system, the Connection State column in the detail panel displays a green icon and the text Connected.
7.
To add a storage array that uses different login credentials, repeat steps 1 through 6.
8.
When you have finished adding storage systems, click Close to return to the SSMC login screen.
To manage storage systems that have the same credentials, clear the Administrator Console check box on the SSMC login screen, and then enter the credentials for accessing the storage systems.
Connecting to SSMC managed systems from the Administrator Console
1.
Log in to the SSMC Administrator Console on the SSMC server, and then select the storage system to which you want to connect.
2.
Select Actions—>Connect.
3.
In the Connect dialog, click Connect.
After the connection is made to the storage system, the Connection State column displays the text Connected and the State Description column displays the text Connection established.
SSMC directories for backup
SSMC stores reports and other data in the following directory:
C:\Program Files\Hewlett Packard Enterprise\SSMC\ssmcbase\data
This directory also maps to the hidden directory:
C:\ProgramData\Hewlett Packard Enterprise\SSMC\data
Backup one of these directory paths as part of your regular backup schedule. Contact Hewlett
Packard Enterprise Support if you need to recover a backup for SSMC.
Connecting to SSMC managed systems from the Administrator Console 23
8 HPE 3PAR Excel add-in for System Reporter in SSMC
The 3PAR Excel add-in provides the ability to extract and report data from the HPE 3PAR
StoreServe Management Console RESTful API to Microsoft Excel. The add-in extracts data using SSMC. For currently supported versions of Microsoft Excel, see SPOCK.
Installing the 3PAR Excel add-in for SSMC
Prerequisites
Requires Microsoft .Net Framework 4.5 or later.
IMPORTANT:
If you do not have Microsoft .Net Framework installed on your system, the 3PAR
Excel add-in installation installs it for you, and might require a reboot.
After installing the 3PAR Excel add-in, when you open Microsoft Excel the program might perform some internal configuration that requires a reboot.
For more information on installing Microsoft add-in programs, see the Microsoft Support website.
Install the add-in
1.
Locate the HP 3PAR SSMC Excel client installer SW in Software Depot. Follow the instructions to copy the installer software to a CD ROM. You can also use any ISO mounter software to install the 3PAR Excel add-in.
2.
Save and close any Microsoft Excel windows, and then close the program.
3.
On the client system, run HPESSMCSRExcelAddin.exe and follow the instructions.
The 3PAR Excel add-in installs to the default path C:\Program Files\Hewlett Packard
Enterprise\HPE3PARSRExcelAddin
, or to C:\Program Files (x86)\Hewlett
Packard Enterprise\HPE3PARSRExcelAddin
.
Using the 3PAR Excel Add-in
1.
Launch Microsoft Excel.
2.
Select the System Reporter tab.
3.
Enter the SSMC Server name and port, and then enter the username and password (3PAR
StoreServ Storage System credentials).
4.
Click Connect to SSMC.
TIP:
When you generate performance data, scroll to the top left of the Excel spreadsheet to view the CSV data.
Date formats for created reports
The 3PAR Excel add-in uses the following date formats to plot reports:
•
HIRES—mm/dd/yyyy hh:mm
•
HOURLY—mm/dd/yyyy hh:mm
•
DAILY—mm/dd/yyyy
Users can change the date format found in the Time Stamp column using the Format Cells option in Microsoft Excel.
24 HPE 3PAR Excel add-in for System Reporter in SSMC
Uninstalling the 3PAR Excel add-in
1.
In Windows, navigate to Programs and Features.
2.
Select HPE 3PAR SSMC System Reporter Excel Add-in from the list of installed programs, and then click Uninstall.
Troubleshooting the 3PAR Excel add-in
Link to add-in does not appear in Microsoft Excel.
Symptom
After installing the 3PAR Excel add-in, the add-in does not appear in Microsoft Excel.
Cause
Disabled add-ins in Microsoft Excel.
Action
If you do not see the 3PAR Excel add-in in the list under ADD-INS in Microsoft Excel, use the following steps to enable the add-in:
1.
Click File in In Microsoft Excel, and then click Options.
2.
Click Add-Ins.
3.
Select Disabled Items in the Manage box at the bottom of the page, and then click GO.
4.
Select Add-In (SR Excel Addin), and then click Enable.
5.
Click OK, and then close and reopen Excel.
Time stamps are incorrect, showing a different time zone
Symptom
Time stamps are incorrect.
Cause
When the storage system and SSMC are in different time zones, the data is shown correctly, but the time stamps are not correct.
Action
None.
Cannot establish a connection using the Excel Add-in
Symptom
Unable to establish a connection to the SSMC server from the Excel Add-in.
Cause
After you connect to the SSMC server from the Excel Add-in, if you change user, password, or
SSMC server to reconnect, you cannot establish a connection.
Action
Restart the Excel Add-in.
Uninstalling the 3PAR Excel add-in 25
9 CA certificates in SSMC
SSMC uses two types of CA certificates. One is a CA-signed browser certificate (see
Creating an SSMC CA-signed browser certificate for SSMC (page 26) , which validates a connection
between SSMC and the corporate network. By default, SSMC uses a self-signed certificates, which cause security warnings in the browser. Replacing the SSMC self-signed certificate with a CA-signed certificate eliminates the browser warnings.
The other is a CA-signed array certificate (see,
Managing CA-signed array certificates for SSMC
(page 29) ), which validates a connection between an SSMC server and a 3PAR array. Each
array has its own certificate that must be managed separately. However, if your certificates have a common CA authority chain, you can import the authority chain into SSMC one time for all arrays. For more information about certificate authority chains, see the Oracle website for keytool or the openssl website.
Although there are many methods available for managing CA certificates, Hewlett Packard
Enterprise addresses only Java keytool and openssl.
TIP:
When editing system files, use a text editor such as Notepad or VI. Do not use document editors such as Wordpad or MS Word. The latter can append program-specific information to the file, which can make the file unreadable for its original purpose.
Managing CA-signed certificates for SSMC
Prerequisites
Before you edit the text files associated with CA certificates, make sure you have reviewed the following best practices and documentation:
•
Review Keytool – Key and certificate management tool
•
Review Jetty how to for configuring SSL
•
Review Jetty how to for secure passwords
Process overview
1.
Creating an SSMC CA-signed browser certificate for SSMC (page 26)
2.
Managing CA-signed array certificates for SSMC (page 29)
Creating an SSMC CA-signed browser certificate for SSMC
Creating an SSMC CA-signed browser certificate using Java keytool
By default, SSMC uses a self-signed certificate, which causes security warnings in the browser.
Replacing the SSMC self-signed certificate with a CA-signed certificate eliminates the browser warnings.
Prerequisites
•
The following procedure uses Java keytool to manage public and private keys. keytool is located in C:\Program Files\Hewlett Packard Enterprise\SSMC\jre\bin. Add
26 CA certificates in SSMC
this directory to the path or prepend the keytool commands used in the procedure with the path.
•
Gather the appropriate security information for CA certificates at your site. These include the fully qualified domain name (accessible through DNS), your organization name, organization unit, and the City, State, and Country.
•
Understand who the certificate authorities are for your organization, and where to send a certificate authority request.
More information
http://docs.oracle.com/javase/7/docs/technotes/tools/windows/keytool.html
Create a keytool certificate
1.
From a server with SSMC loaded, running, and connected to the local network, navigate to
C:\Program Files\Hewlett Packard Enterprise\SSMC\ssmcbase\etc\
, and then rename keystore. to keystore.original.
2.
Use keytool to create a new public/private key pair in a new keystore file: keytool -genkeypair -keystore keystore. -alias jetty -keyalg RSA
3.
At the prompt, enter the security information you gathered earlier (see Prerequisites).
Be sure to enter this information correctly for your organization. The output should look similar to the following:
CN=<FQDN.net>, OU=<unit_name>, O=<company_name>, L=<city>,
ST=<state>, C=<country>
4.
Generate a certificate signing request (CSR): keytool -certreq -keystore keystore. -alias jetty -file
<certificate.request.txt>
5.
Send the complete output (nclude the BEGIN and END lines) from the request to the
Certificate Authority for your organization.
This could be an email, or it could be a web form.
This should generate an email or web server content that contains the signed certificate detail.
6.
Copy and paste the signed certificate details to the folder in which the keystore resides.
7.
Add all certificates to the same keystore in this order:
1.
The trusted root certificate (alias is not jetty here): keytool -import -alias root -keystore keystore -trustcacerts
-file <CA.cert.txt>
2.
Any intermediate certificates (same command as above without –alias): keytool -import -keystore keystore -trustcacerts -file
<cert_name.txt>
3.
The CA signed certificate (alias is jetty here): keytool -import -alias jetty -keystore keystore -trustcacerts
-file <cert_name.txt>
All certificates must reside in the same keystore.
Managing CA-signed certificates for SSMC 27
8.
Update C:\Program Files\Hewlett Packard
Enterprise\SSMC\ssmcbase\etc\jetty-ssl.xml
with the passwords used by the new keystore:
•
If you changed the default password to the keystore as a whole, modify the
KeyStorePassword entry.
•
If you changed the password to the private key inside the keystore, change the
KeyManagerPassword.
•
You can find the jetty-util-<version>.jar file in C:\Program Files\Hewlett
Packard Enterprise\SSMC\jetty\lib
.
provides an example of the jetty-ssl.xml file configuration with password instructions
See Jetty HowTo for more details.
Figure 1 jetty-ssl.xml file example
9.
Restart the 3PAR StoreServ Management Console Server service.
10. Import the root certificate of the Certificate Authority into the Trusted Root Certificate Store in the browser and browse to SSMC.
The previous instructions are for SSMC installed on Windows but apply in general to Linux as well.
IMPORTANT:
Repeat this process each time you update or install SSMC.
Backing up a CA-signed browser certificate
1.
Navigate to C:\Program Files\Hewlett Packard
Enterprise\SSMC\ssmcbase\etc\
2.
Copy the keystore files and, if it exists, the truststore files to a temporary directory outside of the SSMC directory structure.
Restoring a CA-signed browser certificate from backup
1.
Stop the SSMC service.
2.
Navigate to C:\Program Files\Hewlett Packard
Enterprise\SSMC\ssmcbase\etc\
.
3.
Copy the contents from the saved backup directory to this directory (see
).
4.
Start the SSMC service.
Creating an SSMC CA-signed browser certificate using a non-keytool method
If your environment uses methods other than keytool, such as openssl, use the following procedure:
1.
Generate a private key and public certificate using tools and options appropriate for your security environment. For example:
28 CA certificates in SSMC
a.
openssl gensra –out private.key 2048
b.
openssl req –new –sha256 –key private.key –out csr.txt
c.
Send csr.txt to the CA to have it signed.
The expected result is a file containing the public certificate containing the phrase
-----BEGIN CERTIFICATE-----
.
The file contains:
•
A private key in a file named something like private.key.
•
A public certificate (built using the private key) in a file named something like public.cer
.
2.
Import the private.key and public.cer files into the keystore as follows:
a.
Delete the existing SSMC keystore (not used).
b.
At the prompt, enter each of the following commands: openssl pkcs12 –inkey private.key –in public.cer –export –out jetty.pkcs12
keytool –list –keystore jetty.pkcs12 –storetype PKCS12
Look for an entry with an alias (possibly “1”).
c.
Enter the following command. Use the alias created in the previous step: keytool -importkeystore -srckeystore jetty.pkcs12 -srcstoretype
PKCS12 -destkeystore keystore -destalias jetty -srcalias 1
Managing CA-signed array certificates for SSMC
The purpose of this certificate is to prove the identity of the SSMC server to the 3PAR OS. You can create this certificate in any way that satisfies your internal CA requirements, as long as you set the SSL Client purpose flag.
Installing SSMC CA-signed array certificates
1.
Copy the CA certificates (root CA and intermediate CA or CA authority chain) to the following directory on the SSMC server:
Windows
C:\Program Files\Hewlett Packard
Enterprise\SSMC\ssmcbase\data\StoreServMC\security
Linux
/opt/hpe/ssmc/ssmcbase/data/StoreServMC/security
2.
Select the storage system that requires CA certificate installation.
3.
Select Actions, and then click Connect.
4.
Select Actions, and then click Accept certificate.
More information
“Accepting SSMC CA-signed array certificates” .
Accepting SSMC CA-signed array certificates
The first time you attempt to connect to a storage system that has a CA signed certificate (or, if the certificate has been changed to CA signed since the last login), the system requires that you accept the certificate.
IMPORTANT:
Only users with the Super, Browse, or Edit role can accept a certificate.
Managing CA-signed array certificates for SSMC 29
1.
Log in to SSMC as a user with Super, Browse, or Edit roles.
Select the storage system that requires certificate acceptance.
2.
Select Actions—>Accept certificate.
3.
(Optional) To view certificate details, expand Certificate details for <system>.
4.
Click Accept and cache.
NOTE:
If the certificate is expired, you must renew the certificate to connect to the storage system.
30 CA certificates in SSMC
10 Using SSMC
Best practices for SSMC performance
•
Limit bulk operations to 100 objects at a time.
SSMC allows you to perform some operations on multiple objects at the same time, either by selecting multiple objects from a table, or by choosing them within a dialog. Performing actions on large numbers of objects in parallel requires SSMC to gather more data and issue more commands to the storage arrays, which can lead to timeout errors or disconnect messages.
•
Use Chrome or Firefox for the best performance.
SSMC supports both Internet Explorer 11 and Microsoft Edge, but users sometimes experience unacceptable performance in larger configurations when using these browsers.
•
Use a mouse instead of the keyboard arrow keys when navigating through a table.
Each press of an up or down arrow key causes SSMC to select a new item in the table, and then fetch the full set of properties for that item. Pressing an arrow key a number times in quick succession creates a corresponding number of property requests. On large or heavily loaded configurations, this can lead to timeout errors or UI disconnects.
•
Filter the list of systems to those you are using.
Use the System selector to filter the list of systems to show only the systems you are working with. In large environments this can significantly reduce the object count, which makes SSMC more responsive.
•
Follow the memory and CPU guidelines in the System Requirements section.
SSMC installs on virtually any supported operating system. However, installing SSMC on an operating system that does not meet the recommendations can result in unacceptable performance or responsiveness.
•
Limit the number of Scheduled Reports to be executed concurrently to 50.
•
Use filters for real time reports, rather than All objects.
When creating Volume-related (Exported volume, Virtual volume or Virtual volume cache)
Real time reports, use filters to choose specific objects rather than selecting All objects.
Changing the SSMC administrator account password
1.
Log in to the Administrator Console.
2.
Click the Session icon in the main menu.
3.
Click Change credential.
4.
Enter the current password for the displayed name.
5.
Enter the new password.
6.
Enter the confirm password.
7.
Click Change.
If you forget the Administrator credentials, clear the password by executing the script
ClearAdminCredential.bat
located in the SSMC\ssmcbase folder. Run the script from an administrator command prompt window.
Logging out of the SSMC Administrator Console
1.
Click the Session icon in the main menu, and then click Logout and close.
Best practices for SSMC performance 31
2.
In the Logout confirmation dialog, click Yes, or click the X in the upper-right corner of the window to return to the login screen.
Disconnecting SSMC managed systems
Disconnecting a managed system terminates its connection to the network. It does not remove the system from the list of systems managed through SSMC. Disconnecting a system allows you to reestablish a connection later without having to add the system again. For information on removing a managed system, see
“Removing SSMC managed systems” (page 32)
.
To disconnect a managed system:
1.
From the SSMC Administrators console, select the system you want to disconnect.
2.
Select Actions, and then click Disconnect.
3.
Click Disconnect in the Disconnect dialog.
4.
Click Yes, disconnect in the Disconnect confirmation dialog box.
After disconnecting the system, the Connection State column displays the text Not Connected and the State Description column displays the text User disconnected.
Removing SSMC managed systems
Removing a managed system disconnects and then removes it from the list of systems managed through SSMC. To manage that storage system again, you must add it as described in
“Adding storage systems to SSMC” (page 22)
.
To remove a managed system:
1.
From the SSMC Administrators Console, select the storage system you want to remove.
2.
Select Actions, and then click Remove.
3.
Click Remove in the Remove dialog.
4.
Click Yes, remove in the Remove confirmation dialog.
After removing the storage system, it no longer appears in the list of managed systems.
Switching from the Admin console to the Main console
1.
While logged in to the Main Console, click the Session icon in the main menu.
2.
Click Administrator Console.
The Administrator Console login dialog box is displayed in a new browser window.
3.
To log out and close the window, click Logout and close.
4.
When the Logout confirmation appears, click Yes or click the X in the upper-right corner of the window to return to the login screen.
Using the SSMC Main console dashboard and tutorials
1.
Access the SSMC Main console:
•
If you are already connected to the SSMC Administrator console,
•
If you are not connected to SSMC, browse to the server that has the SSMC software installed: https://<IP address or FQDN>:<secure_port>
The login screen opens.
2.
Log in to the management console:
a.
Enter your 3PAR account user name and password as shown in
.
32 Using SSMC
Figure 2 SSMC login screen b.
To access the Main console, make sure that the check box next to Administrator Console is unchecked (default).
c.
Click Login.
TIP:
If this is your first login to the Main console, a navigation tutorial automatically starts. You can click Next to navigate manually through the tutorial, click Play to run the tutorial automatically, or click Close to view the tutorial at a later time.
3.
To open the Help window from any location within the management console, click the question mark (?) in the upper right corner of the dashboard window.
Using the SSMC Main console dashboard and tutorials 33
Figure 3 Access help in the management console
•
To run the tutorials, click either Navigation tutorial or Provisioning tutorial.
•
For context-sensitive help on this or any page, click Help on this page.
For more information about the management console and the available help features, see the
HPE 3PAR StoreServ Management Console User Guide, available from the HPE Storage
Information Library.
Troubleshooting SSMC user issues
The SSMC browser session doesn’t time out.
Symptom
If users leave the SSMC browser session open, the SSMC session remains active (106123)
Action
When you have finished using your browser session, be sure to close the browser manually.
UI response is slow
Symptom
Sluggish UI response with Internet Explorer 11 and Microsft Edge browsers.
Cause
In large or busy configurations, SSMC responsiveness can be unacceptably slow when using
Internet Explorer 11 or the Microsoft Edge browser.
Action
To work around this issue, use the latest versions of the Chrome or Firefox browsers.
34 Using SSMC
11 Uninstalling SSMC
IMPORTANT:
SSMC does not support remote uninstall, or any uninstall methods other than those described in the current HPE 3PAR StoreServ Management Console Administrator’s Guide.
Uninstalling SSMC in a Windows 7 or Windows Server 2008 environment
1.
Select Start, and then click Control Panel. If you are viewing by small Icons, click Programs
and Features. If your view is by category, click Uninstall a Program under the Programs
group.
2.
Right-click HPE 3PAR StoreServ Management Console Server, then select
Uninstall/Change.
•
To keep existing data when uninstalling SSMC, select Do not remove the data.
•
To delete all stored data in addition to uninstalling SSMC, select Remove all the data.
This removes all reports and associated schedules.
Uninstalling SSMC in a Windows 8, Windows 10, or Windows Server
2012 environment
1.
Hover the cursor over the bottom left of the screen to display the Start Menu, and then right-click Start.
2.
Click Programs and Features.
3.
Right-click HPE 3PAR StoreServ Management Console Server, then select
Uninstall/Change.
•
To keep existing data when uninstalling SSMC, select Do not remove the data.
•
To delete all stored data in addition to uninstalling SSMC, select Remove all the data.
Uninstalling SSMC manually in a Windows environment
If you are unable to uninstall the product using the standard procedure, you can uninstall it using the following commands.
1.
At an administrator command prompt (assumes the product was installed using the defaults), enter each of the commands as shown in the following example:
Example 1 Manual uninstall for Windows
Use double quotes for paths with spaces in them.
sc stop ssmc sc delete ssmc del /S /Q /F "C:\Program Files\Hewlett Packard Enterprise\SSMC" rmdir /S /Q "C:\Program Files\Hewlett Packard Enterprise\SSMC" del /S /Q /F "C:\ProgramData\Hewlett Packard Enterprise\SSMC" rmdir /S /Q "C:\ProgramData\Hewlett Packard Enterprise\" net user
hpe3parssmcuser /delete
2.
Remove the SSMC entry from the Zero G Registry. The Zero G Registry can be found at
C:\Program Files\Zero G Registry\.com.zerog.registry.xml
. If SSMC is the only InstallAnywhere application installed, you can delete the entire “Zero G Registry” folder.
Uninstalling SSMC in a Windows 7 or Windows Server 2008 environment 35
TIP:
If the uninstall entry still exists in the Control Panel Programs and Features applet, you can remove the entry by trying to uninstall the product using the applet. This produces an error similar to the following:
An error occurred while trying to uninstall HPE 3PAR StoreServ Management
Console Server. It may have already been uninstalled.
Would you like to remove HPE 3PAR StoreServ Management Console Server from the Programs and Features list?
Click Yes to remove the entry.
Uninstalling SSMC in a Red Hat Enterprise Linux environment
1.
Log in as a super user.
2.
Run the following script: /opt/hpe/ssmc/uninstall.sh
Uninstalling SSMC manually in a Red Hat Enterprise Linux environment
If you are unable to uninstall the product using the /opt/hp/ssmc/uninstall.sh script, execute the following commands manually to remove the product:
Example 2 Manual uninstall for Linux
service ssmc stop rm -f /etc/rc.d/rc2.d/S20ssmc rm -f /etc/rc.d/rc1.d/K20ssmc rm -f /etc/rc.d/rc0.d/K20ssmc rm -f /etc/rc.d/rc3.d/S20ssmc rm -f /etc/rc.d/rc5.d/S20ssmc rm -f /etc/rc.d/init.d/ssmc rm -f /etc/rc.d/rc6.d/K20ssmc rm -f /etc/rc.d/rc4.d/S20ssmc rm -fr /var/opt/hpe/ssmc rm -fr /opt/hpe/ssmc userdel hpe3parssmcuser rm -fr /home/hpe3parssmcuser rm -fr /var/mail/hpe3parssmcuser
36 Uninstalling SSMC
12 Troubleshooting for SSMC installation and configuration
This chapter provides troubleshooting information for installation and configuration issues and describes the log files.
When you are logged in to SSMC, the Activity pane displays activity for the current session. A green icon preceding an activity indicates that the activity completed successfully. A yellow or red icon preceding an activity indicates an error.
Windows installation issues for SSMC
The following sections describe error messages you might encounter when attempting to install the SSMC server.
On startup, SSMC appears to block access to other programs, such as gmail
Symptom
Unable to launch gmail or other services at system boot.
Cause
With the fast boot feature enabled, Windows does not shut down, it hibernates, causing SSMC to jump forward in time at system restart.
Action
If you are using SSMC on a laptop, you must turn off the fast startup option in Windows.
1.
Access the Control Panel In Windows.
2.
Go to Power Options > System Settings > Shutdown Settings.
3.
Clear the check mark in the box next to Turn on fast startup.
Insufficient Privileges
Symptom
Error message
Cause
You must have administrator privileges before you can install the product.
Action
Make sure that a user with the required administrator privileges installs the product.
Detected Uninstaller Running
Symptom
Error message
Cause
The installer has detected that the uninstaller is running.
Action
Finish the uninstall process before installing the product. Rerun the installer when you have completed the uninstall process.
Windows installation issues for SSMC 37
Detected Multiple Instances of Installer
Symptom
Error message
Cause
The installer detected that the 3PAR StoreServ Management Console Server you are trying to install is already installed on the machine.
Action
Cancel additional instances of the installer.
If there are no additional instances running, you might need to delete the lock files. For example:
C:\Users\<logonUser>\AppData\Local\Temp\
<ad540182-1f13-11b2-8c51-9c2bf64fc32>-install
C:\Users\<logonUser>\AppData\Local\Temp\
<ad540182-1f13-11b2-8c51-9c2bf64fc32>-uninstall
Detected 3PAR StoreServ Management Console Server
Symptom
Error message
Cause
The installer detected that a version of the 3PAR StoreServ Management Console Server is already installed on the machine.
Action
Click OK to remove the installed product before installing, or click Cancel to terminate the current installation.
Detected 3PAR StoreServ Management Console Server service
Symptom
Error message
Cause
The 3PAR StoreServ Management Console Server service still exists.
Action
Make sure the previous version of 3PAR StoreServ Management Console Server has been uninstalled and the service has been removed. Then try a reboot and rerun the installer.
If you still receive this error after rebooting, enter the following command from a Command Prompt window to delete the service from the Windows registry: sc delete ssmc
Invalid Secure Port Value
Symptom
Error message
Cause
The secure port number is out of range or is a non-numeric value.
38 Troubleshooting for SSMC installation and configuration
Action
Enter a value between 1024 and 65002.
Port Is Already in Use
Symptom
Error message
Cause
The port entered for the secure port is not available.
Action
Enter an available port number between 1024 and 65002.
Password contains unacceptable characters
Symptom
Error message
Cause
Provided password contains unacceptable characters.
Action
Provide a password that does not contain the following characters: spaces, percent (%), dollar
($), double quote ("), or caret (^).
Unable to create hpe3parssmcuser
Symptom
Error message
Cause
There was an error trying to add the user hpe3parssmcuser .
Action
Depends on the error. See your administrator for more information.
Not running 64-bit OS
Symptom
Error message
Cause
The software detected a non 64–bit operating system.
Action
Occurs only when attempting to install on a 32–bit machine. Install on a supported 64–bit operating system.
Windows installation issues for SSMC 39
Recommended Operating System Not Met
Symptom
Error message
Cause
The software detected a nonsupported operating system.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system.
Recommended Minimum Processors Requirement Not Met
Symptom
Error message
Cause
Detected fewer than the minimum number of processors required for installation.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system with a minimum of two logical processors.
Recommended Operating System Not Met
Symptom
Error message
Cause
The software detected a nonsupported operating system.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system.
Recommended Minimum Free Disk Space Requirement Not Met
Symptom
Error message
Cause
The amount of free space detected was less than the recommended amount.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system with a minimum of 2 GB of free space.
Service Not in Running State
Symptom
Error message
40 Troubleshooting for SSMC installation and configuration
Cause
The 3PAR StoreServ Management Console Server failed to start.
Action
Try starting the service manually from a Command Prompt window using the following command: sc start ssmc
Detected Installer Running
Symptom
Error message
Cause
When trying to uninstall the product, the uninstaller detected that the installer is running.
Action
Finish or abort the installation, then rerun the uninstaller.
Linux installation issues for SSMC
The following sections describe error messages you might encounter when attempting to install the SSMC server.
rmdir: failed to remove ‘/opt/hpe’: Not a directory
Symptom
Error message
Cause
Attempt to remove SSMC from symbolic link.
Action
You can continue to remove SSMC (not recommended) or install SSMC on a supported location.
Port xxxxx is not valid
Symptom
Error message
Cause
You must have a valid port number to install the product.
Action
Set the secure port number to a value between 1024 and 65002.
Detected Installer Running
Symptom
Error message
Cause
When trying to uninstall the product, the uninstaller detected that the installer is running.
Linux installation issues for SSMC 41
Action
Finish or abort the installation, then rerun the uninstaller.
Port xxxxx is not available
Symptom
Error message
Cause
The port you selected is not available for the secure port.
Action
Set the secure port number to an available port with a value between 1024 and 65002.
Detected a non 64-bit operating system
Symptom
Error message
Cause
A non 64–bit operating system was detected.
Action
Occurs only when attempting to install on a 32–bit machine. Install on a supported 64–bit operating system.
Your current operating system is xxxxx which is NOT supported
Symptom
Error message
Cause
A nonsupported operating system was detected.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system.
Did not meet the minimum requirement of two processors
Symptom
Error message
Cause
Detected fewer than the minimum number of processors required for installation.
Action
You can attempt to continue with the installation (not recommended) or install on a supported operating system with a minimum of two logical processors.
42 Troubleshooting for SSMC installation and configuration
Minimum RAM requirement of 4194304 KB is NOT met
Symptom
Error message
Cause
Less than the minimum required RAM was detected.
Action
You can attempt to continue with the installation (not recommended) or install on a system with at least 4 GB of RAM.
Minimum free disk space requirement of 2097152 KB is NOT met
Symptom
Error message
Cause
The amount of free space detected was less than the recommended amount.
Action
You can attempt to continue with the installation (not recommended) or install on a system with a minimum of 2 GB of free disk space.
Unable to connect to secure port xxxxx
Symptom
Error message
Cause
A connection could not be made to the secure port.
Action
Check log files for troubleshooting information.
Configuration issues for SSMC
No data available in table
Symptom
File Persona – Node Pairs error message.
Cause
No nodes appear for selection.
Action
To make sure that the system has a File Persona license and nodes that support File Persona, run the 3PAR CLI commands showlicense, showport, and showfs.
If the system has a File Persona license and supporting nodes, check the system status to see if the system is in a degraded state that could affect the nodes.
Configuration issues for SSMC 43
System <name> does not have enough available ports.
Symptom
Federation error message. Cannot add the system to the Federation
Cause
There are not enough available ports to complete this action.
Action
Take the desired ports offline to make the ports available for federation.
SSMC log files
SSMC has four logging levels, in increasing levels of severity.
INFO Designates informational messages that show the progress of a request at a high level.
WARN Designates potentially harmful situations, or errors that the server was able to handle.
ERROR Designates errors that should not occur per the design of the system, but would allow the server to continue operating.
FATAL Designates severe errors that would prevent the server from starting successfully, or would cause the server to crash if already running.
A list of log files and their default locations follows.
Log file name
audit.log
fatal.log
HPE_3PAR_StoreServ_
Management_Console_
Server_Install_
MM_DD_YYYY_ hh_mm_ss.log
Directory location Contents
Windows logical location:
C:\Program Files\Hewlett
Packard Enterprise\SSMC\ ssmcbase\data\logs
Windows physical location:
C:\ProgramData\Hewlett Packard
Enterprise\ SSMC\data\logs
Linux logical location:
/opt/hpe/ssmc/ssmcbase/data/logs
Linux physical location:
/var/opt/hpe/ssmc/data/logs
Helps the Security Administrator monitor and enforce security policy. Retention/rollover policy: 10 files of 1 Mb each.
audit.log
contains the following columns:
• System Name — Name of 3PAR
StoreServ Storage System array if available; the IP address if not.
• Action — One of the following actions:
CREATE, DELETE, UPDATE, LOGIN,
READ, STARTUP, SHUTDOWN, ARRAY
ACTION, or UNKNOWN.
• Result — One of the following results:
SUCCESS, FAILURE,
SOME_FAILURES, CANCELLED,
KILLED, INFO, OPERATION,
FORBIDDEN, UNAUTHORIZED, TASK
CREATED, or UNKNOWN
• Severity — One of the following classifications: INFO, WARNING,
CRITICAL, or UNKNOWN.
C:\Program Files\ Hewlett
Packard
Enterprise\SSMC\installLogs
Lists errors that prevent the server from starting correctly, and errors that cause an unexpected shutdown of the server.
Retention/rollover policy: Two files of 1 Mb each.
Summary of installation operations.
MM is month
DD is day
YYYY is year hh is hour
44 Troubleshooting for SSMC installation and configuration
Log file name Directory location Contents
mm is minute ss is second hpessmcInstall.log
rest_history.log
ssmc.log
/var/log
Linux cumulative install and uninstall logs.
Windows logical location:
C:\Program Files\Hewlett
Packard Enterprise\SSMC\ ssmcbase\data\logs
Windows physical location:
C:\ProgramData\Hewlett Packard
Enterprise\ SSMC\data\logs
Linux logical location:
/opt/hpe/ssmc/ssmcbase/data/logs
Linux physical location:
/var/opt/hpe/ssmc/data/logs
Audit entries for GET, POST, PUT, and
DELETE requests. Intended for internal, development troubleshooting.
Helps the Application Administrator gauge the health of the product and troubleshoot customer issues along with field support.
Retention/rollover policy: Two files of 100
Mb each.
tclapi.audit
Windows logical location:
C:\Program Files\Hewlett
Packard Enterprise\SSMC\ ssmcbase\data\InFormMC\log
Windows physical location:
C:\ProgramData\Hewlett Packard
Enterprise\SSMC\ data\InFormMC\log
Linux logical location:
/opt/hpe/SSMC/ssmcbase/data/
InFormMC/log
Linux physical location:
/var/opt/hpe/SSMC/data/InForm/log
Audit entries for commands sent to each connected 3PAR StoreServ Storage System array.
HPE_3PAR_StoreServ_
Management_Console_
Server_Uninstall_
MM_DD_YYYY_ hh_mm_ss.log
wrapper.log
C:\Program Files\Hewlett
Packard Enterprise\SSMC\ installLogs
Actions performed during the uninstall process.
MM is month
DD is day
YYYY is year hh is hour mm is minute ss is second
Windows logical location:
C:\Program Files\Hewlett
Packard Enterprise\SSMC\ ssmcbase\data\logs
Windows physical location:
C:\ProgramData\Hewlett Packard
Enterprise\ SSMC\data\logs
Linux logical location:
/opt/hpe/ssmc/ssmcbase/data/logs
Linux physical location:
This file contains all the logging information from the YAJSW (Yet Another Java Service
Wrapper), and all the console output from the SSMC product. This file might not mirror all the content of ssmc.log. If SSMC output goes to the log file only, then the wrapper.log
does not contain the data.
Wrapper information includes the YAJSW version, OS type, JVM version, working directory, service start info, the PID of the started application, and so on.
SSMC log files 45
Log file name Directory location
/var/opt/hpe/ssmc/data/logs
Contents
The console output of the application contains the PID instant of "wrapper" in the output line in the second field.
archive.log
46 Troubleshooting for SSMC installation and configuration
13 Support and other resources
Accessing Hewlett Packard Enterprise Support
•
For live assistance, go to the Contact Hewlett Packard Enterprise Worldwide website:
www.hpe.com/assistance
•
To access documentation and support services, go to the Hewlett Packard Enterprise Support
Center website:
www.hpe.com/support/hpesc
Information to collect
•
Technical support registration number (if applicable)
•
Product name, model or version, and serial number
•
Operating system name and version
•
Firmware version
•
Error messages
•
Product-specific reports and logs
•
Add-on products or components
•
Third-party products or components
Accessing updates
•
Some software products provide a mechanism for accessing software updates through the product interface. Review your product documentation to identify the recommended software update method.
•
To download product updates, go to either of the following:
◦
Hewlett Packard Enterprise Support Center Get connected with updates page:
www.hpe.com/support/e-updates
◦
Software Depot website:
www.hpe.com/support/softwaredepot
•
To view and update your entitlements, and to link your contracts and warranties with your profile, go to the Hewlett Packard Enterprise Support Center More Information on Access
to Support Materials page:
www.hpe.com/support/AccessToSupportMaterials
IMPORTANT:
Access to some updates might require product entitlement when accessed through the Hewlett Packard Enterprise Support Center. You must have an HP Passport account set up with relevant entitlements.
Websites
Website
Hewlett Packard Enterprise Information Library
Hewlett Packard Enterprise Support Center
Link www.hpe.com/info/enterprise/docs www.hpe.com/support/hpesc
Accessing Hewlett Packard Enterprise Support 47
Website
Contact Hewlett Packard Enterprise Worldwide
3PAR StoreServ Storage Community
Subscription Service/Support Alerts
Software Depot
Customer Self Repair
Insight Remote Support
Serviceguard Solutions for HP-UX nl
Single Point of Connectivity Knowledge (SPOCK)
Storage compatibility matrix
Storage white papers and analyst reports
Link www.hpe.com/assistance www.hp.com/go/storeservcommunity www.hpe.com/support/e-updates www.hpe.com/support/softwaredepot www.hpe.com/support/selfrepair www.hpe.com/info/insightremotesupport/docs www.hpe.com/info/hpux-serviceguard-docs www.hpe.com/storage/spock www.hpe.com/storage/whitepapers
Customer self repair
Hewlett Packard Enterprise customer self repair (CSR) programs allow you to repair your product.
If a CSR part needs to be replaced, it will be shipped directly to you so that you can install it at your convenience. Some parts do not qualify for CSR. Your Hewlett Packard Enterprise authorized service provider will determine whether a repair can be accomplished by CSR.
For more information about CSR, contact your local service provider or go to the CSR website:
www.hpe.com/support/selfrepair
Remote support
Remote support is available with supported devices as part of your warranty or contractual support agreement. It provides intelligent event diagnosis, and automatic, secure submission of hardware event notifications to Hewlett Packard Enterprise, which will initiate a fast and accurate resolution based on your product’s service level. Hewlett Packard Enterprise strongly recommends that you register your device for remote support.
For more information and device support details, go to the following website:
www.hpe.com/info/insightremotesupport/docs
Documentation feedback
Hewlett Packard Enterprise is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation
Feedback ([email protected]). When submitting your feedback, include the document title, part number, edition, and publication date located on the front cover of the document. For online help content, include the product name, product version, help edition, and publication date located on the legal notices page.
To provide enhancement requests, comments, and suggestions about the SSMC product, send email to [email protected].
48 Support and other resources
Glossary
DO
FIPS
FPG
LDAP
MC
QoS
RC
SLD
SSMC
AFC
AO
CA
CLI
CPG
DAR
DIT
DN
Adaptive Flash Cache
Adaptive Optimization
Certificate Authority
Command Line Interface
Common Provisioning Group
Data At Rest
Directory Information Tree
Distinguished Name
Dynamic Optimization
Federal Information Processing Standards
File Provisioning Group
Lightweight Directory Access Protocol
HPE 3PAR Management Console
Quality of Service
Remote Copy
Synchronous Long Distance
HPE 3PAR StoreServ Management Console
49
A Open source code
The following table lists open source code tools and license information. For the latest and most up to date listing, see thirdPartyManifest.pdf, located in the Licenses directory on the SSMC
DVD ISO image.
Tool name
Apache Commons
Bouncy Castle
ColReorderWithResize
Version
3.3
1.52
1.1.0–dev2
1.8.3
1.2
1.9
License URL or location
Apache 2.0
Bouncy Castle
MIT
MIT
BSD-3–Clause
Apache 2.0
Apache 2.0
Apache 2.0
commons-beanutils commons-cli-1.2.jar
commons-codec-1.9.jar (master: commons-codec-1.6.jar) commons-collections commons-lang3 commons-net commons-vfs2 commons-xml-apis
Dom4J
Dynamic Reports
ECMA262-5.js
ElasticSearch Server
excanvas.js
ExpiringMap (JHalterman) gentlyWEB
Globalize gson-2.3.1.jar
Guava html5.js
ICU4j
Jackson
Javassist
Java Hamcrest
Jaxen
3.2.1
3.1
3.3
2.0
1.4.01
1.6.1
4.0.0
Public Domain
1.7.4
None/r3
0.5.7
1.1
0.1.1
2.3.1
18.0
2.1pre
2.6.1
1.9.12
3.18.2–GA
1.3
1.1–beta6
Apache 2.0
Apache 2.0
Apache 2.0
Apache 2.0
Apache 2.0
BSD-3–Clause
LGPL v3
NA
Apache 2.0
Apache 2.0
Apache 2.0
Apache 2.0
MIT
Jquery Globalize License
Apache 2.0
Apache 2.0
MIT
ICU License
Apache 2.0
Apache 2.0
BSD-3–Clause
The Werken Company License
BSD 3–Clause
50 Open source code
Tool name
Jcraft Jsch
Jetty
Jfreechart
Joda Time josql jquery jquery.ba-hashchange.js
jquery.browser.js
jquery.columnizer.js
jquery.cookie.js
jquery.dataTables.js
jquery.dataTables.rowReordering.js
jquery.dateFormat.js
jquery.flot.categories.js
jquery.flot.fillbetween.js
jquery.flot.js
jquery.flot.pie.js
jquery.flot.selection.js
jquery.flot.time.js
jquery.js
jquery.knob.js
jquery.mask.js
jquery.maskedinput-1.3.js
jquery.selectBox.js
jquery.sparkline.js
jquery.ThreeDots.js
jquery.timeago.js
jquery-ui.js
jquery-ui-sliderAccess.js
jquery-ui-timepicker-addon.js
jquery.validate.js
JSON
Json.NET 6.0 Release 8 json2.js
JSON-path
1.3
1.0.7
2.1
1.0.10
1.4.1
1.9.2
0.3
1.1.2
None/0.8
0.8.0
None/0.7
None/0.7
None/0.7
1.8.3
1.2.0
1.6.5
1.10.0
20080701
6.0, Rel 8
Version
0.1.53
9.3.7.v20160115
1.0.13
2.2
2.2.0
1.8.2
1.3
2.3
1.6.0
1.3.1
1.9.4
1.0.0
1.0 (June 15, 2011)
None/1 none/40597
0.8.0
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
MIT
BSD-3–Clause
MIT
MIT
JSON License
Codeplex MIT
OpenSource MIT
License URL or location
BSD-3–Clause
Apache 2.0
LGPL v2.1
Apache 2.0
Apache 2.0
MIT
MIT
MIT
MIT
MIT
MIT
MIT
Creative Commons Attribution 3.0
MIT
NA
Apache 2.0
51
Tool name
JSR305
Junit krukow/clj-ds
Log4J
Lucerne
Makeself
MapDB modernizr.js
OpenCSV org.eclipse.persistence.antlr-2.5.0.jar
org.eclipse.persistence.asm-2.5.0.jar
org.eclipse.persistence.core-2.5.0.jar
Reflections require.js
RESTeasy sblim-cim-client shBrushCss.js
shBrushJScript.js
shBrushPlain.js
shBrushXml.js
shCore.js
SLF4J text.js
Touch Punch
Trove4J
Version
2.0.3
4.12
1.5.1
1.2.17
4.6.1
2.1.5
1.0.8
2.6.2
2.3
2.5.0
2.5.0
2.5.0
0.9.9–RC1
2.1.4
3.0.12
2.2.5
None/3.0.83
None/3.0.83
3.0.83
None/3.0.83
None/3.0.83
1.7.10
2.0.4
0.2.3
3.0.3
use.js
xregexp.js
0.3.0
1.5.1
Yet Another Java Service Wrapper (YAJSW)
11.11
YourKit (yjpagent.dll)
Zulu: Multi-platform Certified OpenJDK
1.8.0_45
License URL or location
Apache 2.0
Eclipse Public License v1.0
Eclipse Public License v1.0
Apache 2.0
Apache 2.0
GNU GPL v2.txt
Apache 2.0
MIT
Apache 2.0
Eclipse Public License v1.0
Eclipse Public License v1.0
Eclipse Public License v1.0
Public Domain
MIT
Apache 2.0
Eclipse Public License v1.0
MIT
MIT
MIT
MIT
MIT
MIT
SLF4J
MIT
MIT
MIT
LGPL v2.1
MIT
MIT
LGPL v2.1
https://www.yourkit.com/purchase/ license.html
GPL v2
52 Open source code
Lataa
Mainos