HPE Synergy Image Streamer 3.0 User
Guide
Abstract
This guide describes the Image Streamer architecture, features, interfaces, and working
environment. It describes the server deployment process using Image Streamer, the purpose,
and life cycle of Image Streamer artifacts and the actions you can perform using them. It also
includes information about recommendations for using Image Streamer resources,
authentication, authorization and troubleshooting information for Image Streamer.
Part Number: 5200-2513
Published: June 2017
Edition: 2
Notices
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.
Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.
Revision history
Part
number
Edition
Published
Updates
5200-0217
1
March 2017
Initial release for Image Streamer 3.0
5200-2513
2
June 2017
Included guidelines for replacing an Image Streamer
appliance and procedure to shut down an appliance
using Maintenance console.
Included default password to log into AMVM.
Contents
Introduction to HPE Synergy Image Streamer..................................... 7
Image Streamer overview............................................................................................................. 7
Image Streamer appliance terminology........................................................................................ 7
Image Streamer building blocks....................................................................................................8
Image Streamer architecture........................................................................................................ 9
User roles for Image Streamer......................................................................................................9
Deployment using Image Streamer............................................................................................ 10
Artifacts..................................................................................................11
About Plan Scripts.......................................................................................................................11
About OS Build Plans..................................................................................................................11
About Golden Images..................................................................................................................11
Recommendations........................................................................................................... 13
About Deployment Plans............................................................................................................ 13
About artifact bundles................................................................................................................. 14
About custom attributes.............................................................................................................. 14
Types of custom attributes.......................................................................................................... 14
Rules for custom attributes......................................................................................................... 17
Best Practices for using Artifacts................................................................................................ 17
Use existing artifacts as templates...................................................................................17
Use Hewlett Packard Enterprise naming convention....................................................... 18
Deployment............................................................................................19
About deployment....................................................................................................................... 19
Deployment using Image Streamer..................................................................................19
Deployment Groups.................................................................................................................... 19
Deployment Appliances.............................................................................................................. 19
Advanced Management Virtual Machine............................................ 20
Advanced Management Virtual Machine concept.......................................................................20
Features of AMVM...................................................................................................................... 20
AMVM lifecycle............................................................................................................................20
Working with an AMVM...............................................................................................................20
Viewing AMVM creation status using the Image Streamer user interface....................... 20
Working with AMVM using REST API.............................................................................. 21
Prerequisites for mounting and unmounting the OS volume using AMVM................................. 22
Connecting to AMVM to mount the OS volume.......................................................................... 23
Unmounting the OS volume........................................................................................................25
Features................................................................................................. 26
Stateless Experience.................................................................................................................. 26
High Availability...........................................................................................................................26
High availability for OS volumes...................................................................................... 26
High availability for appliance and artifact management..................................................26
Capture....................................................................................................................................... 28
Contents
3
Capture using the Image Streamer appliance..................................................................28
Backup and restore using Image Streamer................................................................................ 28
Backup............................................................................................................................. 28
Restore and recovery.......................................................................................................28
Maintenance Console........................................................................... 31
About the Maintenance console..................................................................................................31
Access the Maintenance console............................................................................................... 32
Access the Maintenance console through an SSH connection........................................32
Access the Maintenance console from an HPE Synergy Frame Link Module................. 33
Access the Maintenance console through a notebook or laptop......................................33
Log in to the Maintenance console............................................................................................. 34
About the Maintenance console password................................................................................. 34
About the factory reset operation................................................................................................35
Maintenance console main menu screen details........................................................................ 35
Maintenance console Details screen details...............................................................................36
Maintenance console appliance states....................................................................................... 37
View the appliance details...........................................................................................................39
Reset the Maintenance console password................................................................................. 40
Reset the administrator password with the Maintenance console.............................................. 40
Shut down the appliance using the Maintenance console ......................................................... 41
Restart the appliance using the Maintenance console .............................................................. 41
Create a support dump file from the Maintenance console........................................................ 42
Perform a factory reset using the Maintenance console ............................................................42
Configure MGMT port for deployment network connectivity....................................................... 43
Configure MGMT port for management network connectivity.....................................................43
MGMT port repurpose for a single enclosure setup....................................................................44
Manual activation of an appliance...............................................................................................44
Reimaging Image Streamer..................................................................45
Preparing a USB flash drive to reimage Image Streamer...........................................................45
Recommendations for preparing a USB flash drive to reimage Image Streamer............ 45
Reimaging Image Streamer appliance with a preloaded USB drive........................................... 46
Verifying the reimage process.....................................................................................................47
Replacing Image Streamer................................................................... 48
Guidelines for removing an Image Streamer appliance .............................................................48
Guidelines for inserting an Image Streamer appliance............................................................... 50
Known issues during Image Streamer appliance removal or insertion....................................... 51
Loss of storage quorum renders OS volumes inaccessible............................................. 52
Appliance removal or replacement fails because the appliance has no OS volumes......53
Security.................................................................................................. 54
Assumptions................................................................................................................................54
Authentication............................................................................................................................. 54
Roles and Authorization..............................................................................................................54
Communication........................................................................................................................... 54
Appliance Discovery................................................................................................................... 55
Data Protection........................................................................................................................... 55
Password Storage............................................................................................................55
Network Security.........................................................................................................................55
Audit Logs................................................................................................................................... 55
4
Contents
Compliance................................................................................................................................. 55
Deployment and Maintenance.................................................................................................... 56
Known issues..............................................................................................................................56
Troubleshooting Image Streamer........................................................ 57
Basic troubleshooting techniques............................................................................................... 57
Active-standby Image Streamer appliance pair is not highly available....................................... 57
Changes to compute module settings are not updated onto Image Streamer............................57
Compute module waits in PXE boot mode due to unavailability of OS volume from Image
Streamer..................................................................................................................................... 58
Creation of OS deployment server (Image Streamer) fails due to conflict in IP address............ 58
Creation of OS volume fails when attempted immediately after logical enclosure creation........59
Image Streamer active appliance is unable to pair with Image Streamer standby appliance.....59
Image Streamer appliance unavailable due to a reset................................................................59
OS deployment server creation fails due to communication issues between HPE OneView
and Image Streamer................................................................................................................... 60
Image Streamer appliance loses management network connectivity in single enclosure
setup........................................................................................................................................... 60
Image Streamer AMVM is unavailable........................................................................................60
Image Streamer primary appliance is not responding................................................................ 61
Image Streamer restore operation stops abruptly.......................................................................61
OS deployment using Image Streamer fails............................................................................... 62
Problems in the functioning of the Image Streamer standby appliance......................................62
Unable to access Image Streamer appliance from HPE OneView............................................. 63
Unable to include support dump for a standby Image Streamer appliance................................ 63
Unable to power on an Image Streamer appliance on a remote enclosure in a multienclosure setup...........................................................................................................................64
Documentation and troubleshooting resources for HPE Synergy...65
HPE Synergy documentation......................................................................................................65
HPE Synergy Configuration and Compatibility Guide...................................................... 65
HPE OneView User Guide for HPE Synergy................................................................... 65
HPE OneView Global Dashboard.................................................................................... 65
HPE Synergy Image Streamer User Guide......................................................................65
HPE Synergy Image Streamer GitHub.............................................................................65
HPE Synergy Software Overview Guide..........................................................................65
Best Practices for HPE Synergy Firmware and Driver Updates...................................... 66
HPE OneView Support Matrix for HPE Synergy.............................................................. 66
HPE Synergy Image Streamer Support Matrix................................................................ 66
HPE Synergy Glossary.....................................................................................................66
HPE Synergy troubleshooting resources.................................................................................... 66
Troubleshooting within HPE OneView............................................................................. 66
HPE Synergy Troubleshooting Guide.............................................................................. 66
HPE Error Message Guide for HPE Synergy...................................................................67
HPE OneView and HPE OneView REST API scripting help............................................67
HPE Synergy QuickSpecs................................................................................................67
Websites................................................................................................ 68
Support and other resources...............................................................69
Accessing Hewlett Packard Enterprise Support......................................................................... 69
Accessing updates......................................................................................................................69
Contents
5
Customer self repair....................................................................................................................70
Remote support.......................................................................................................................... 70
Warranty information...................................................................................................................70
Regulatory information................................................................................................................71
Documentation feedback............................................................................................................ 71
6
Contents
Introduction to HPE Synergy Image Streamer
Image Streamer overview
HPE Synergy Image Streamer is an HPE Synergy management appliance used to host, configure and
serve operating systems to the HPE Synergy compute modules. This appliance permits a stateless server
deployment experience for compute modules. The HPE Synergy compute modules boot and run from the
OS volumes hosted on the Image Streamer appliance. The Image Streamer appliance uses artifacts such
as Plan Scripts, OS Build Plans, Golden Images, and Deployment Plans to deploy and configure the
operating systems for HPE Synergy compute modules. You can also use artifacts such as OS Build Plans
and Plan Scripts to capture a Golden Image from an installed OS volume using the capture functionality
of the Image Streamer appliance.
Stateless servers are physical servers without storage for application data. You can use a temporary local
storage such as swap space with a stateless approach. Image Streamer managed by HPE OneView
achieves operating system deployment on stateless servers by maintaining the physical state and
deployed state of a compute module separately. The software state contains the firmware configuration,
network connections, boot settings and the iLO configuration, and is stored in the server profiles available
in HPE OneView. The deployed OS volume contains the Golden Image (a combination of a bootable
operating system, applications, and I/O driver version) and personality (hostname, IP configuration), and
is stored in the Image Streamer OS volume. This stateless experience helps in achieving consistent
software deployment and update, easy repair, or replacement of the servers.
More Information
Image Streamer appliance terminology on page 7
Image Streamer building blocks on page 8
Image Streamer appliance terminology
An HPE Synergy Composer domain can have multiple Image Streamer appliance pairs. An Image
Streamer appliance pair serves a single logical enclosure, and a single logical enclosure can have at
most one Image Streamer appliance pair. One Image Streamer appliance pair is designated as the
primary appliance pair, and all other appliance pairs are designated as secondary appliance pairs.
For an Image Streamer appliance pair, the artifact management and OS deployment functions are served
by an Active-Standby management cluster, whereas the OS volume storage is served by an Active-Active
Storage cluster.
All Image Streamer appliances managed by an HPE OneView instance operate as one deployment
server that provides deployment functionality across the appliances.
A special single frame configuration with one Image Streamer appliance can be used for development or
testing environments. Hewlett Packard Enterprise recommends a 3-frame configuration as a minimum
requirement for production environment. The following list describes the appliance and cluster concepts:
Image Streamer appliance
An individual HPE Synergy Image Streamer module placed in HPE Synergy frames or a pair of Image
Streamer modules that function together to form a highly available redundant pair.
Primary Image Streamer appliance
The primary appliance pair for a deployment server. The primary appliance pair is responsible for
managing the server deployment, creating artifacts, and providing storage for the OS volumes for the
compute modules in its logical enclosure.
Introduction to HPE Synergy Image Streamer
7
Secondary Image Streamer appliance
The secondary appliance pair provides storage for the OS volumes for the compute modules in its
logical enclosure. If the primary appliance becomes unavailable, the Infrastructure administrator can
designate a secondary appliance as the primary appliance to manage the deployment process.
Primary active Image Streamer appliance
This appliance provides the deployment server user interface, artifact management, and deployment
control. You can assign the primary appliance.
Primary standby Image Streamer appliance
The primary pair’s standby Image Streamer appliance. When an active appliance becomes
unavailable, the standby appliance takes over the management function of the active appliance and
becomes the active appliance.
The secondary appliances contain a copy of artifacts as available on the primary appliance and assist
with deployment of OS volumes. The standby appliances provide redundant artifact storage and
deployment functionality, if required. Standby appliances also have an active OS volume storage.
Image Streamer building blocks
The Image Streamer appliance uses the following artifacts for deployment:
Plan Script
A guestfish script used to accomplish deployment of an operating system for compute modules or
capture a Golden Image from an operating system volume. Plan Script is used in OS Build Plans for
both the deployment and capture processes.
OS Build Plans
A set of Plan Scripts ordered as steps used to add, modify, or remove the configuration of an OS
volume during the deployment or capture process.
Golden Image
A block-for-block copy of a previously deployed OS volume (a combination of a bootable operating
system, applications, and I/O driver version) that is used to deploy and configure operating systems
for compute modules.
Deployment Plan
A combination of a Golden Image and OS Build Plan that serves as an input for the server profile that
is used for deployment of operating system for compute modules.
Artifact Bundles
A bundle of artifacts that allows other artifacts to be packaged into a single archive file. This
packaging allows the artifacts to be moved between different Image Streamer appliances across
different HPE Synergy Composer domains. This format is used for the release of artifacts provided by
Hewlett Packard Enterprise.
Sample artifacts provided by Hewlett Packard Enterprise might be used for OS deployment or to help
development of customized artifacts. You may want to copy these artifacts to customize functionality and
include additional custom attributes for configuration settings. For more information on sample artifacts
provided by Hewlett Packard Enterprise, see https://github.com/HewlettPackard.
To get technical support, always use Hewlett Packard Enterprise provided artifacts for deployment activity.
More Information
Artifacts on page 11
https://github.com/HewlettPackard/
8
Image Streamer building blocks
Image Streamer architecture
The Image Streamer appliance is placed in one of the Composable Infrastructure Manager (CIM) slots on
HPE Synergy. Figure 1: Image Streamer Architecture on page 9 illustrates the different components
of Image Streamer appliance architecture.
Image Streamer User Interface and API
Image Streamer artifact and deployment management
Image Streamer
artifact repository
Deployment and
OS volume
management
Compute modules
Operating
System volumes
Solid State Drive
Image Streamer Appliance
Synergy
Frame
Figure 1: Image Streamer Architecture
The Image Streamer appliance has the following components:
•
Image Streamer User Interface and Application Programming Interface
•
Image Streamer User Interface and API enable the administrators to access and manage the artifacts
in the appliance.
Image Streamer artifact repository
•
Image Streamer artifact repository is the repository for Image Streamer artifacts.
Image Streamer artifact and deployment management
The user interfaces in the Image Streamer software are built on an operating system to enable
management of artifacts in the Image Streamer appliance and OS volume deployment on compute
modules.
User roles for Image Streamer
The following user roles exist for configuring and accessing Image Streamer using HPE OneView:
Infrastructure administrator
Infrastructure administrator has complete administrative privileges to configure HPE OneView and
Image Streamer.
Image Streamer architecture
9
Server administrator
Server administrator performs server provisioning and OS deployment from the server profile in HPE
OneView.
Software administrator
Software administrator can perform the following actions:
•
•
•
•
Create and manage artifacts such as Plan Scripts, OS Build Plans, Golden Images and
Deployment Plans.
Manage and load artifact bundles.
Capture Golden Images from OS volumes.
Set default configuration and settings that Server administrators might need for deployment.
Backup administrator
Backup administrator can perform the following actions:
•
•
Create and download backup files, view the appliance settings and activities.
Has the authority to use scripts to log in to the appliance and run scripts to back up the appliance.
For information on other user roles in HPE OneView, see HPE OneView Help for HPE Synergy available
at the Hewlett Packard Enterprise Information Library.
Deployment using Image Streamer
Deployment is installing and configuring an operating system for servers.
NOTE:
Compute modules and servers are used synonymously while referring to the HPE Synergy servers.
To perform a deployment:
•
•
•
•
•
The Infrastructure administrator configures the HPE Synergy Composer and Image Streamer
appliances in an enclosure.
The Software administrator creates the artifacts and the custom attributes in the appliance using
REST API or user interface.
The Server administrator specifies the OS deployment settings using the server profiles in HPE
OneView.
The Image Streamer appliance creates an OS volume and performs the OS deployment with the
specified user settings on the OS volume.
Once the deployment is successfully completed, the compute module is powered on. It boots and runs
from the OS volume. After successful deployment, the server profile is updated with the details of the
OS volume.
More Information
About deployment on page 19
10
Deployment using Image Streamer
Artifacts
Artifacts are entities that are used to perform deployment of compute modules or to capture operating
system images. In an Image Streamer appliance, artifacts include Plan Script (PS), OS Build Plan (BP),
Golden Image (GI), and Deployment Plan (DP).
About Plan Scripts
A Plan Script is one of the building blocks of the Image Streamer appliance and plays an important role in
the Deploy and Capture processes. Plan Scripts are guestfish scripts that perform personalization
(deployment) or generalization (capture).
Plan Scripts are of three Types:
•
•
•
Deploy — Plan Scripts that are used for deployment
Capture — Plan Scripts that are used for capture
General — Plan Scripts that are used for deployment or capture
Plan Scripts of Type Deploy contain custom attributes that are used to specify server-specific
configuration information. A Plan Script must be referenced by an OS Build Plan to use it in a deployment
or capture process. You cannot delete a Plan Script that is in use by an OS Build Plan.
Plan Scripts provided by Hewlett Packard Enterprise are read-only. However, you can make a copy and
edit them.
More Information
About custom attributes on page 14
http://libguestfs.org/guestfish.1.html
https://github.com/HewlettPackard/
About OS Build Plans
An OS Build Plan specifies an execution sequence for the Plan Scripts to modify or retain server-specific
content of an OS volume. Based on the type of Plan Scripts, an OS Build Plan can either deploy compute
modules or capture images from compute modules.
For deployment, OS Build Plans modify the contents of the OS volume to personalize the golden image.
For capture, OS Build Plans generalize and capture an image.
OS Build Plans also contain custom attributes that allow you to specify any configuration
information.
OS Build Plans are used by Deployment Plans to perform deployment. You cannot delete an OS Build
Plan that is referenced by a Deployment Plan.
About Golden Images
A Golden Image is a block-for-block copy of an existing operating system that is generalized to remove
any server-specific configuration. It is always in the form of a compressed file.
For deployment, you can customize the image by specifying server-specific configuration using custom
attributes. For capture, you can generalize the image by removing any server-specific configuration
and obtain an image from an OS volume.
Life-cycle of a Golden Image
Typically a Golden Image is captured from one server and later is deployed to one or more compute
modules. The Golden Image can be transferred among one or more OS deployment servers as a
Artifacts
11
compressed copy by download and add processes. It can also be included in an artifact bundle and then
transferred by download and extract of the artifact bundle.
A Golden Image can be added to the OS deployment server by using one of the following operations:
•
•
•
Add
Create
Import from an artifact bundle
The image in the appliance is a ready to use form of Golden Image, and can be used for deployment,
download, and export. Figure 2: Life-cycle of a Golden Image on page 12 describes the different
ways to add or import, capture, download or export, and deploy a Golden Image to the appliance.
Figure 2: Life-cycle of a Golden Image
12
Artifacts
Table 1: Golden Image life-cycle sequence of events
Sequence
Operation
Description
1
Add
Adds a Golden Image from an administrator’s laptop.
1
Capture1
Creates a Golden Image either from a deployed server or from an
OS volume.
1
Import
Adds the Golden Image to the appliance from an imported artifact
bundle.
2
Deploy
Deploys a Golden Image on a compute module, using a Deployment
Plan.
3
Export
Copies the Golden Image to the artifact bundle, which can be later
imported on another Image Streamer appliance.
3
Download
Downloads a Golden Image to the administrator’s laptop as a simple
compressed file having the block-for-block copy of the generalized
OS volume content.
4
Delete
Deletes the Golden Image.
1
Capture is the process of creating a golden image.
Recommendations
Hewlett Packard Enterprise recommends the following while using Golden Images in the Image Streamer
appliance:
Recommendations for creating the first Golden Image
•
•
To create the first Golden Image, you need an empty OS volume into which you can install the
operating system and additional software. To create an empty OS volume, use the special Deployment
Plan HPE - Foundation - create empty OS Volume. This Deployment Plan is available as a
part of HPE Foundation Artifact Bundle in Image Streamer appliance storage.
After OS1 installation, you can make configurational changes in the operating system. Any
configuration information that is not specific to the compute module must be completed in the OS1
before server shutdown and Golden Image capture. Configuration settings for different compute
modules can be handled by using different set of Golden Images or by customizing the OS Build
Plans.
For more information, see Best practices for Image Streamer Artifacts in HPE Image Streamer
Foundation Artifacts available at https://github.com/HewlettPackard/.
About Deployment Plans
A Deployment Plan contains the OS Build Plan and Golden Image. The server profile in HPE OneView
uses the Deployment Plan for server deployment. Generally, a Software administrator creates a
Deployment Plan and a Server administrator uses it in the server profile for deployment. You cannot edit
or delete a Deployment Plan that is in use by an HPE OneView server profile.
1
The Operating System that you are capturing.
Recommendations
13
About artifact bundles
Artifact bundles are provided by Hewlett Packard Enterprise or user created zip files that contain
artifacts such as Plan Scripts, OS Build Plans, Golden Images, and Deployment Plans. The artifacts in
the bundles can be user created, provided by Hewlett Packard Enterprise, or a combination of both. The
artifact bundles are created from existing artifacts on the appliance.
Actions on Artifact bundles
•
•
•
•
You can create multiple artifact bundles on the appliance.
You can download artifact bundles to your local system or upload artifact bundles to an primary active
Image Streamer appliance.
You can extract and import artifacts from the bundles into the appliance. The Import operation copies
and expands the artifacts from the bundle.
You can set the read-only attribute for the artifacts in the bundle to prevent modification after loading
on another appliance. To edit read-only artifacts, you can copy them to another location to create
editable copies.
Extracting Artifact bundles
When you extract an artifact bundle, the extract dialog displays a summary of all artifacts with name
conflicts. If existing artifacts on the appliance match the artifacts that are extracted from the bundle, they
are not copied to the appliance. They are copied to the appliance only after you confirm to rename the
artifacts in the bundle.
About custom attributes
Custom attributes are used to specify server-specific configuration information in the artifacts. You can
add the custom attributes only in Plan Scripts of type Deploy. You can modify the custom attribute values
in Plan Scripts, OS Build Plans, and Deployment Plans in Image Streamer and also in server profiles in
HPE OneView.
A custom attribute has a name, type, value, and constraints that are applicable for each type of custom
attribute. You can specify the custom attribute name and value in the Plan Script screen and you can
specify the type and constraints of the custom attribute in the OS Build Plan screen. Custom attribute
constraints are used to validate the custom attribute values in OS Build Plans, Deployment Plans, and
server profiles in HPE OneView.
The syntax for a custom attribute in a Plan Script is @customattribute_name@. Custom attributes with
default values can be specified as @customattribute_name:customattribute_value@.
Types of custom attributes
String
•
Can have any value unless a regular expression constraint is specified in the OS Build Plan.
Constraints for String custom attribute value:
Regular Expression
The specified value must match the regular expression. For example, a regular expression constraint
^[A-Za-z0-9]+$ implies that the custom attribute value must contain only uppercase alphabets,
lowercase alphabets and numbers. To match the entire string, always remember to specify ^ as the
starting character or $ as the ending character.
If left blank, the custom attribute value is not validated.
Length
Can be up to 254 characters in length.
14
About artifact bundles
Password
•
The password value is encrypted for storage and is masked while you enter it.
Constraints for Password custom attribute value:
Regular Expression
The password must match if the regular expression constraint is specified. To match the entire string,
always remember to specify ^ as the starting character or $ as the ending character.
Minimum length
Minimum number of characters required.
Maximum length
Maximum number of characters required.
IPv4 address
•
The value must be a valid IPv4 address.
Hostname
•
The value must be a valid hostname.
Constraints for Hostname custom attribute value:
Length
Can be up to 254 characters in length.
Allowed characters
•
•
•
Cannot contain period (.).
Can contain alphabets, numbers, hyphen(-) and underscore(_).
Cannot start with hyphen(-) or underscore(_).
FQDN
•
The value must be a valid Fully Qualified Domain Name.
.
Constraints for FQDN custom attribute value:
Allowed characters
•
•
•
Must contain at least one period (.).
Can contain alphabets, numbers, hyphen(-) and underscore(_).
Cannot start with hyphen(-) or underscore(_).
Length
Can be up to 254 characters in length.
Number
•
The value can be an integer or decimal.
Constraints for Number custom attributes:
Minimum
Minimum value allowed
Maximum
Maximum value allowed
Artifacts
15
Increment
Number by which the value is increased or decreased. The increment or decrement options are
available on the following screens:
•
•
•
•
•
Create Deployment Plan
Edit Deployment Plan
Copy Deployment Plan
Create Server Profile
Edit Server Profile
Unit
Unit corresponding to the number
Option
•
•
Restricts the custom attribute values to the user-specified values.
A menu appears on the following screens to enable the user to choose the value from the list of
options:
◦
◦
◦
◦
◦
Create Deployment Plan
Edit Deployment Plan
Copy Deployment Plan
Create Server Profile
Edit Server Profile
NIC
•
Plan Scripts can contain Network Interface Controller (NIC) attributes. NIC attributes are complex
custom attributes and contain interface configuration parameters.
If an interface configuration parameter is not used in Plan Scripts, server profile does not prompt for
the parameter.
•
•
•
A NIC attribute follows the format - <attribute>.<parameter>
If a custom attribute name contains ., the type is automatically set to NIC and cannot be modified
thereafter. The part of name before the . is considered as the name of the custom attribute.
NIC attributes are grouped in the OS Build Plan and Deployment Plan under a single attribute name
and are of type NIC.
All the rules for custom attributes in Plan Scripts apply to NIC attributes. A NIC attribute can contain
the following interface configuration parameters:
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
◦
ipaddress
domain
dns1
dns2
dns3
mac
netmask
gateway
vlanid
dhcp
networkuri
ipv4disable
For a particular NIC attribute, IPv4 configuration can be set to Static, DHCP, or Disable Network
configuration.
16
Artifacts
Static
IPv4 configuration details are set from selected connection (automatically or specified by user) during
server profile creation.
DHCP
IPv4 configuration details are set from DHCP server.
Disable Network configuration
NIC will not be configured
Constraints for NIC custom attributes:
Default values
NIC attributes cannot have default values. The value can either be automatically populated from the
IP pool if auto mode is enabled in the server profile in HPE OneView or specified by the user.
Rules for custom attributes
•
•
•
•
•
Custom attributes can be specified only in Plan Scripts that are of Type Deploy.
The type of custom attributes in OS Build Plans are set to String by default.
When multiple custom attributes are specified, the first default value specified in the Plan Script is
considered as the default value in OS Build Plan.
When the same custom attribute has different values in different Plan Scripts, the default value is
considered from the first Plan Script which contains the default value.
The default value of a custom attribute is not updated in an OS Build Plan or Deployment Plan when:
◦
•
•
•
•
•
You edit the default value of the custom attribute in a Plan Script that is used by an OS Build Plan
that already contains a default value.
◦ You edit the default value of the custom attribute in an OS Build Plan that is used by a Deployment
Plan that already contains a default value.
The custom attribute name cannot contain spaces or special characters. It can contain numbers,
underscores, and dashes.
The custom attribute value can contain special characters and spaces and must be enclosed in single
or double quotes.
The custom attribute default value can be left blank.
If custom attribute value contains @, use @@ instead of @. For example, email@@domain.com.
References to other custom attributes in a custom attribute value are not supported and are
considered as plain text.
Best Practices for using Artifacts
For information on best practices for using Image Streamer artifacts, see Best practices for Image
Streamer Artifacts section in HPE Image Streamer Foundation Artifacts at https://github.com/
HewlettPackard.
Use existing artifacts as templates
Hewlett Packard Enterprise provides artifact bundles that include OS Build Plans. The existing OS Build
Plans can be used as is and also as templates. For more information about the artifacts provided by
Hewlett Packard Enterprise, see the documentation for Image Streamer artifacts available at https://
github.com/HewlettPackard. Artifacts provided by Hewlett Packard Enterprise are read-only. However,
you can make a copy and edit them. For more information on copying artifacts to allow modifications, see
HPE Synergy Image Streamer Online Help.
Rules for custom attributes
17
Use Hewlett Packard Enterprise naming convention
Hewlett Packard Enterprise uses the following naming convention for the artifacts provided with the
Image Streamer appliance:
Organization — OS and version — Action Modifiers
Organization
To avoid naming conflicts, names of artifacts provided by Hewlett Packard Enterprise begin with the
organization name. Hence, do not use HPE for artifacts that are not provided by Hewlett Packard
Enterprise.
OS and version
The organization name precedes the operating system name and version. Along with the OS and version
details, the name can also contain information about layered application software. Typically, this file
naming convention is useful for naming Golden Images.
Action
The operating system and version details precede the action that an artifact performs in the file name.
Typically, this file naming convention is useful for naming Plan Scripts.
Modifiers
Modifiers can contain any other information that describes the artifact. Typically, this part of the file
naming convention is useful for naming Plan Scripts.
For more information, see http://www.software.hpe.com and HPE Image Streamer Foundation Artifacts
at https://github.com/HewlettPackard.
18
Use Hewlett Packard Enterprise naming convention
Deployment
About deployment
Server deployment is the process of installing an operating system on the server and configuring it for
use. Conventional server deployment tools run on the target server using an in-memory operating system
called service OS. The service OS typically matches the operating system to be deployed on the target
server. The deployment tool boots the service OS, then the service OS sets the storage layout, installs
the operating system software, and configures the operating system settings. Once the configuration is
completed, the server reboots and runs the deployed operating system.
Deployment using Image Streamer
The deployment using Image Streamer starts with a block-for-block copy of the Golden Image to create
an OS volume. This copy is created in less than 5 seconds irrespective of the OS volume size. Once the
OS volume is created, the Plan Scripts run in a contained environment to personalize the OS volume for
the target server. During the execution of Plan Scripts, the custom attributes are replaced with their
values.
NOTE:
Since the contained environment is unrelated to the deployed operating system, personalization can
be difficult. Hence, it is important to consider strategies that reduce the complexity and efforts for
customizing each compute module. A simple partition layout and configuration for deployment is
useful to reduce the complexity of personalizing each server.
Deployment Groups
A Deployment Group is a group of Image Streamer appliances in an HPE Synergy Composer domain.
There can be only one deployment group in one HPE Synergy Composer domain at a time.
Deployment Appliances
A Deployment Appliance is a single Image Streamer appliance inserted in the CIM slot. A single
deployment appliance pair contains an active and a standby appliance to achieve high availability.
Using the Deployment Appliances screen of the Image Streamer user interface, you can view the
overall health status of the appliance pair, location and details of active and standby appliances, create a
support dump, and perform update, restart, and shutdown operations on the Image Streamer appliance
Deployment
19
Advanced Management Virtual Machine
Advanced Management Virtual Machine concept
Advanced Management Virtual Machine (AMVM) is primarily used to validate Image Streamer artifacts
and the related custom attributes present in Plan Scripts and OS Build Plans.
To use AMVM, you must have the privileges of any of the following user roles:
•
•
•
Infrastructure administrator
Server administrator
Software administrator
AMVM provides a debugging environment that enables an administrator to perform the following
operations:
•
•
Validate artifacts and custom attributes present in Plan Scripts and OS Build Plans.
Access the in-use OS volume before booting the compute blade.
The administrator can also create or import artifacts using AMVM.
Features of AMVM
AMVM has the following features:
•
•
Ability to troubleshoot a compute module if it fails to boot due to an erroneous Golden Image in the
Image Streamer appliance.
Ability to access the OS volume and verify the contents of the OS volume before booting the compute
module.
AMVM lifecycle
AMVM is created during the logical enclosure creation in HPE OneView. The AMVM is available as long
as the logical enclosure exists.
Working with an AMVM
Viewing AMVM creation status using the Image Streamer user interface
Procedure
1. Navigate to the Activity page on the Image Streamer user interface.
2. Click on the Expand icon for the Update Image Streamer task.
3. View the AMVM creation status in the description of the Update Image Streamer task and the AMVM
creation status.
20
Advanced Management Virtual Machine
Figure 3: Update Image Streamer task
Working with AMVM using REST API
Prerequisites for working with AMVM using REST API
You can use a REST client or cURL commands to perform AMVM operations using REST API.
Procedure
1. Note the managementipv4address of the deployment appliance from the Deployment Appliances
page in the Image Streamer user interface.
Figure 4: Obtain the managementipv4address from the Deployment Appliances page
Obtain the IPv4 address of the virtual machine
Prerequisites
Complete the prerequisites detailed in Prerequisites for working with AMVM using REST API.
Working with AMVM using REST API
21
Procedure
1. GET https://{ip}/rest/appliance/i3s/amvm
Specify the managementipv4address of the deployment appliance instead of {ip}.
The API response contains the managementipv4address of the virtual machine.
Start or shutdown the virtual machine
Prerequisites
Complete the prerequisites detailed in Prerequisites for working with AMVM using REST API.
Procedure
1. PUT https://{ip}/rest/appliance/i3s/amvm
Specify the managementipv4address of the deployment appliance instead of {ip}.
Specify the action parameter to start or shutdown the virtual machine. The values for Action
parameter can be:
•
•
start - Start the virtual machine
destroy - Shutdown the virtual machine
The API response contains the following parameters:
•
•
Status - Contains information about the success or failure of the API call.
Reason - Contains error information, when the API call fails.
Prerequisites for mounting and unmounting the OS
volume using AMVM
Procedure
1. Note the iSCSI initiator name from the Server Profiles page in HPE OneView user interface.
Figure 5: iSCSI initiator name on Server Profiles page
2. Note the Storage IPv4 address of the deployment appliance from the Deployment Appliances page
in Image Streamer user interface.
22
Start or shutdown the virtual machine
Figure 6: Storage IPv4 address on Deployment Appliances page
3. Note the OS volume name from the OS Volumes page on the Image Streamer user interface.
Figure 7: OS volume name on the OS Volumes page
Connecting to AMVM to mount the OS volume
Prerequisites
•
•
Minimum user privileges: Software administrator
Complete the prerequisites detailed in Prerequisites for mounting and unmounting the OS volume
using AMVM.
Connecting to AMVM to mount the OS volume
23
Procedure
1. Start the virtual machine. For more information on starting the virtual machine, see Start or shutdown
the virtual machine.
2. Login to the virtual machine using the managementipv4address of the virtual machine through a
SSH connection. The default password for the AMVM root account is root123.
a. Change the password while logging in for the first time.
3. Execute the iqnchange.sh script available at /etc/imagestreamer/amvm/ to change the iSCSI
initiator of the virtual machine to match the compute module that is assigned to the OS volume.
Specify the iSCSI initiator name.
Figure 8: Executing the iqnchange.sh script
4. Reboot the virtual machine using the reboot command.
5. Connect to the virtual machine and execute the mountscript.sh script available at /etc/
imagestreamer/amvm/ to mount the OS volume.
Specify the OS volume name and Storage IPv4 address.
24
Advanced Management Virtual Machine
Figure 9: Executing the mountscript.sh script
6. Verify content of the OS volume that is available at /root/osvolume/ location.
Figure 10: Verifying content of the mounted OS volume
Unmounting the OS volume
Prerequisites
•
•
Minimum user privileges: Software administrator
Complete the prerequisites detailed in Prerequisites for mounting and unmounting the OS volume
using AMVM.
Procedure
1. Execute the umountscript.sh available at /etc/imagestreamer/amvm.
Specify the OS volume name and Storage IPv4 address.
Unmounting the OS volume logs you out of the iSCSI session.
Unmounting the OS volume
25
Features
Stateless Experience
The Image Streamer appliance permits a truly stateless experience for deployment of operating systems
on HPE Synergy compute modules. To achieve statelessness, the software state of the compute module
and the deployed state of the OS volume are maintained separately. The software state contains the
firmware configuration, network connections, boot settings and the iLO configuration, and is stored in the
server profiles available in HPE OneView. The deployed OS volume contains the Golden Image (a
combination of a bootable operating system, applications, and I/O driver version) and personality
(hostname, IP configuration), and is stored in the Image Streamer OS volume. The servers do not have
any storage for application data. These compute modules boot from the OS volumes stored in the Image
Streamer appliance. This stateless server experience helps achieve faster deployment of operating
systems.
NOTE:
If you choose to use persistent local storage, the Image Streamer appliance cannot provide
stateless compute modules. You can use a temporary local storage such as swap space with a
stateless approach.
High Availability
The Image Streamer appliance works in pairs to achieve high availability. Additionally, multiple pairs of the
appliance can be accommodated in a single HPE Synergy Composer domain to enhance the scalability
of this appliance. If both the active and standby appliances of the primary appliance pair fail, a secondary
appliance is designated as the new primary pair.
The storage on the appliance forms an Active-Active cluster. This mode helps in ensuring continuity in
serving OS volumes when an active appliance fails.
For an Image Streamer appliance pair, the artifact management & OS deployment function is served by
an Active-Standby management cluster, whereas the OS volume storage is served by an Active-Active
Storage cluster.
More Information
Image Streamer appliance terminology on page 7
High availability for OS volumes
The Image Streamer appliance uses a virtual storage appliance to provide an Active-Active storage
cluster for the compute modules. This Active-Active cluster forms a redundant data path for the OS
volumes that achieves high availability of OS volumes. The Image Streamer appliance uses alerts to
notify the user, when any of the storage nodes in the cluster is not available.
High availability for appliance and artifact management
An HPE Synergy Composer domain can have multiple Image Streamer appliance pairs. An Image
Streamer appliance pair serves a single logical enclosure, and a single logical enclosure can have at
most one Image Streamer appliance pair. One of the Image Streamer appliance pair is designated as the
primary appliance, and all other appliance pairs are designated as secondary appliances.
An Image Streamer appliance works as an Active-Standby appliance pair to achieve high-availability for
appliance and artifact management through the user interface. If an active appliance fails, the standby
appliance in the appliance pair can take over the user interface and artifact management in less than 3
26
Features
minutes. If both the active and standby appliances of the primary appliance fail, then one of the available
secondary appliances must be designated as the new primary appliance. To view the details of active and
standby appliances in an appliance pair, navigate to the Deployment Appliances page on the Image
Streamer user interface.
The Image Streamer appliance uses alerts to notify the user when the appliance is not highly available.
Frame 1
HPE OneView
1
2
MGMT
3
LINK
4
5
6
Frame 2
HPE OneView
1
2
7
8
3
Image Streamer
4
5
6
Frame 3
Image Streamer
1
2
3
4
5
Legend:
Management Network
Link Network
7
8
6
Interconnects
Figure 11: High availability in a 3-frame setup
1-6
Racks for compute modules
7-8
Interconnects
The illustration is an example of Image Streamer high availability in a 3-frame setup.
In a 3-frame setup with two Image Streamer appliances:
Features
27
•
•
•
•
•
Two Image Streamer appliances are required to ensure high availability.
A minimum of three frames are required for a pair of Image Streamer appliances.
In Frame 2 where HPE OneView and Image Streamer coexist, the appliances can be placed
interchangeably in any of the CIM slots.
For a pair of Image Streamer appliances, there must be a pair of interconnects.
The position of the interconnects must be symmetrical. In the example illustration, the interconnects
are present in rack 3 and rack 6 of Frame 2 and Frame 3 respectively.
Capture
Capture using the Image Streamer appliance
The capture functionality in the Image Streamer appliance enables you to capture an existing instance of
the operating system on the compute module. The Image Streamer resource management interface
removes all server-specific information before creating a Golden Image from the installed operating
system. This process is also called generalization. When you are creating a Golden Image for the first
time, you need an empty Image Streamer OS volume to install the operating system. Hewlett Packard
Enterprise provides a special Deployment Plan in the Image Streamer appliance storage to create an
empty volume.
Backup and restore using Image Streamer
Backup
Image Streamer backup is considered as a backup of two aspects:
Backup of artifacts
You can back up all the artifacts in Image Streamer by using Deployment Groups > Actions >
Create backup bundle. The backup bundle contains all the artifacts that are available on the Image
Streamer appliance at the time of backup.
Backup of configuration data
Configuration data consists of information about the active and standby appliances of the Image
Streamer appliance pair, IP addresses, and details of primary and secondary appliances. The
configuration information is available in HPE OneView and is backed up as part of HPE OneView
backup. To create a backup in HPE OneView, navigate to Settings > Create backup from the HPE
OneView main menu. For more information on creating HPE OneView backup, see HPE OneView
Help for HPE Synergy.
Hewlett Packard Enterprise recommends that you back up the artifacts and configuration information
whenever you make significant changes to them. Creating an HPE OneView backup and an Image
Streamer backup ensures that both the configuration and artifact information are preserved.
Restore and recovery
There are different situations when you must consider restoring or recovering the Image Streamer
appliance:
Restore artifacts
If you want to restore the artifacts to the instance when the last backup bundle was created, use the
Deployment Groups > Actions > Restore from backup bundle option.
When you restore from a backup bundle, the following actions are performed based on the status of the
artifacts in the backup bundle and in the Image Streamer appliance:
28
Capture
Artifact status
Action performed by Image Streamer restore
operation
Same artifacts are available in the backup bundle
and the Image Streamer appliance and the
artifacts in the Image Streamer appliance have not
been modified after the backup.
The restore operation does not perform any action.
Same artifacts are available in the backup bundle
and the Image Streamer appliance and the
artifacts in the Image Streamer appliance have
been modified after the backup.
The restore operation restores the artifacts in the
backup bundle onto the Image Streamer appliance.
Artifacts are present only in the backup bundle but
are not available in the Image Streamer appliance.
The restore operation restores such artifacts in the
backup bundle onto the Image Streamer appliance.
Artifacts are available only in the Image Streamer
appliance and are not available in the backup
bundle.
The restore operation deletes such artifacts that
are available only on the Image Streamer
appliance.
It is important to note that an Import artifact bundle operation is different from the Restore from backup
bundle operation.
An artifact bundle contains only those artifacts that you chose to include during artifact bundle creation. A
backup bundle contains all the artifacts in the appliance at the time of backup bundle creation.
When you perform an Import artifact bundle operation, if the same artifact is available in the artifact
bundle and in the Image Streamer appliance, the artifact is imported into the Image Streamer appliance
with a different name. The imported artifact name is appended with the sequence number to show the
difference.
However, while performing a Restore from backup bundle operation, restoring an artifact that is
available in the backup bundle and the Image Streamer appliance depends on whether the artifact has
been modified since the backup.
Typically, Import artifact bundle operation can be used when artifacts from another source such as
another Image Streamer configuration or sample artifacts provided by Hewlett Packard Enterprise are
required to be imported into an Image Streamer appliance.
Recovery when an Image Streamer primary appliance pair fails and a secondary
appliance pair is available
This recovery option is applicable only for a multi-enclosure configuration with more than one Image
Streamer appliance pair. This option must be used only if the current primary appliance stops functioning
or is decommissioned and there are no options to recover it.
When the Image Streamer primary appliance pair fails or is decommissioned and there is a secondary
appliance pair available in the enclosure, you can change the primary Image Streamer appliance pair
using the HPE OneView user interface. For information on how to change the primary Image Streamer
appliance pair, see HPE OneView Help for HPE Synergy available at Hewlett Packard Enterprise
Information Library.
Recovery when the Image Streamer primary appliance pair fails and no secondary
appliance pair is available
This recovery option is applicable when you have,
•
•
A single enclosure configuration with a single Image Streamer appliance pair.
A multi-enclosure configuration with a single Image Streamer appliance pair.
Recovery when an Image Streamer primary appliance pair fails and a secondary appliance pair is
available 29
You must follow the sequence of tasks to perform the recovery when the primary appliance pair fails and
no secondary appliance pair is available.
1.
From the HPE OneView main menu, navigate to the Server Profiles screen and note the list of
available server profiles and their values.
2. Delete the server profiles in the logical enclosure to which the primary Image Streamer appliance
pair belongs.
3. From the HPE OneView main menu, navigate to the Logical Enclosures screen.
4. Delete the logical enclosure to which the primary Image Streamer appliance belongs.
5. Remove the Image Streamer appliances from the CIM slot.
6. From the HPE OneView main menu, navigate to OS Deployment Servers screen and delete the OS
deployment server.
7. Insert new Image Streamer Appliances in the CIM slot.
8. From the HPE OneView main menu, navigate to OS Deployment Servers screen and create a new
OS deployment server.
9. From the HPE OneView main menu, navigate to OS Deployment Servers screen and click on the
Image Streamer UI link to open Image Streamer user interface.
10. From the Image Streamer main menu, navigate to Deployment Groups > Actions > Restore from
backup bundleto perform a restore operation.
11. From the HPE OneView main menu, navigate to Logical Enclosures > Create logical enclosure to
create a logical enclosure.
12. From the HPE OneView main menu, navigate to Server Profiles > Create server profile to create a
server profile.
For more information on how to perform each of the tasks in the sequence using the HPE OneView user
interface and Image Streamer user interface, see HPE OneView Help for HPE Synergy and HPE Synergy
Image Streamer 3.0 Online Help available at Hewlett Packard Enterprise Information Library.
Impact of restoring HPE OneView on Image Streamer
Whenever a restore operation is performed on the HPE OneView instance that manages Image Streamer,
Image Streamer performs a post-restore validation of its state and configuration against the restored state
of HPE OneView. The recovery process follows a sequence:
1. User performs a restore operation on the HPE OneView instance that manages Image Streamer.
2. Image Streamer refreshes its state and configuration by validating against the restored state of HPE
OneView.
3. An alert notifies you:
•
If there is a mismatch between OS Deployment Server configuration in HPE OneView and the
Image Streamer configuration. You can choose to continue with the mismatched configuration or
perform corrective actions to resolve the configuration mismatch.
• If there is a mismatch between logical enclosure configuration in HPE OneView and the Image
Streamer configuration. You can choose to continue with the mismatched configuration or perform
corrective actions to resolve the configuration mismatch.
• If there is a mismatch between HPE OneView server profile OS deployments and the OS volumes
residing in Image Streamer. You can delete the orphaned OS volumes in Image Streamer that do
not have a corresponding server profile in HPE OneView after the restore operation.
4. Deployment Plans are synced automatically between HPE OneView and Image Streamer after the
HPE OneView restore operation is complete.
30
Impact of restoring HPE OneView on Image Streamer
Maintenance Console
About the Maintenance console
The Maintenance console, shown in figure "Example of the Maintenance console main menu", provides a
limited set of administrative commands for an appliance.
The Maintenance console is always available from the front panel console or from an SSH session if
maintenance IPs are configured.
The Maintenance console is an important tool for troubleshooting appliance issues when the HPE
Synergy Composer or an Image Streamer is not available. The Maintenance console is always available
from the front panel console or from an SSH session if maintenance IPs are configured.
See "Access the Maintenance console".
In the upper left of most Maintenance console screens, the local appliance is identified by its location
(enclosure identifier and appliance bay number) or its host name.
Figure 12: Example of the Maintenance console main menu
The Maintenance console displays an icon and a message about the state of the appliance, which can
indicate one of the following actions is occurring:
•
•
•
•
•
Normal operation
Appliance is offline
Appliance is being updated
Appliance is synchronizing with the other appliance in the cluster
Appliance is starting up, shutting down, restarting, or temporarily unavailable
Maintenance Console
31
•
•
Appliance is being restored from a backup file
Appliance is being reset to factory default settings
Commands
The body of the main menu contains commands that can be used:
•
•
•
•
•
•
•
•
•
To view the appliance details.
To restart the local appliance.
To shut down the appliance.
To perform a factory reset of the appliance.
To reset the Maintenance console password.
To launch a service console, which an Authorized technical support can use to diagnose or repair a
problem.
To configure the MGMT port for deployment network connectivity.
To configure the MGMT port for management network connectivity.
To log out of the Maintenance console.
Be sure to log out before removing a console (monitor, keyboard, and mouse). Otherwise, you might
be leaving the Maintenance console ready to perform a command like Shutdown the next time a
console is attached and the Enter key is pressed.
NOTE:
The commands displayed by the Maintenance console depend on the current state of the appliance
and how the Maintenance console was accessed.
More information
•
•
•
•
"Access the Maintenance console"
"Log in to the Maintenance console"
"Reset the administrator password with the Maintenance console"
"Perform a factory reset of the appliance using the Maintenance console"
Access the Maintenance console
Access the Maintenance console through the appliance console or through an SSH connection.
NOTE:
Use the credentials for the local Infrastructure administrator credentials when prompted. You can
reset the administrator password from the Maintenance console.
•
•
•
Access the Maintenance console through an SSH connection
Access the Maintenance console from an HPE Synergy Frame Link Module
Access the Maintenance console through a notebook or laptop
Access the Maintenance console through an SSH connection
NOTE:
Hewlett Packard Enterprise recommends the use of these tools for accessing the Maintenance
console through an SSH connection:
•
•
32
PuTTY
MTPuTTY
Access the Maintenance console
Procedure
1.
2.
3.
4.
Invoke one of the recommended tools on your local computer.
Access the appliance by specifying its fully qualified domain name or its IP address.
Enter the user name maintenance at the login prompt.
Log in to the Maintenance console.
Access the Maintenance console from an HPE Synergy Frame Link Module
Procedure
1. Connect a keyboard, video, and mouse using the monitor port and USB ports located:
•
•
On the front panel of the frame (illustration on left)
On an HPE Synergy Frame Link Module at the rear of the frame (illustration on right)
On connection, the HPE Synergy Frame Link Module GUI is displayed.
2. Click the monitor icon located at the top right of the screen.
3. Choose either of the HPE Synergy Composers from the Appliances submenu.
A blank text window opens.
4. Press Enter.
5. Enter the user name maintenance at the login prompt.
6. See Log in to the Maintenance console.
Access the Maintenance console through a notebook or laptop
Prerequisites
•
•
•
You have physical access to the frame
You have configured the notebook computer Ethernet port for DHCP and enabled auto-negotiation
A CAT5 cable
Procedure
1. Connect the CAT5 cable to the Ethernet port on the notebook computer.
2. Connect the CAT5 cable to the notebook port on the front of the frame, on the front panel module (see
illustration).
Access the Maintenance console from an HPE Synergy Frame Link Module
33
3. On the notebook computer, launch a VNC client application to connect to the HPE Synergy console.
If prompted by the VNC client, enter the IP address (including port 5900) of the HPE Synergy frame to
use for the connection: 192.168.10.1.
4. The HPE Synergy console is now available using the VNC client connection.
Log in to the Maintenance console
When you access the Maintenance console, you are presented with either a login screen or the
Maintenance console main menu:
Procedure
1. Access through the appliance console, the Maintenance console main menu is presented immediately.
After you enter your first command and before it runs, the login screen is presented.
Two exceptions are the Reset password and Launch service console, which require a challenge/
response authorization. .
2. Access through SSH presents the login screen immediately.
3. Enter the user name and password of a local Infrastructure administrator account on this appliance.
NOTE:
You cannot log in using an Infrastructure administrator account that is authenticated by an
authentication directory service.
The Maintenance console login remains valid for one hour. After one hour of inactivity, you must
reenter the password. The Maintenance console session closes after 24 hours of inactivity.
About the Maintenance console password
The Maintenance console has no initial password. To set it, see Reset the Maintenance console
password.
Maintenance console passwords must meet the following minimum requirements:
•
•
•
•
•
Fourteen (14) characters long
One uppercase alpha character
One lowercase alpha character
One numeric character
One special character
Backup operations do not back up the Maintenance console password. Ensure that you can remember or
retrieve the Maintenance console password in some other way.
34
Log in to the Maintenance console
IMPORTANT:
You can only reset the password by resetting the appliance to its original factory settings, which
reverts the Maintenance console password to its initial setting, none.
Considerations for an appliance cluster
•
•
The active appliance and the standby appliance can have different Maintenance console passwords.
The Maintenance console passwords are not synchronized between the active appliance and the
standby appliance.
About the Maintenance console
Reset the Maintenance console password
About the factory reset operation
About the factory reset operation
A factory reset restores the appliance to the original factory settings, but does not change the installed
firmware version.
CAUTION:
Ensure that you have a recent backup file before performing this operation.
Never choose to preserve network settings while performing a factory reset operation. Always choose to
perform a full factory reset.
The factory reset operation can only be performed from the Maintenance console.
Use the factory reset operation for either of these reasons:
•
•
To decommission the appliance so that you can migrate the hardware
If you intend to decommission the appliance, perform the factory reset without preserving the network
settings and logs. If the Synergy appliance is not highly available, you must reset the frame link
module from the front panel display module to regain access to HPE OneView. Performing a factory
reset operation on the frame link module disrupts running work loads.
To return the appliance to a known state for reuse (for example, to restore the appliance from a
backup file).
If you plan to restore an appliance from a backup file or to apply a fresh, new configuration, ensure
that you preserve the network settings and logs.
If the appliance is highly available (the View details command on the Maintenance console show both
active and standby operational), the factory reset operation will fail.
Remove the standby appliance from an appliance cluster first using the HPE OneView GUI.
Maintenance console main menu screen details
References to the local appliance indicate the appliance that runs the Maintenance console with which
you are interacting.
About the factory reset operation
35
Screen
component
Description
Title
Identifies the Image Streamer Maintenance console.
Appliance
identifier
For an appliance cluster, this text identifies the local appliance by its enclosure and
appliance bay number.
This text identifies a standalone appliance by its host name.
Is located directly beneath the Title
Icon
Indicates the general state of the appliance. The icon is located in the upper right of
the console screen.
State text
Displays one to three lines of additional text to elaborate on the state indicated by
the icon. Example states include:
Restoring from backup
Starting
Active
Standby / Synchronizing
Notification
banner
Notifies or warns of a situation regarding the appliance or appliance cluster.
The Notification banner spans the width of the Maintenance console.
The Notification banner is not displayed when no notification is pending.
Commands
Lists the available commands that are appropriate to the state of the appliance.
Examples include:
View details
Restart
Shut down
Reset password
Support dump
Factory reset
Launch service console
See also
•
•
•
•
•
•
About the Maintenance console
Access the Maintenance console through an SSH connection
Log in to the Maintenance console
View the appliance details
Create a support dump file from the Maintenance console
Reset the administrator password with the Maintenance console
Maintenance console Details screen details
The View Details command displays this screen.
References to the local appliance indicate the appliance that runs the Maintenance console with which
you are interacting.
Peer appliance refers to the other appliance, regardless of its role, in an appliance cluster.
36
Maintenance console Details screen details
Screen
component
Description
Title
Identifies the Image Streamer Maintenance console.
Appliance
identifier
For an appliance cluster, this text identifies the local appliance by its enclosure and
appliance bay number.
This text identifies a standalone appliance by its host name.
Located directly beneath the Title
Icon
Indicates the general status of the appliance in the upper right.
State text
Displays one to three lines of additional text to elaborate on the icon state. State
text examples include:
Restoring from backup
Starting
Active
Standby / Synchronizing
Notification
banner
Notifies or warns of a situation regarding the appliance or appliance cluster.
The Notification banner spans the width of the Maintenance console.
The Notification banner is hidden when no notification is pending.
Host name
Displays the host name of the appliance.
IP address
Displays the IP address of the appliance.
Model
The model number of the appliance running Image Streamer.
Firmware
The version number of the firmware running on the Image Streamer appliance and
the date the firmware was last updated.
Maintenance console appliance states
The Maintenance console displays an icon and a message in the upper right corner about the state of the
appliance. The state might depend on the situation, especially for a highly available appliance cluster, and
an action might also be required.
State
Situation
Active
The local appliance is the active
appliance of the appliance cluster
and is running normally.
Active
Not an appliance cluster.
Disk has failed
Action
Contact your Authorized technical
support to replace the failed disk
Table Continued
Maintenance console appliance states
37
State
Situation
Action
The disk of the active appliance has
failed.
Contact your Authorized technical
support to replace the failed disk
The standby appliance assumes
control as the single appliance.
The disk of the standby appliance
has failed.
Contact your Authorized technical
support to replace the failed disk
The active appliance continues
operating as a single appliance.
Active
Standby is synchronizing
The local appliance is running
normally.
The peer appliance is being
synchronized. It cannot be activated
if a failure occurs before the
synchronization completes.
Active
Standby is unreachable
Unsynchronized changes
The local appliance is running
normally but cannot reach the peer
appliance.
The peer appliance cannot become
the active appliance in case of a
failure.
Standby
The local appliance is the standby
appliance in the appliance cluster
and is running normally.
Standby
The disk on the local appliance
failed.
Disk has failed
See the alerts listed in the Activity
screen for more details and a
resolution.
Contact your Authorized technical
support to replace the failed disk
The local appliance can no longer
serve as the standby appliance in
the appliance cluster.
The disk on the peer appliance
failed.
Contact your Authorized technical
support to replace the failed disk
The local appliance is currently the
standby appliance, but it will be
activated automatically.
Standby
Synchronizing
The local appliance is the standby
appliance and it is being
synchronized.
It cannot be activated if a failure
occurs before synchronization
completes.
Table Continued
38
Maintenance Console
State
Situation
Action
Offline
The local appliance cannot be
activated automatically because it
cannot confirm that the peer
appliance is not running.
For information on resolving this
issue, see Troubleshooting in the
HPE OneView User Guide for HPE
Synergy.
The appliance failed with an
unrecoverable error.
For information on resolving this
issue, see the section on the Oops
Appliance status screen in the HPE
OneView User Guide for HPE
Synergy.
Manual action required
Offline
Unrecoverable error
Offline
Unusable (incomplete
data)
Resetting
The local appliance cannot be
For information on resolving this
activated because it lacks a
issue, see Troubleshooting in the
complete copy of the appliance data. HPE OneView User Guide.
The appliance is being reset to
factory default settings.
In an appliance cluster, this
operation occurs before the standby
appliance becomes the active
appliance.
Restarting
The appliance is restarting and will
be available shortly.
Restoring from backup
The appliance will be restarted after
the restoration completes.
Starting
The local appliance is starting up
and will be available shortly.
Starting
The peer appliance experienced a
failure and the local appliance is
becoming active.
Recovering from failure
Shutting down
The local appliance is shutting down.
Temporarily unavailable
The local appliance is in a transition,
and its state will change.
Updating
The local appliance is undergoing a
software update.
For information on resolving this
issue, see Troubleshooting in the
HPE OneView User Guide for HPE
Synergy.
View the appliance details
Use this procedure to display appliance details such as state, host name, IP address, model, firmware,
and, for an appliance cluster, the state of the peer appliance. For more information, see Maintenance
console Details screen details .
View the appliance details
39
Procedure
1. Access the Maintenance console’s main menu.
2. Select View details.
The Maintenance console details screen is displayed.
Reset the Maintenance console password
Prerequisites
•
Create a new password that fulfills the password requirements
•
.
If the current Maintenance console password is forgotten, perform a factory reset of the appliance.
Procedure
1.
2.
3.
4.
5.
6.
Access the console.
Log in with the user name maintenance and password (if set) at the login prompt.
Access the Maintenance console main menu.
Select Reset maintenance console password.
Enter the current password and the new password twice, once for verification.
Select OK.
Reset the administrator password with the Maintenance
console
If you lose or forget the local administrator password, use the following procedure to reset it.
This operation provides a unique request code that you use when contacting your authorized support
representative.
IMPORTANT:
The request code is valid only while you are on the Password reset screen of the Maintenance
console. If you return to the main menu or end the Maintenance console session, the request code
will be invalid. You will need to start this procedure over again to acquire a new request code.
You will need to contact your authorized support representative, who will send an authorization
code (also known as a response code) after verifying your information.
You must enter the authorization code within one hour or it becomes invalid.
NOTE:
•
•
•
This capability is not available if you accessed the Maintenance console through SSH. If the
password for another local Infrastructure administrator is known, use the User interface (UI) to
reset the administrator password.
This operation resets the password for a local administrator account on the appliance. It does not
apply to administrator accounts authenticated by a directory service.
In an appliance cluster, this operation resets the password for the administrator account on both
appliances.
This operation allows you to set a single-use password for the local administrator account.
Use that single-use password the next time you log in to the UI with this account. You will be
prompted to set a new password.
40
Reset the Maintenance console password
Procedure
1. Access the Maintenance console.
2. Access the Maintenance console main menu.
3. Select Reset password.
The Maintenance console displays a request code.
4. Telephone your authorized support representative and provide that person with the following
information:
•
•
•
5.
6.
7.
8.
9.
The name of the person requesting the password to be reset.
The name of the company that owns the appliance.
The request code from the Maintenance console.
The authorized support representative verifies the information and then sends a message to the
authorized email address on file. This message contains the authorization code. An ISO image, which
is also the authorization code, is attached to the message.
Type the authorization code into the response field.
Determine a single-use administrator password.
When prompted, enter and re-enter the new password.
Select OK to set the single-use password.
Verify by logging out, then logging into this account with the new password.
Shut down the appliance using the Maintenance console
This procedure describes how to use the Maintenance console to perform a graceful shutdown of the
appliance.
This action shuts down only the local appliance of an appliance cluster.
Prerequisites
•
Ensure that all users are logged out and all ongoing work is completed.
Procedure
1.
2.
3.
4.
Access the Maintenance console main menu.
Select Shut down in the main menu.
Confirm that you want to shut down the appliance.
Verify by observing the shutdown.
Restart the appliance using the Maintenance console
This procedure describes how to use the Maintenance console to shut down and then restart the
appliance.
This action affects only the local appliance of an appliance cluster.
If the local appliance is the active appliance of an appliance cluster, restarting it (the local appliance)
stops the services that were running on it. Until the peer appliance restarts those services, high
availability is temporarily suspended. .
Prerequisites
•
Ensure that all users are logged out and all ongoing work is completed.
Procedure
1. Access the Maintenance console main menu.
2. Select Restart.
Shut down the appliance using the Maintenance console
41
3. Confirm that you want to restart the appliance.
4. Verify by observing the restart.
Create a support dump file from the Maintenance console
This procedure describes how to use the Maintenance console to create a support dump file from the
local appliance (the appliance on which the Maintenance console runs) and store it on a USB drive.
If the local appliance is the active appliance in an appliance cluster and if the standby appliance is
reachable, the support dump will contain the data for both cluster members. Otherwise, a support dump is
created with data for the local appliance only.
CAUTION:
Creating the support dump file overwrites any existing backup file on the appliance. If possible,
refrain from creating a support dump if you have not copied the backup file to an external location
for safekeeping. Use the User interface to download the backup file.
The support dump file is encrypted by default.
Prerequisites
•
•
Minimum required privileges: Infrastructure administrator
Use a USB 2.0 or 3.0 device drive, formatted as an NTFS or FAT32 file system and with only one
partition. If necessary, use a computer to format the USB drive.
The USB drive must have enough free space (typically 1 GB to 4 GB) to store the support dump file.
Procedure
1. Ensure that the USB drive is installed in the USB port of the local appliance.
IMPORTANT:
Do not remove the USB drive until the operation is complete and the Maintenance console
advises that it is safe to remove the drive.
2.
3.
4.
5.
Use the appliance console to access the Maintenance console main menu.
Select Support dump.
A new set of commands appears.
Do one of the following:
a. Select Create support dump to create a new support dump and copy it to the USB drive.
b. Select Download existing support dump to copy a support dump from the appliance to the USB
drive.
6. Wait until the support dump file is copied. There will be a message on the screen stating that the
support dump was successfully completed and that it is safe to remove the USB drive.
Perform a factory reset using the Maintenance console
Prerequisites
•
•
•
Ensure that all users are logged out and all ongoing work is completed.
Back up all user files.
Create a support dump file from the Maintenance console on page 42
Procedure
1. Access the Maintenance console main menu.
2. Select Factory reset in the main menu.
42
Create a support dump file from the Maintenance console
Always choose a full factory reset.
3. In the subsequent dialog box, do one of the following:
a. Enter Y to continue the factory reset operation.
CAUTION:
This option erases the network settings and logs. Use this option to decommission an
appliance.
b. Enter N to cancel the factory reset operation and return to the main menu.
4. Confirm that you want to perform the factory reset in the subsequent dialog boxes.
5. In the next dialog box, do one of the following:
a. Enter Y to continue the factory reset operation.
b. Enter N to cancel the factory reset operation and return to the main menu.
6. Verify by observing the operation.
Configure MGMT port for deployment network
connectivity
This procedure is applicable for a setup with 3 enclosures or more.
Procedure
1. Access the Maintenance console’s main menu.
2. Select Configure MGMT port for deployment network connectivity.
3. A confirmation prompt appears. Select OK to proceed.
Figure 13: Configure MGMT port for deployment network connectivity
Configure MGMT port for management network
connectivity
This procedure is applicable for a setup with 3 enclosures or more.
Configure MGMT port for deployment network connectivity
43
Procedure
1. Access the Maintenance console’s main menu.
2. Select Configure MGMT port for management network connectivity.
3. A confirmation prompt appears. Select OK to proceed.
Figure 14: Configure MGMT port for deployment network connectivity
MGMT port repurpose for a single enclosure setup
To configure the MGMT port for deployment network connectivity or for management network connectivity
in a single enclosure setup, disconnect the cable connecting to the HPE Virtual Connect SE 40Gb F8
Module for HPE Synergy interconnect module.
Manual activation of an appliance
The Activate option is available in the maintenance console main menu when user intervention is
require to manually designate a new active appliance. User intervention is required in a situation when
the communication between active and standby appliances in an Image Streamer appliance pair is
broken and the standby appliance is unable to confirm whether the active appliance is available.
Figure 15: Activate option in the Maintenance console main menu
44
MGMT port repurpose for a single enclosure setup
Reimaging Image Streamer
Preparing a USB flash drive to reimage Image Streamer
Prerequisites
•
•
You need a computer that runs Linux or Microsoft Windows operating system and is connected to the
Internet.
You need a USB flash drive with a minimum memory of 4 GB.
Procedure
1. Insert the USB flash drive in the USB port of the computer.
2. Delete any unnecessary partitions, to ensure sufficient disk space.
3. Perform the following steps to format the USB flash drive as a single primary partition of type FAT32 or
W95 FAT32:
a. Use /sbin/fdisk /dev/sd<x> command, for a Linux operating system.
<x> is the numerical representation of the USB port.
b. Right-click the USB partition and select Format, for a Windows operating system, .
c. Specify a custom label for your USB flash drive. It is recommended to use date as part of the label
for convenience.
NOTE:
You cannot specify EMBEDDED as a label.
d. Specify the following parameters, if prompted.
•
•
•
Capacity — Maximum value
Allocation unit size — 4096 bytes
First and last block — Default values
For more information on the procedure to format the USB flash drive, see the operating system
documentation.
e. Download the compressed image from the HPE Synergy Composer downloads website.
f. Extract the compressed image.
g. Copy the extracted contents to the USB flash drive. Do not rename the files.
Recommendations for preparing a USB flash drive to reimage Image
Streamer
•
•
You can store the preloaded USB flash drive for future use.
Hewlett Packard Enterprise recommends preparing a USB flash drive immediately after updating the
appliance firmware. It helps you to have a USB flash drive that matches the current version of the
Image Streamer OS deployment server. For environments that have multiple Image Streamer OS
deployment server versions, you can prepare different USB flash drives for each version of the Image
Streamer OS deployment server.
Reimaging Image Streamer
45
Reimaging Image Streamer appliance with a preloaded
USB drive
Prerequisites
•
•
A preloaded USB flash drive. For information on how to prepare a preloaded USB flash drive, see
Preparing a USB flash drive to reimage Image Streamer on page 45.
You must have access to the front panel of the Image Streamer appliance.
Procedure
1. Insert the preloaded USB flash drive in the USB port of the appliance that you want to reimage.
1
USB ports in the appliance
Figure 16: Inserting a preloaded USB drive in the appliance
2. Install an HPE Synergy console to monitor the reimage and reboot operations. To install the console:
a. Connect a keyboard, a monitor, and a mouse using the display and USB ports. Once the
components are connected, the HPE Synergy console screen appears.
b. Click the monitor icon at the top right corner of the screen.
c. Select HPE Image Streamer from the Appliances submenu.
d. Press Enter on the console window that appears.
3. Locate the Power/Reset button on the Image Streamer appliance front panel.
46
Reimaging Image Streamer appliance with a preloaded USB drive
Figure 17: Button and Indicator panel
1
Pinhole within Power/Reset button
2
Power/Reset button
3
Active LED indicator
4. Use the applicator to press and hold the pinhole in the Power/Reset button for more than 10 seconds.
Pressing the Power/Reset button momentarily causes the appliance to reboot, but does not reimage
the appliance.
5. As soon as you see the Active LED flashing, release the pinhole. The Active LED flashes with 5 - 10
second interval to indicate that the reimage process has started and is in progress. If an HPE Synergy
console is connected, you can see the progress on it during the reimage process.
Verifying the reimage process
After reimaging, the appliance reboots, updates the firmware to match the version on the preloaded USB
flash drive, and starts Image Streamer. The reimage process takes approximately two hours to complete
reimaging. Once the reimage process is complete, the Image Streamer login screen appears on the
console display.
Procedure
1. Check the firmware version on the appliance panel of the settings screen or by using the View
details command in the maintenance console.
Verifying the reimage process
47
Replacing Image Streamer
Typically, an Image Streamer appliance requires replacement due to hardware failure or planned
maintenance.
When an appliance fails or is removed, alerts notify you about the failure or removal on the Activity
screen of Image Streamer user interface.
NOTE:
You must shutdown an appliance using Maintenance Console before removing it.
When you insert a replacement appliance or reinsert the same appliance, there are no alerts in the HPE
OneView user interface to indicate the progress of the insert operation. Do not interpret the lack of alerts
on HPE OneView user interface and attempt to remove the inserted appliance because the cluster
formation might have started. Removing an appliance during the cluster formation process might result in
loss of OS volumes.
The following sections describe the guidelines and special considerations while replacing an existing
appliance with a new appliance or while removing and reinserting the same appliance.
IMPORTANT:
The following guidelines on removing and inserting an Image Streamer appliance are applicable
only if:
1. You have created at least one server profile in HPE OneView.
2. You have used the server profile in Step 1 to deploy an OS volume using Image Streamer.
If no OS volume is served using Image Streamer, you can perform a full factory reset, remove, and
reinsert the appliance without following these guidelines.
For instructions on how to replace an Image Streamer appliance, see HPE Synergy Appliances
Maintenance and Service Guide available at the Hewlett Packard Enterprise Information Library.
Guidelines for removing an Image Streamer appliance
•
•
•
•
48
Before removing an Image Streamer appliance, verify that there are no outstanding warnings on the
OS Deployment Server screen in HPE OneView or on the Deployment Appliances screen in Image
Streamer.
If one of the appliances is already faulty, critical alerts are displayed on these screens. Follow the
resolutions mentioned in the alerts to resolve the error. If the issue persists even after following the
resolution, contact your authorized support representative.
Before removing an appliance, shut down the appliance using the Maintenance console.
When an appliance is removed from the CIM slot, it might take up to 20 minutes for the removal
operation to complete. Wait for at least 20 minutes before inserting another appliance in the same
slot.
If an active appliance is removed, the standby appliance takes over. It might take 3 to 5 minutes for
the failover to complete. During this time, the Image Streamer user interface displays the following
screen:
Replacing Image Streamer
•
•
If a standby appliance is removed, the Image Streamer user interface continues to be accessible.
When an appliance is removed, an alert displays on the HPE OneView Enclosures screen, after 3 to
4 minutes. This alert displays as soon as the appliance removal operation starts and notifies you that
the expected Image Streamer appliance is missing.
The appliance removal operation is complete when Member Appliances in the details pane of
Deployment Appliances screen in the Image Streamer user interface displays information only about
the existing appliance. There is no information on the removed appliance.
Replacing Image Streamer
49
Guidelines for inserting an Image Streamer appliance
•
•
•
•
50
When an Image Streamer appliance is inserted, it takes up to 1 hour for the inserted appliance to be
ready to operate in high availability mode. Do not remove the appliance for at least 1 hour from the
time of inserting the appliance because it interrupts the cluster formation.
When the same appliance which was removed earlier is reinserted, the reinserted appliance
undergoes a factory reset and powers off. Then, you must manually power it on, perform a factory
reset and reinsert the appliance to enable it to function.
You might encounter GEC errors during the process. Follow the recommendations provided in the alert
until it is cleared. It might require you to refresh the enclosure and reinsert the appliance a few times.
Once the GEC errors are resolved, appliance configuration and clustering take up to 1 hour to
complete so that high availability is restored.
After you insert an appliance, the Enclosures screen in HPE OneView user interface displays an alert
about the interconnect link topology with state as Cleared. This state update might take up to 6
minutes from the time you insert the appliance.
After the appliance is inserted and cluster formation starts, a quorum configuration alert might appear
on the Deployment Appliances screen in Image Streamer user interface. Ignore this alert because it
is a part of the cluster formation process. Once the cluster is formed, the alert automatically clears. If
this alert stays active for more than 30 minutes, contact your authorized support representative.
Guidelines for inserting an Image Streamer appliance
•
The appliance insertion is complete when the Update Image Streamer activity completes successfully
and the Deployment Appliances screen displays information about two member appliances. Do not
remove the inserted appliance until this message is displayed.
Known issues during Image Streamer appliance removal
or insertion
Contact your authorized support representative with a support dump of HPE OneView and Image
Streamer appliances when:
•
•
You encounter any of the following issues when you insert or remove an Image Streamer appliance.
Critical alerts persist for more than an hour after you insert an appliance and the message resolution
directs you to contact support.
Known issues during Image Streamer appliance removal or insertion
51
Loss of storage quorum renders OS volumes inaccessible
Symptom
After you insert an appliance:
•
A quorum configuration alert appears on the Deployment Appliances screen in Image Streamer user
interface and persists for more than 30 minutes.
•
Compute modules shut down immediately.
NOTE:
Compute modules running Linux might shut down immediately. The compute modules running
VMware ESXi might continue functioning from memory and don’t access the OS volume for a
long time. Because there is no alert to notify you that the OS volumes are inaccessible, you
might not see this symptom for compute modules running VMware ESXi.
•
•
New OS deployments using Image Streamer fail and display the error: Unable to deploy OS
volume.
Any further attempt to remove or insert an appliance fails.
Cause
The existing appliance is not able to reach the newly inserted appliance due to technical issues such as
network connectivity. This might cause the storage to lose quorum. If the storage loses quorum, the
corresponding OS volumes become inaccessible and the compute modules using these OS volumes are
impacted.
52
Loss of storage quorum renders OS volumes inaccessible
Action
1. Contact your authorized support representative after creating a support dump from HPE OneView and
Image Streamer appliances.
Appliance removal or replacement fails because the appliance has no OS
volumes
Symptom
When you remove an appliance after deleting all Image Streamer based server profiles, the appliance
removal operation does not fully succeed. This failure prevents the cluster formation process after you
replace or reinsert the appliance.
When you insert an appliance after deleting all Image Streamer based server profiles, it might result in a
condition that causes future appliance removals to fail. Also, any new deployments using Image Streamer
fail.
Cause
The appliance has no OS volumes.
Action
1. Contact your authorized support representative after creating a support dump from HPE OneView and
Image Streamer appliances.
Appliance removal or replacement fails because the appliance has no OS volumes
53
Security
Assumptions
The Image Streamer appliance assumes that the following security aspects are met:
•
•
•
•
The Image Streamer appliance operates in a secure HPE OneView managed environment and is
connected to a secure management network.
The Administrator obtains the Golden Images from trusted sources.
The scripts used in the appliance for personalization or generalization are free from malware.
The Golden Images reside on the Image Streamer OS deployment server. However, the OS
deployment server does not create or manage sensitive data in the Golden Images.
Authentication
HPE OneView uses a secure communication channel to communicate with the Image Streamer
appliance. During the creation of an OS deployment server, HPE OneView configures authentication
settings for the appliance. After configuration, HPE OneView retains the credentials for accessing the
appliance. When a user invokes an Image Streamer operation, HPE OneView uses the single sign-on
authentication tokens to authenticate the user.
Roles and Authorization
HPE OneView provides authorization to Image Streamer users. Software administrator is the role that is
defined in HPE OneView to authorize users to manage Image Streamer artifacts. The User roles and
Authorization table illustrates the different user roles and their respective authorization levels for the
artifacts and deployment process.
Table 2: User roles and Authorization
Role
Artifacts
Deployment
Software Administrator
Full Privileges
View Only
Server Administrator
View Only
Full Privileges
Infrastructure Administrator
Full Privileges
Full Privileges
Backup Administrator
View Only
No Access
Network Administrator
View Only
No Access
Storage Administrator
View Only
No Access
Communication
The following table lists the security mechanisms that protect the different types of data traffic.
54
Security
Table 3: Security mechanism
Traffic
Security mechanism
REST API calls for Image Streamer management
HTTPS
iSCSI commands for booting the blade servers
IQN authorization
Appliance Discovery
Image Streamer appliances are identified using LLDP. The enclosure management interface uses the
LLDP messages to establish an identity for Image Streamer appliances and HPE OneView reads the
identities from the enclosure management interface.
Data Protection
HPE OneView protects Image Streamer artifacts from unauthorized access. The Image Streamer OS
deployment server executes the Plan Scripts in a contained environment that protects the appliance from
malicious scripts.
The iSCSI protocol has an access control mechanism based on initiator and target IQN’s which restricts
unauthorized access to iSCSI storage volumes. The OS volumes are supported by the appliance’s
internal SAN technology. The SAN data storage is not encrypted.
Password Storage
The Image Streamer OS deployment server randomly generates the passwords for management of OS
Volumes and stores them in encrypted storage. Administrator credentials are stored and managed in HPE
OneView and not in the Image Streamer appliance.
Network Security
The Image Streamer appliance secures different types of data using secure channels such as iSCSI, the
operating system’s management network, the high availability feature of the operating system and RAID
storage mechanism. The network traffic is further protected by the security mechanisms listed in the
Security mechanism table.
Audit Logs
The Image Streamer appliance uses audit log to record events. The events recorded include:
•
•
•
•
•
•
Startup of the appliance
Shutdown of the appliance
Creation, modification, or deletion of resources in the appliance
Deployment or redeployment of stateless servers
Changes to configuration
Any authorization or authentication issues.
You can download audit logs from the Actions menu on the Deployment Groups screen.
Compliance
The Image Streamer OS deployment server is compliant with the HPE security policies such as code
signing and is free from malware and backdoors.
Appliance Discovery
55
Deployment and Maintenance
The following factors secure the appliance and the underlying operating system:
•
•
•
Image Streamer provides a nondisruptive software update mechanism for software updates.
Image Streamer provides nondisruptive backup and restore mechanisms that do not affect the storage
volumes. The backup file format is unique and proprietary to Hewlett Packard Enterprise. As an
additional security measure, Hewlett Packard Enterprise recommends encrypting the backup file to
protect sensitive data.
Image Streamer provides a factory reset mechanism to erase the data on the appliance before any
maintenance activities.
Known issues
There are some known security issues in the protocols used by Image Streamer. However, based on the
assumptions listed for the HPE OneView and Image Streamer appliance environment and considering the
security measures built into the appliance, the risks due to these security issues are low.
•
•
56
The iSCSI protocol used in the appliance storage volumes is a clear text protocol and relies on IQN
and CHAP authorizations that are not considered as strong security mechanisms.
The high availability and RAID communications are in cleartext.
Deployment and Maintenance
Troubleshooting Image Streamer
Basic troubleshooting techniques
Image Streamer OS deployment server has different troubleshooting mechanisms that help you to resolve
issues. You can obtain a history of activity and encountered errors by examining the screens and activity
logs.
•
•
•
•
•
Activity details provide additional information about actions and any issues that might have occurred.
To view the activity details, from the main menu select Activity.
Deployment failures might be related to script problems. Review the deployment and capture activity
details to view the errors from script execution. You can download the deployment and capture logs
using the download link available in the activity description.
Refer to the alerts that you notice in the Image Streamer Deployment Appliances page. You can also
view the Image Streamer Dashboard to get the status of the various resources.
You can refer to the alerts that you notice in HPE OneView to understand the issues with Image
Streamer.
If you are unable to troubleshoot an issue, then create a support dump to gather logs and other
information required to debug. The support dump file can then be shared with your authorized support
representative for analysis. For information on how to create a support dump, see HPE Synergy Image
Streamer Online Help.
Active-standby Image Streamer appliance pair is not
highly available
Symptom
Active and standby appliances are not highly available.
Cause
One of the appliances in the active-standby appliance pair is not functioning.
Action
1. Before resuming normal use of an appliance, follow the recommendations of any alerts raised during
manual activation. Restore high availability protection by ensuring that the peer active appliance is in
an operational and reachable enclosure. Use the maintenance console for detailed diagnostic
information.
Changes to compute module settings are not updated
onto Image Streamer
Symptom
Changes to the compute module settings are not updated after reboot.
Cause
The downlink from the interconnect to the compute module is broken.
Troubleshooting Image Streamer
57
Action
1. Ensure that the downlink from the interconnect to the compute module is working.
Compute module waits in PXE boot mode due to
unavailability of OS volume from Image Streamer
Symptom
After a downtime, the compute module powers on but waits in PXE boot.
Cause
When the enclosure is powered on after a downtime, the compute module powers on immediately, but the
Image Streamer appliance requires some time to serve the OS volume. Because of the delay in serving
the OS volume, iLO does not add the OS volume to the booting sequence. This delay in serving the OS
volume causes the compute module to wait in PXE boot mode.
Action
1. Identify if the Image Streamer appliance is available using any of the following steps:
a. Navigate to the Server Profile page in HPE OneView user interface. The Server Profile page
displays an alert about the unavailability of the OS volume. Wait for the alert to clear.
b. Verify if the Image Streamer appliance details are displayed in the Deployment Appliance page in
Image Streamer user interface.
c. Navigate to the OS Volume page in the Image Streamer user interface. The OS Volume page
displays an alert about the availability of the OS volume. Wait for the alert to clear.
d. Verify if the following alert is displayed during the boot sequence: Unable to read storage
system details. Wait for the alert to clear.
2. Reboot the compute module using the HPE OneView user interface.
Creation of OS deployment server (Image Streamer) fails
due to conflict in IP address
Symptom
Creation of OS deployment server in HPE OneView fails due to conflict in IP address.
Cause
The IP address selected is already in use.
Action
1. Ensure that the correct IP address range is specified and there are sufficient IP addresses that are
available.
2. After checking the availability of IP addresses, delete the failed OS deployment server and create a
new OS deployment server.
Before creating a new OS deployment server, you must reinsert the Image Streamer appliance in the
CIM slot.
58
Compute module waits in PXE boot mode due to unavailability of OS volume from Image Streamer
Creation of OS volume fails when attempted immediately
after logical enclosure creation
Symptom
Creation of OS volume fails when:
•
•
You attempt to create the OS volume with a Golden Image that was added prior to creation of the
logical enclosure.
AND
You attempt the operation immediately after the logical enclosure is created.
Cause
The Golden Image is not expanded.
Action
•
Retry creating the OS volume after 15-20 minutes.
Image Streamer active appliance is unable to pair with
Image Streamer standby appliance
Symptom
The active appliance is running standalone and tries to pair with the standby periodically.
Solution 1
Cause
The firmware version on the active or the standby appliance is outdated.
Action
1. Insert a USB drive in the corresponding active or standby appliance's USB port containing the most
recent firmware version. Press and hold the appliance’s reset button for at least 10 seconds to replace
the outdated firmware version.
Solution 2
Cause
The active-standby pair can be incompatible or there are issues with enclosure communication.
Action
1. If the retry attempts fail, and there are no alerts describing the active-standby appliance incompatibility
or enclosure communication issues, remove and reinsert the standby appliance manually. If the issue
to create a pair still persists, restart the active appliance from the Actions menu from the appliance
user interface.
Image Streamer appliance unavailable due to a reset
Symptom
The Image Streamer appliance is unavailable.
Creation of OS volume fails when attempted immediately after logical enclosure creation
59
Cause
The active appliance was reset.
Action
1. Connect to the management console on the active appliance for advanced diagnosis if the high
availability protection is not automatically restored within 15 minutes.
OS deployment server creation fails due to
communication issues between HPE OneView and Image
Streamer
Symptom
OS deployment server creation fails due to communication issues between HPE OneView and Image
Streamer.
Cause
This issue can occur when:
•
The communication between Image Streamer appliance and the HPE OneView is not working.
1.
2.
3.
4.
Perform a factory reset using the Maintenance console.
Reinsert the Image Streamer appliance.
Refresh the enclosure.
Verify if the appliances are displayed on Create OS deployment server page.
Action
Image Streamer appliance loses management network
connectivity in single enclosure setup
Symptom
Image Streamer appliance loses management network connectivity in single enclosure setup
Cause
The management ports are switched to link network.
Action
1. See MGMT port repurpose for a single enclosure setup.
Image Streamer AMVM is unavailable
Symptom
AMVM is unavailable.
Solution 1
Cause
AMVM is not created during creation of logical enclosure.
60 OS deployment server creation fails due to communication issues between HPE OneView and Image
Streamer
Action
1. Verify the status message displayed in the description of Update Image Streamertask on Activity
page in Image Streamer.
2. Recreate the logical enclosure to create the AMVM, if the Update Image Streamer task description
displays the error message:Failed to create amvm.
Solution 2
Cause
The active appliance hosting the virtual machine fails.
Action
1. Reissue the REST call for starting the virtual machine on the new active appliance.
Image Streamer primary appliance is not responding
Symptom
The current primary appliance is not responding and hence, the management interface cannot be
rendered.
Wait for a minimum of 2 hours after the Image Streamer appliance is powered on before attempting to
change the primary deployment appliance. This provides time for the scheduled backup operation and a
latest backup is available to restore the appliance.
Cause
The current primary appliance is not functioning or is decommissioned.
Action
1. Check if there are alerts for the OS deployment server in HPE OneView.
2. If a secondary logical enclosure configured with an Image Streamer appliance is not available:
a. Delete the OS deployment server and recreate it. For information on how to delete and create an
OS deployment server, see HPE OneView Online Help for HPE Synergy.
3. If a secondary logical enclosure configured with an Image Streamer appliance is available:
a. Navigate to the Edit screen of the OS deployment server in HPE OneView user interface and
choose an appliance from the Deployment appliances drop-down menu.
b. In the Change deployment appliance confirmation dialog, click Yes, change deployment
appliance to restore the recently selected deployment appliance with the most recent backup and
proceed with the primary deployment appliance change.
Image Streamer restore operation stops abruptly
Symptom
Image Streamer restore operation stops abruptly.
Solution 1
Cause
The artifacts in the backup bundle already exist on the appliance.
Image Streamer primary appliance is not responding
61
Action
1. Delete existing artifacts in the Image Streamer appliance and retry the restore operation.
Solution 2
Cause
One of the artifacts in the backup bundle is a Deployment Plan without a Golden Image.
Action
1. Do not use a Deployment Plan without a Golden Image. A Deployment Plan without a Golden Image
cannot be used for OS deployment.
OS deployment using Image Streamer fails
Symptom
OS deployment using Image Streamer fails.
Cause
The Deployment Plan used for the OS deployment is invalid due to one or all of the following reasons:
•
•
The Plan Scripts used for the deployment are invalid and contain errors.
The connections created for the compute modules in the server profile are not valid.
•
•
•
Ensure the Plan Scripts used for the deployment are valid.
Ensure that the connections created for the compute modules in the server profile are valid.
Download the deployment logs from the Activity page on the Image Streamer user interface to check
for errors.
Action
Problems in the functioning of the Image Streamer
standby appliance
Symptom
The standby appliance is either unavailable or cannot be activated.
Solution 1
Cause
The synchronization between the active and standby appliances is in progress.
Action
1. No action required. Wait until the changes performed on the active appliance have synchronized with
the standby appliance.
Solution 2
Cause
The appliance bay where the standby appliance is present is not functioning.
62
OS deployment using Image Streamer fails
Action
1. Move the standby appliance to a different enclosure in the same interconnect link topology with a
similar configuration of the other standby appliances.
Solution 3
Cause
The standby appliance malfunctions.
Action
1. Replace the standby appliance.
Unable to access Image Streamer appliance from HPE
OneView
Symptom
Unable to access an Image Streamer appliance from HPE OneView.
Solution 1
Cause
The Image Streamer management network is not consistent with HPE OneView user interface settings.
Action
1. Check that the HPE OneView user interface network settings are not changed
Solution 2
Cause
The Image Streamer appliance is in the process of failover or reboot.
Action
1. Wait for the primary appliance to become active. A primary appliance may take approximately 15-20
minutes to become active.
OR
Action
1. If a secondary logical enclosure configured with an Image Streamer appliance exists, change the
primary appliance from the HPE OneView OS deployment server page.
Unable to include support dump for a standby Image
Streamer appliance
Symptom
The support dump created information only from the active appliance.
Unable to access Image Streamer appliance from HPE OneView
63
Cause
The support dump gets created only for the active appliance.
Action
1. Create a standby appliance support dump using the maintenance console of the standby appliance.
Unable to power on an Image Streamer appliance on a
remote enclosure in a multi-enclosure setup
Symptom
With a multi-enclosure setup, when you try to power on an Image Steamer appliance in a remote
enclosure, the following error message appears on the Enclosures screen in HPE OneView.
Figure 18: Error message when an Image Streamer appliance in a remote enclosure is powered on
Action
•
Power on the Image Streamer appliance manually.
An Image Streamer appliance available in a remote enclosure cannot be powered on using HPE
OneView.
64
Unable to power on an Image Streamer appliance on a remote enclosure in a multi-enclosure setup
Documentation and troubleshooting resources
for HPE Synergy
HPE Synergy documentation
The Hewlett Packard Enterprise Information Library (www.hpe.com/info/synergy-docs) is a task-based
repository. It includes installation instructions, user guides, maintenance and service guides, best
practices, and links to additional resources. Use this website to obtain the latest documentation, including:
•
•
•
•
•
Learning about HPE Synergy technology
Installing and cabling HPE Synergy
Updating the HPE Synergy components
Using and managing HPE Synergy
Troubleshooting HPE Synergy
HPE Synergy Configuration and Compatibility Guide
The HPE Synergy Configuration and Compatibility Guide is in the Hewlett Packard Enterprise Information
Library (www.hpe.com/info/synergy-docs). It provides an overview of HPE Synergy management and
fabric architecture, detailed hardware component identification and configuration, and cabling examples.
HPE OneView User Guide for HPE Synergy
The HPE OneView User Guide for HPE Synergy is in the Hewlett Packard Enterprise Information Library
(www.hpe.com/info/synergy-docs). It describes resource features, planning tasks, configuration quick
start tasks, navigational tools for the graphical user interface, and more support and reference information
for HPE OneView.
HPE OneView Global Dashboard
The HPE OneView Global Dashboard provides a unified view of health, alerting, and key resources
managed by HPE OneView across multiple platforms and data center sites. The HPE OneView Global
Dashboard User Guide is in the Hewlett Packard Enterprise Information Library (www.hpe.com/info/
synergy-docs). It provides instructions for installing, configuring, navigating, and troubleshooting the
HPE OneView Global Dashboard.
HPE Synergy Image Streamer User Guide
The HPE Synergy Image Streamer User Guide is in the Hewlett Packard Enterprise Information Library
(www.hpe.com/info/synergy-docs). It describes the OS deployment process using Image Streamer,
features of Image Streamer, and purpose and life cycle of Image Streamer artifacts. It also includes
authentication, authorization, and troubleshooting information for Image Streamer.
HPE Synergy Image Streamer GitHub
The HPE Synergy Image Streamer GitHub repository (github.com/HewlettPackard) contains sample
artifacts and documentation on how to use the sample artifacts. It also contains technical white papers
explaining deployment steps that can be performed using Image Streamer.
HPE Synergy Software Overview Guide
The HPE Synergy Software Overview Guide is in the Hewlett Packard Enterprise Information Library
(www.hpe.com/info/synergy-docs). It provides detailed references and overviews of the various
Documentation and troubleshooting resources for HPE Synergy
65
software and configuration utilities to support HPE Synergy. The guide is task-based and covers the
documentation and resources for all supported software and configuration utilities available for:
•
•
•
•
•
HPE Synergy setup and configuration
OS deployment
Firmware updates
Troubleshooting
Remote support
Best Practices for HPE Synergy Firmware and Driver Updates
The Best Practices for HPE Synergy Firmware and Driver Updates is in the Hewlett Packard Enterprise
Information Library (www.hpe.com/info/synergy-docs). It provides information on recommended best
practices to update firmware and drivers through HPE Synergy Composer, which is powered by HPE
OneView.
HPE OneView Support Matrix for HPE Synergy
The HPE OneView Support Matrix for HPE Synergy is in the Hewlett Packard Enterprise Information
Library (www.hpe.com/info/synergy-docs). It maintains the latest software and firmware requirements,
supported hardware, and configuration maximums for HPE OneView.
HPE Synergy Image Streamer Support Matrix
The HPE Synergy Image Streamer Support Matrix is in the Hewlett Packard Enterprise Information
Library (www.hpe.com/info/synergy-docs). It maintains the latest software and firmware requirements,
supported hardware, and configuration maximums for HPE Synergy Image Streamer.
HPE Synergy Glossary
The HPE Synergy Glossary, in the Hewlett Packard Enterprise Information Library (www.hpe.com/info/
synergy-docs), defines common terminology associated with HPE Synergy.
HPE Synergy troubleshooting resources
HPE Synergy troubleshooting resources are available within HPE OneView and in the Hewlett Packard
Enterprise Information Library (www.hpe.com/info/synergy-docs).
Troubleshooting within HPE OneView
HPE OneView graphical user interface includes alert notifications and options for troubleshooting within
HPE OneView. The UI provides multiple views of HPE Synergy components, including colored icons to
indicate resource status and potential problem resolution in messages.
You can also use the Enclosure view and Map view to quickly see the status of all discovered HPE
Synergy hardware.
HPE Synergy Troubleshooting Guide
The HPE Synergy Troubleshooting Guide is in the Hewlett Packard Enterprise Information Library
(www.hpe.com/info/synergy-docs). It provides information for resolving common problems and courses
of action for fault isolation and identification, issue resolution, and maintenance for both HPE Synergy
hardware and software components.
66
Best Practices for HPE Synergy Firmware and Driver Updates
HPE Error Message Guide for HPE Synergy
The HPE Error Message Guide for HPE Synergy is in the Hewlett Packard Enterprise Information Library
(www.hpe.com/info/synergy-docs). It provides information for resolving common problems associated
with specific error messages received for both HPE Synergy hardware and software components.
HPE OneView and HPE OneView REST API scripting help
The HPE OneView Help, the HPE OneView REST API Scripting Help, and the HPE OneView API
Reference are readily accessible, embedded online help available within the HPE OneView user
interface. These help files include “Learn more” links to common issues, as well as procedures and
examples to troubleshoot issues within HPE Synergy.
The help files are also available in the Hewlett Packard Enterprise Information Library (www.hpe.com/
info/synergy-docs).
HPE Synergy QuickSpecs
HPE Synergy has system specifications as well as individual product and component specifications. For
complete specification information, see the HPE Synergy and individual HPE Synergy product
QuickSpecs on the Hewlett Packard Enterprise website (www.hpe.com/info/qs).
HPE Error Message Guide for HPE Synergy
67
Websites
General websites
Hewlett Packard Enterprise Information Library
www.hpe.com/info/EIL
Hewlett Packard Enterprise Support Center
www.hpe.com/support/hpesc
Contact Hewlett Packard Enterprise Worldwide
www.hpe.com/assistance
Subscription Service/Support Alerts
www.hpe.com/support/e-updates
Software Depot
www.hpe.com/support/softwaredepot
Customer Self Repair
www.hpe.com/support/selfrepair
Product specific websites
HPE Synergy Documentation
www.hpe.com/info/synergy-docs
HPE Image Streamer github
www.github.com/HewlettPackard/
68
Websites
Support and other resources
Accessing Hewlett Packard Enterprise Support
•
For live assistance, go to the Contact Hewlett Packard Enterprise Worldwide website:
•
http://www.hpe.com/assistance
To access documentation and support services, go to the Hewlett Packard Enterprise Support Center
website:
http://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:
Hewlett Packard Enterprise Support Center
•
•
www.hpe.com/support/hpesc
Hewlett Packard Enterprise Support Center: Software downloads
www.hpe.com/support/downloads
Software Depot
www.hpe.com/support/softwaredepot
To subscribe to eNewsletters and alerts:
www.hpe.com/support/e-updates
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 HPE Passport set up with relevant
entitlements.
Support and other resources
69
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:
http://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.
If your product includes additional remote support details, use search to locate that information.
Remote support and Proactive Care information
HPE Get Connected
www.hpe.com/services/getconnected
HPE Proactive Care services
www.hpe.com/services/proactivecare
HPE Proactive Care service: Supported products list
www.hpe.com/services/proactivecaresupportedproducts
HPE Proactive Care advanced service: Supported products list
www.hpe.com/services/proactivecareadvancedsupportedproducts
Proactive Care customer information
Proactive Care central
www.hpe.com/services/proactivecarecentral
Proactive Care service activation
www.hpe.com/services/proactivecarecentralgetstarted
Warranty information
To view the warranty for your product, see the Safety and Compliance Information for Server, Storage,
Power, Networking, and Rack Products document, available at the Hewlett Packard Enterprise Support
Center:
www.hpe.com/support/Safety-Compliance-EnterpriseProducts
Additional warranty information
HPE ProLiant and x86 Servers and Options
www.hpe.com/support/ProLiantServers-Warranties
HPE Enterprise Servers
www.hpe.com/support/EnterpriseServers-Warranties
HPE Storage Products
www.hpe.com/support/Storage-Warranties
70
Customer self repair
HPE Networking Products
www.hpe.com/support/Networking-Warranties
Regulatory information
To view the regulatory information for your product, view the Safety and Compliance Information for
Server, Storage, Power, Networking, and Rack Products, available at the Hewlett Packard Enterprise
Support Center:
www.hpe.com/support/Safety-Compliance-EnterpriseProducts
Additional regulatory information
Hewlett Packard Enterprise is committed to providing our customers with information about the chemical
substances in our products as needed to comply with legal requirements such as REACH (Regulation EC
No 1907/2006 of the European Parliament and the Council). A chemical information report for this product
can be found at:
www.hpe.com/info/reach
For Hewlett Packard Enterprise product environmental and safety information and compliance data,
including RoHS and REACH, see:
www.hpe.com/info/ecodata
For Hewlett Packard Enterprise environmental information, including company programs, product
recycling, and energy efficiency, see:
www.hpe.com/info/environment
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.
Regulatory information
71
© Copyright 2026 Paperzz