Summary of Contents for HPE Synergy Image Streamer 5.2
Page 1
HPE Synergy Image Streamer 5.2 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.
Prepare Image Streamer for use..................................15 About adding Image Streamer devices to an existing Synergy configuration................. 16 Confirm Image Streamer discovery in HPE OneView......................16 About reclaiming the Image Streamer appliance........................16 When to create a management network for Image Streamer...................17 Add Image Streamer to a logical enclosure..........................
Page 4
Deployment Appliances......................................34 Primary deployment appliance................................34 Features..........................35 Stateless Experience........................................35 High Availability..........................................35 High availability for OS volumes................................ 35 High availability for appliance and artifact management....................35 Capture............................................... 36 Capture using the Image Streamer appliance..........................36 Application installation on stateless servers............. 37 Considerations for application installation..............................
Page 5
HPE OneView does not claim Image Streamer appliance after a reset..................85 OS deployment server creation fails due to communication issues between HPE OneView and Image Streamer.............................................85 Image Streamer appliance loses management network connectivity in single enclosure setup........86 OS deployment using Image Streamer fails..............................
Page 6
Support and other resources..................94 Accessing Hewlett Packard Enterprise Support............................94 Accessing updates........................................94 Remote support..........................................95 Warranty information......................................... 95 Regulatory information......................................95 Documentation feedback......................................96...
HPE Synergy compute modules. The Image Streamer appliance is managed by HPE OneView and must be in the same subnet as HPE OneView. To access the Image Streamer user interface, you must use single sign-on through HPE OneView.
Page 8
HPE Synergy Image Streamer Module (OS Deployment Server) User Interface and API Image Streamer Management Application Solid State Drive (SSD) with two partitions Repository partition File System, Binaries, Database, and Artifacts (Plan Scripts, OS Build Plans, Golden Images, and Deployment Plans)
If required, when the HPE OneView server profile defines the OS volume personalization, it can also define the storage that is assigned to the compute module. The storage may be HPE Synergy D3940 Storage Module drives or it may be external NAS or SAN storage.
Golden Image or installed during the personalization process. When application customization is required at the time of deployment, Plan Scripts that are referenced by the HPE OneView server profile can be used to define the customization as part of the OS volume personalization.
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.
Page 12
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.
Page 13
The Deployment Plan specifies the Build Plan and Golden Image to use for the deployments. A server profile is created by the administrator using HPE OneView whenever a Golden Image deployment is needed for use with server compute and memory resources. The server profile specifies the Deployment Plan to use for a specified compute module.
Page 14
Creates the artifacts and the custom attributes in the appliance using REST API or user interface. Server administrator Specifies the OS deployment settings using the HPE OneView server profiles. Use the sample artifacts provided by Hewlett Packard Enterprise for OS deployment or to help development of customized artifacts.
HPE Synergy configuration is already completed. IMPORTANT: Once you install the appliance in an HPE Synergy frame and power on for the first time, wait for the HPE Synergy Image Streamer login screen to appear before you start reimaging the appliance. Waiting for the HPE Synergy Image Streamer login screen to appear ensures that the reimaging code that is required for subsequent reimaging of the appliance is installed successfully.
About reclaiming the Image Streamer appliance Any Image Streamer appliance inserted into an appliance bay must be claimed by HPE OneView before it can be used for OS deployment. Once you insert an Image Streamer appliance into an appliance bay, HPE OneView attempts to claim the appliance.
If the Image Streamer appliance has not been claimed by HPE OneView earlier because it was used in a different HPE Synergy Composer domain or because the Composer has been reimaged, a dialog box prompts you to enter the credentials. Once you enter the correct credentials that were set in the previously claimed HPE Synergy Composer domain, the Image Streamer appliance is reset and the claim process is initiated.
Accessing Image Streamer documentation and help This chapter describes how to access help from the appliance, how to access the publicly available online information library, and where to find REST API reference documentation. Online help The context-sensitive online help focuses on task information and includes: •...
Using Image Streamer user interface or REST API scripts Image Streamer makes OS deployment possible through either a user interface or by using REST (REpresentational State Transfer) APIs. Image Streamer user interface The Image Streamer is user-friendly, visually intuitive, and menu-driven to guide you through daily tasks. It provides alerts and activities to provide progress and status.
You can modify the custom attribute default values in OS Build Plans, and Deployment Plans in Image Streamer and specify the final values to be used 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. Specify the custom attribute name and optionally, the value in the Plan Script.
OS Build Plans, Deployment Plans, and server profiles in HPE OneView. You can use Deployment Plans to control the custom attributes that are visible to the server profile and those that are read-only. 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@.
Page 22
Constraints for a 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 and $ as the ending character. Minimum length Minimum number of characters required.
Page 23
• Unteamed Teamed NIC attributes Teamed network connections are used to ensure that servers have continuous network connectivity during HPE Synergy maintenance operations. They are also used to provide increased availability. Teamed NIC attributes can contain the following parameters: Artifacts...
Page 24
• ipaddress1 - This parameter is mandatory when you use mac1 parameter. • ipaddress2 • mac1 - If the mac1 attribute is not set to any value, it expands to none in the Plan Script. • mac2 - If the mac2 attribute is not set to any value, it expands to none in the Plan Script. •...
Page 25
IP configuration. If static IP configuration is allowed, you can enter the static IP configuration or it can be allocated from a pool if HPE OneView has an IP pool for the network.
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. To enable DHCP mode in the server profile, select DHCP as the IPv4 configuration.
• References to other custom attributes in a custom attribute value are not supported. • NIC custom attributes cannot have default values. System attributes Image Streamer allows you to access the OS volume and iSCSI initiator details using system attributes in Plan Scripts. System attributes have a similar syntax as that of custom attributes.
About OS Build Plans An OS Build Plan specifies an execution sequence for the Plan Scripts to add, modify, or delete server-specific content of an OS volume. Deploy type Build Plans clone a Golden Image to create an OS Volume and modify the contents of the OS volume to personalize for a specific compute module based on settings specified in the server profile.
Page 29
Figure 5: Life cycle of a Golden Image Table 3: Golden Image life cycle sequence of events Sequence Operation Description Adds a Golden Image from your laptop. Capture Creates a Golden Image either from a deployed server or from an OS volume. Table Continued Artifacts...
Golden Images or by customizing the OS Build Plans. 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.
The factory-provided artifact bundles are created while creating the OS deployment server on the primary Image Streamer appliance. You can view the factory-provided artifact bundles on the Artifact Bundles screen after creating an OS deployment server using HPE OneView. Foundation bundle The foundation artifact bundle consists of artifacts that enable you to perform basic Image Streamer operations.
The support artifact bundle consists of artifacts that enable you to validate deployment and capture features of the Image Streamer appliance using a sample Golden Image. The sample Golden Image (HPE - Support 1.0 - UEFI Test Image - <date>) provided in the Support artifact bundle requires UEFI support.
OS volumes and Image Streamer deployment HPE Synergy Image Streamer creates OS volumes as a result of the deployment process. An OS volume is associated with an HPE OneView server profile and can be assigned to a physical server as needed. Image Streamer preserves OS volumes whenever possible when server profiles are assigned to physical servers, unassigned from the server hardware, and moved between servers.
Image Streamer appliance. When an Image Streamer appliance is inserted in the CIM slot, a claim process is triggered in HPE OneView. You can view the claim status of the Image Streamer appliance in the Activity screen in HPE OneView user interface. If HPE OneView fails to claim the Image Streamer appliance, an alert on the Enclosures screen in HPE OneView user interface notifies you about the error.
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.
• A minimum of three frames are required for a pair of Image Streamer appliances. • In the frame 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.
• Local storage SATA drives typically have 6 Gb/s bandwidth. • HPE Synergy D3940 Storage Module has 12 Gb/s bandwidth, but may only function at 6 Gb/s with some drives. For more information, see the storage module QuickSpecs. • External NAS and SAN storage can vary depending on the network adapters, configuration, and traffic.
Option 3: Compute module local storage The recommendation for application installation varies depending on the type of storage that is configured for the compute module in HPE OneView server profile. • In a stateless server environment, any existing local storage must be used only for temporary files such as swap files, page files, and as a location for support dumps.
NOTE: HPE Synergy D3940 Storage Module volumes can only be accessed by compute modules in the same frame. If the installed applications, configuration files, or data require access from compute modules in other frames, either now or in the future, they must be installed and stored on storage external to the frame.
Appliance management Reimaging Image Streamer • Preparing a USB flash drive • Reimaging the appliance module with the preloaded USB drive Preparing a USB flash drive Prerequisites IMPORTANT: Hewlett Packard Enterprise recommends that you prepare a USB flash drive immediately after installing and after updating the appliance module firmware so that you always have a USB flash drive that matches the currently installed version of the appliance module image.
First and last block: default values 5. Download the firmware image .zip file and the corresponding .md5 file from the Hewlett Packard Enterprise website (http://www.hpe.com/downloads/Synergy). The firmware image that you download must match the version determined in step 1. Make sure that you download the complete image for recovery for the USB.
Page 42
Item Description USB ports in the appliance module 3. Connect to the HPE Synergy Console to monitor the reimaging and rebooting operations: a. Connect a keyboard, video, and mouse to the DisplayPort and USB ports on either: • The front panel of the frame •...
Page 43
6. Release the pinhole button as soon as you see the flashing Active LED. If connected, the HPE Synergy Console shows progress messages. The front panel UID flashes blue throughout the reimage process. After reimaging, the appliance module reboots, updates the firmware to the version stored on the preloaded USB drive, and starts oneview.mgmt.software.
When an appliance module is removed from the CIM slot, it might take up to 80 minutes for the removal operation to • complete. You can track the progress of the removal operation on the SERVERS > Enclosures screen in HPE OneView. Wait until the removal operation is complete before inserting a repaired or another appliance module in the same CIM slot.
Page 45
This alert indicates that the appliance module removal operation has started. The resolution message mentions a user action to insert an appliance module but do not insert an appliance module until the removal operation completes successfully. • When the appliance module removal operation is in progress, ignore the following alert that appears in the Deployment Appliances screen in the Image Streamer user interface.
Do not remove the appliance until the insert operation is complete because it might interrupt cluster formation. You can track the progress of the insert operation on the SERVERS > Enclosures screen in HPE OneView user interface.
Page 47
• When the same appliance that was removed earlier is reinserted, the reinserted appliance undergoes a factory reset and powers off. Then, you must click the Factory Reset link on the SERVERS > Enclosures screen in HPE OneView user interface.
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: The Insert Image Streamer Appliance or Remove Image Streamer Appliance tasks on the SERVERS > Enclosures •...
You can verify the Image Streamer appliance cluster status and OS volume status using the Deployment Appliances screen in Image Streamer user interface. For instructions on how to update Image Streamer to a new version, see HPE Synergy Image Streamer Help. Update process The process of updating an Image Streamer appliance pair proceeds in the following sequence: 1.
Select Deployment Groups > Actions > Download backup bundle to download the backup bundle to the local machine. You can use it to restore the artifacts later. From the HPE OneView main menu, select SERVERS > Server Profiles > Actions > Edit OR select SERVERS > Server Profile Templates > Actions > Edit.
Page 51
12. From the HPE OneView main menu, select SERVERS > Server Profiles > Actions > Edit to edit the server profiles OR select SERVERS > Server Profile Templates > Actions > Edit to edit server profile templates that use OS Deployment Plans.
Update scenarios During an attempt to update the appliance, the following scenarios may occur: Update of active and standby appliances is successful • Update attempt returns a validation error • • Active appliance update fails • Storage update fails during the active appliance update •...
You can back up all the artifacts in Image Streamer by using the Image Streamer user interface. The backup bundle contains all the artifacts that are available on the Image Streamer appliance at the time of backup. See HPE Synergy Image Streamer Help for instructions on creating a backup bundle for artifacts.
Page 54
When the Image Streamer primary appliance pair fails or is decommissioned and there is a secondary appliance pair available in the enclosure, contact your authorised support representative to change the primary Image Streamer appliance pair. For information on how to change the primary Image Streamer appliance pair, see HPE OneView Help for HPE Synergy.
Page 55
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 Help.
Image Streamer appliance claim and reset Any Image Streamer appliance inserted into a CIM slot must be claimed by HPE OneView before it can be used for OS Deployment. Once you insert an Image Streamer appliance into a CIM slot, HPE OneView attempts to claim the appliance.
Page 57
NOTE: The icons next to the Image Streamer appliances on the SERVERS > Enclosures screen indicate if the appliance is powered on and if there are any hardware issues. It does not indicate if the HPE OneView claim of Image Streamer appliance is completed successfully.
About the support dump The support dump contains data that might be considered customer sensitive such as hostnames, IP addresses, and the appliance audit log. Unless you specify otherwise, all data in the support dump file is encrypted so that only an authorized technical support person can access it.
The appliance maintenance console, shown in the example, provides a limited set of administrative commands for an appliance. The appliance maintenance console is an important tool for troubleshooting appliance issues when the HPE OneView UI or Image Streamer UI is not available.
• Appliance is starting up, shutting down, restarting, or temporarily unavailable • Appliance is being reset to factory default settings The body of the main menu contains commands that can be used as displayed in the previous screenshot. The commands displayed by the Maintenance console depend on the current state of the appliance and how the Maintenance console was accessed.
Page 61
On either HPE Synergy Frame Link Module on the rear of the frame On connection, the Synergy console is displayed. 2. On the HPE Synergy Console, select Actions > Serial consoles > Appliances and choose the appliance you want to access.
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.
Also, after an upgrade the maintenance console password is not in sync. After an upgrade to HPE OneView, you must set or change the password to have it propagated to FLM.
Page 64
Screen component Description Title Identifies the appliance 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.
Appliance maintenance console details screen details The View Details command displays this screen. References to the local appliance indicate the appliance that you logged into through the appliance maintenance console. Peer appliance refers to the other appliance, regardless of its role, in an appliance cluster. Screen component Description Title...
Screen component Description Firmware The version number of the firmware running on the Image Streamer appliance and the date the firmware was last updated. Appliances For an appliance cluster, the following items are displayed first for the local appliance and then for the peer appliance.
Page 67
State Situation Action Active The local appliance is running normally. Standby is synchronizing The peer appliance is being synchronized. It cannot be activated if a failure occurs before the synchronization completes. Active The local appliance is running normally but cannot See the alerts listed in the Activity screen for more details reach the peer appliance.
State Situation Action Temporarily unavailable The local appliance is in a transition, and its state will change. Updating The local appliance is undergoing a software update. 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.
Reset the administrator password with the appliance maintenance console IMPORTANT: The request code is valid only while you are on the Password reset screen of the appliance maintenance console. If you return to the main menu or end the appliance maintenance console session, the request code will be invalid.
The support specialist 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. 4. Type the authorization code into the response field. 5.
Create a support dump file from the appliance maintenance console This procedure describes how to use the appliance maintenance console to create a support dump file from the local appliance (the appliance on which the appliance 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.
Use either of the following options to change the MGMT port purpose from deployment traffic to management traffic: • Connect the MGMT port of the Frame Link Module in the frame which has both Image Streamer and HPE OneView appliances to the management network. •...
Maintenance console of an active Image Streamer appliance. Procedure 1. Connect to HPE OneView using the serial console and confirm if HPE OneView is functional. If HPE OneView is in the process of starting or failover, wait for the process to complete.
Maintenance console of an active Image Streamer appliance. Procedure 1. Connect to HPE OneView using the serial console and confirm if HPE OneView is functional. If HPE OneView is in the process of starting or failover, wait for the process to complete.
Manual activation of an appliance The Activate option is available in the maintenance console main menu when user intervention is required 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.
This chapter discusses about the security aspects of Image Streamer. 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. •...
HPE OneView instances. Artifact developers might require special consideration as they may frequently create new artifacts, and want to test deployment on servers. These operations require configuring scope and permission to modify a wide set of HPE Synergy resource types.
◦ Leaf-level certificates: – Self-signed certificates: These certificates get added to the appliance trust store during HPE OneView claim process and configuration of secondary Image Streamer appliances. Unlike CA signed certificates, self-signed certificates are not subject to host name verification or revocation checks.
DigiCert Root CA - DigiCert Global Root G2 • DigiCert Intermediate CA - DigiCert Global CA G2 See Locate CRL Distribution Points in the HPE OneView Help for HPE Synergy provides details on how to locate the CRL DPs for these certificates. Certificate status checks Image Streamer performs periodic status checks on certificates.
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...
Page 81
• 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. Security...
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.
When the enclosure is powered on after a downtime, the compute module powers on immediately, but the Image Streamer appliance requires 15-20 minutes to boot. During this time, HPE iLO does not add the OS volume to the booting sequence. If you attempt to boot the compute module before Image Streamer is ready, the boot fails or causes the compute module to wait in PXE boot mode.
Delete the failed OS deployment server. b. Factory reset the appliance using the link on the SERVERS > Enclosures screen in HPE OneView. c. Create a new OS deployment server using the Create option in the APPLIANCE > OS Deployment Servers screen in HPE OneView user interface.
After you perform a factory reset of the Image Streamer appliance using the maintenance console, HPE OneView does not claim the Image Streamer appliance. You can identify this because the claim task on the Activity screen in HPE OneView user interface is not listed.
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 See MGMT port repurpose for a single enclosure setup. OS deployment using Image Streamer fails Symptom OS deployment using Image Streamer fails.
The appliance bay where the standby appliance is present is not functioning. Action 1. Check for appliance bay error messages in the Activity screen of HPE OneView user interface. 2. Move the standby appliance to a different enclosure in the same interconnect link topology with a similar configuration of the other standby appliances.
This issue occurs in a multi-enclosure setup. When the Image Streamer appliance is in a remote enclosure and you manually power on the appliance, the following error message appears on the Enclosures screen in HPE OneView. Unable to get the server power state from the management processor. Unable to access the iLO from the HPE OneView Appliance.
HPE Synergy documentation resources The Hewlett Packard Enterprise Information Library (https://www.hpe.com/info/synergy-docs) provides a comprehensive, one stop location for all HPE Synergy documentation, including installation instructions, user guides, maintenance and service guides, best practices, and links to additional resources. The Library supports filtering to improve findability.
Information on how to update the firmware and recommended best practices to update Guide firmware and drivers through HPE OneView. The HPE Synergy Software Release Information site (https://www.hpe.com/info/synergy-sw-release-information) provides an interactive resource for firmware update information. HPE Synergy firmware update resources are also available within HPE OneView. HPE Synergy documentation resources...
Page 91
A list of HPE Synergy Management Combinations to use to compare HPE Synergy Custom SPPs supported by the selected HPE Synergy Management Combination. Firmware Feature Table A list of firmware features to use to compare HPE Synergy Custom SPPs supported by the selected HPE Synergy Management Combination. Upgrade Paths Table Information on HPE Synergy Composer and HPE Synergy Image Streamer upgrade paths and HPE Synergy Management Combinations.
HPE Synergy 12000 Frame Setup and Installation • Product maintenance and service guides Guide • HPE OneView for HPE Synergy Firmware and Driver Update • Rack Rails Installation Instructions for the HPE Guide Synergy 12000 Frame (included with frame) •...
• To download product updates: Hewlett Packard Enterprise Support Center https://www.hpe.com/support/hpesc Hewlett Packard Enterprise Support Center: Software downloads https://www.hpe.com/support/downloads My HPE Software Center https://www.hpe.com/software/hpesoftwarecenter • To subscribe to eNewsletters and alerts: https://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: https://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. 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 is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hpe.com). When submitting your feedback, include the document title, part number, edition, and publication date located on the front cover of the document.
Need help?
Do you have a question about the Synergy Image Streamer 5.2 and is the answer not in the manual?
Questions and answers