Page 1
Spectra BlackPearl Deep Storage Gateway User Guide SpectraLogic.com...
Page 2
BlackPearl, BlueScale, CC, Spectra, SpectraGuard, Spectra Logic, TeraPack, TFinity, TranScale, and Verde are registered trademarks of Spectra Logic Corporation. ArchiveGrade, ArcticBlue, and Verde DPE are trademarks of Spectra Logic Corporation. All rights reserved worldwide. All other trademarks and registered trademarks are the property of their respective owners. Part Number 90990093 Revision F Revision History Revision Date Description October 2014 Initial release. January 2015 Second release. February 2015 Updated for the BlackPearl 1.1 release. May 2015 Updated for the BlackPearl 1.1.1 release. August 2015 Updated for new BlackPearl 2.0 chassis. December 2015 Updated for the BlackPearl 3.0 release. Note: To make sure you have the most current version of this guide check the Spectra Logic Technical Support portal at support.spectralogic.com/documentation/user‐guides/. To make sure you have the release notes for the most current version of the BlackPearl Release Notes, check the Spectra Logic Technical Support portal at support.spectralogic.com/documentation/release‐notes/. You must sign into the portal before viewing Release Notes. The release notes contain updates to the User Guide since the last time it was revised. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 3
No Liability for Certain Damages. Except as prohibited by law, Software suppliers shall have no liability for any indirect, special, consequential or incidental damages arising from or in connection with the use or performance of the Software. This limitation shall apply even if any remedy fails of its essential purpose. In no event shall Software suppliers, individually, be liable for any amount in excess of U.S. two hundred fifty dollars (U.S. $250.00). Limitations on Reverse Engineering, Decompilation, and Disassembly. You may not reverse engineer, decompile, or disassemble the Software, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation. Software Transfer Allowed with Restrictions. You may permanently transfer rights under this EULA only as part of a permanent sale or transfer of the Spectra product, and only if the recipient agrees to this EULA. If the Software is an upgrade, any transfer must also include all prior versions of the Software. Export Restrictions. Export of the Software from the United States is regulated by the Export Administration Regulations (EAR, 15 CFR 730‐744) of the U.S. Commerce Department, Bureau of Export Administration. You agree to comply with the EAR in the export or re‐export of the Software: (i) to any country to which the U.S. has embargoed or restricted the export of goods or services, which as May 1999 include, but are not necessarily limited to Cuba, Iran, Iraq, Libya, North Korea, Sudan, Syria, and the Federal Republic of Yugoslavia (including Serbia, but not Montenegro), or to any national or any such country, wherever located, who intends to transit or transport the Software back to such country; (ii) to any person or entity who you know or have reason to know will utilize the Software or portion thereof in the design, development or production of nuclear, chemical, or biological weapons; or (iii) to any person or entity who has been prohibited from participating in U.S. export transactions by any federal agency of the U.S. government. You warrant and represent that neither the BXA nor any other U.S. federal agency has suspended, revoked or denied your export privileges. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 4
Mexico, Central and South America, Asia, Australia, and New Zealand Phone: 1.303.449.0160 Spectra Logic Sales Website: www.spectralogic.com/shop United States and Canada Europe Phone: 1.800.833.1132 or 1.303.449.6400 Phone: 44 (0) 870.112.2150 Fax: 1.303.939.8844 Fax: 44 (0) 870.112.2175 Email: sales@spectralogic.com Email: eurosales@spectralogic.com To Obtain Documentation Spectra Logic Website: support.spectralogic.com/documentation December 2015 User Guide—Spectra BlackPearl Gateway...
About This Guide ® This guide describes how to configure, monitor, and maintain the Spectra ® BlackPearl Deep Storage Gateway, sometimes referred to as the gateway in these instructions. It also provides product specifications. NTENDED UDIENCE This guide is intended for data center administrators and operators who maintain and operate file storage systems. The information in this guide assumes a familiarity with computing terminology and with network connectivity protocols such as SAS, Fibre Channel, and Ethernet. You also need to be familiar with installing, configuring, and using data file storage and archival software. LACK EARL NTERFACE CREENS The BlackPearl user interface changes as new features are added or other modifications are made between software revisions. Therefore, the screens you see in the BlackPearl user interface may differ from those shown in this guide. ELATED NFORMATION This section contains information about this document and other documents related to the Spectra BlackPearl gateway.
Informationen, die Sie kennen müssen, um Personenschäden zu vermeiden. This guide uses an arrow (>) to describe a series of menu selections. For example: Select Configuration > Network. — means — Select Configuration, then select Network. Related Publications For additional information about the Spectra BlackPearl gateway and the Spectra S3 interface, refer to the publications listed in this section. Spectra BlackPearl Gateway The following documents related to the Spectra BlackPearl gateway are available on the Support Portal website at support.spectralogic.com, and from the Documentation screen on the BlackPearl user interface. The Spectra BlackPearl Site Preparation Guide provides important information that you should know before installing a BlackPearl gateway in your storage environment. The Spectra BlackPearl RackMount Installation Guide provides detailed instructions for installing the BlackPearl gateway in a standard rack. The Spectra BlackPearl Network Setup Tips document provides helpful instructions for troubleshooting common connectivity problems. The Spectra BlackPearl Spectra S3 API Reference provides information on understanding and using the Spectra S3 API. December 2015 User Guide—Spectra BlackPearl Gateway...
The Spectra 12‐, 36‐ & 45‐Drive Chassis Drive Replacement Guide provides instructions for replacing a failed data drive after the gateway is installed. The Spectra 12‐, 36‐ & 45‐Drive Chassis Fan Replacement Guide provides instructions for replacing a failed fan in the gateway. The Spectra 12‐, 36‐ & 45‐Drive Chassis Power Supply Replacement Guide provides instructions for replacing a failed power supply after the gateway is installed. The Spectra 12‐Drive Chassis HBA Replacement Guide and Spectra 36‐Drive Chassis HBA Replacement Guide provide instructions for replacing a failed HBA in the gateway. The Spectra 96‐Drive Chassis Drive Replacement Guide provides instructions for replacing a failed data drive in the ArcticBlue™ expansion node. The Spectra 96‐Drive Chassis Fan Replacement Guide provides instructions for replacing a failed fan in the ArcticBlue expansion node. The Spectra 96‐Drive Chassis Power Supply Replacement Guide provides instructions for replacing a failed power supply in the ArcticBlue expansion node. The Spectra 96‐Drive Chassis I/O Module Replacement Guide provides instructions for replacing a failed I/O module in the ArcticBlue expansion node. NLINE ORUM Need help with Spectra Logic’s S3 software development kits or the Spectra S3 API? Post your question at the Spectra Logic S3‐SDK discussion forum located at: https://developer.spectralogic.com/forums December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Product Overview This chapter provides an overview of the Spectra Logic BlackPearl Deep Storage Gateway features and components. Topic Overview page 14 Features page 15 Components page 17 Front View page 17 Rear View page 19 Rear Panel page 21 Front View of the ArcticBlue Expansion page 23 Node Rear View of the ArcticBlue Expansion page 24 Node BlackPearl User Interface page 24 Menus page 25 Status Icons page 28 Supported Browsers...
BlackPearl expansion nodes as storage domain targets. Up to two BlackPearl expansion nodes can be connected to a BlackPearl 2U gateway. BlackPearl User Interface The BlackPearl user interface is used to perform configuration and management tasks on the BlackPearl gateway. It also lets you monitor the hardware and view system messages. The BlackPearl user interface also provides monitoring and control of some aspects of an attached Spectra Logic tape library. Easy Network-Based Administration The BlackPearl gateway can be configured over an Ethernet network using a standard web browser. Integration with a Spectra Logic Tape Library Fibre Channel and SAS HBAs can be installed to provide connectivity to a Spectra Logic tape library. LTFS Format The BlackPearl gateway with a Spectra Logic tape library, ® writes data on tape in the open Linear Tape File System (LTFS) format to ensure you are always able to access it. Mirrored Boot Drives The operating system is hosted on two mirrored drives. Rack-Mount Hardware The BlackPearl chassis are designed to mount in a ...
Chapter 1 — Product Overview Features Spectra S3 Clients Users can leverage a library of existing Spectra S3 clients available through the Spectra Logic Developer Program, or develop their own client. The user moves data through the client to the BlackPearl gateway and then the gateway handles all interaction with the tape library. Spectra S3 Interface The Spectra S3 interface is a data transport and communication interface that allows software clients to direct and manage ʺbulkʺ storage read or write operations of data objects. The first implementation supports bulk object storage operations with tape for accessibility to the lowest cost media option. 10 Gigabit Ethernet A dual port, 10 Gigabit Ethernet (10 GigE) network interface card is installed to provide high‐speed data connections between hosts and the BlackPearl gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
Latch Data drive status LEDs Power button and Data drives system status LEDs Figure 1 The front view of the BlackPearl 4U gateway (front bezel removed). Visual Status Beacon control sled Latch Data drive status LEDs Data drives Power button and system status LEDs Figure 2 The front view of the BlackPearl 2U gateway (front bezel removed).
Page 18
Beacon control sled Power button The power button controls the main AC power for the BlackPearl gateway. System status LEDs The status LEDs indicate power status, disk and network activity, as well as hardware faults. See System Status LEDs on page 97 for more information. The base BlackPearl 4U gateway includes one high‐performance solid‐state Data drives drive, and five spinning‐disk drives mounted on individual drive sleds in the front of the chassis. Additional drives are installed in the rear of the chassis. The BlackPearl 2U gateway includes ten spinning‐disk drives in the front of the chassis. The drive sleds slide into bays in BlackPearl enclosure and lock in place. The front of each drive sled has a handle for removing the sled from the chassis and a latch for locking the drive sled in place. Data drive status Two LEDs on each drive sled indicate the status of the drive. One LED is for LEDs drive status while the other shows drive activity. Empty drive sleds are installed in the unused drive bays to prevent Empty drive sleds contaminants from entering the enclosure and to maintain proper air flow. December 2015 User Guide—Spectra BlackPearl Gateway...
174. Power supplies Rear panel Boot drives Data drives Figure 3 The rear view of the BlackPearl 4U gateway. Rear panel Power supplies Boot drives Figure 4 The rear view of the BlackPearl 2U gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 20
Rear panel The rear panel of the BlackPearl gateway allows for Ethernet, Fibre Channel, SAS, USB, and other connections. See Rear Panel on page 21 for a detailed description. Boot drives The boot drives provide storage for the operating system and BlackPearl user interface. The boot drives in the BlackPearl gateway are hot swappable which allows for uninterrupted operation during replacement. Data drives The base BlackPearl 4U gateway includes one high‐performance solid‐state (BlackPearl 4U drive, and five spinning‐disk drives mounted on individual drive sleds in the gateway only) rear of the chassis. Additional drives are installed in the front of the chassis. The drive sleds slide into bays in the BlackPearl enclosure and lock in place. The front of each drive sled has a handle for removing the sled from the chassis and a latch for locking the drive sled in place. The BlackPearl 2U gateway does not have data drives in the rear of the Note: chassis. Empty drive sleds are installed in the unused drive bays to prevent Empty drive sleds contaminants from entering the enclosure and to maintain proper air flow. (BlackPearl 4U gateway only) December 2015 User Guide—Spectra BlackPearl Gateway...
IPMI management port Ethernet ports (2) connector Optional SAS ports (4) Serial BlackPearl Expansion port ports (4) management port slots Figure 5 The BlackPearl rear panel components. Component Description Not currently supported. IPMI management port 10GBase-T The BlackPearl gateway includes two 10GBase‐T ports. One of the 10GBase‐T Ethernet ports ports can be used for network connectivity on a 10GBase‐T network. The left port of the two 10GBase‐T ports is dedicated as the BlackPearl management port and cannot be used for data transfer.
Page 22
BlackPearl expansion nodes. A two‐port SAS card provides connectivity to up to two ArcticBlue expansion nodes. Fibre Channel ports Depending on your configuration, there may be a Fibre Channel card installed (optional, in an available expansion slot. The Fibre Channel card provides connectivity to not shown) Fibre Channel drives in a Spectra Logic tape library. Expansion slots The expansion slots accommodate optional interface cards to provide additional connectivity. An installed 10 Gigabit Ethernet network interface card provides high‐speed data connection between hosts and the BlackPearl gateway. An optional four‐port SAS or Fibre Channel card provides connectivity between the BlackPearl gateway and tape drives in a Spectra Logic tape library, or provides connectivity for up to two BlackPearl expansion nodes. An optional two‐port SAS card provides connectivity to up to two ArcticBlue expansion nodes. The BlackPearl management port is used to connect to a browser‐based user BlackPearl interface to configure, manage, and monitor the BlackPearl gateway. The management port BlackPearl management port cannot be used for data transfer. USB ports If necessary, you can use these ports to connect a USB drive, or USB keyboard to the chassis for troubleshooting purposes. Only connect a USB drive or keyboard as directed by Spectra Logic Technical Support. Serial port Not currently used. December 2015 User Guide—Spectra BlackPearl Gateway...
Front View of the ArcticBlue Expansion Node Figure 6 shows the major components on the front of the ArcticBlue expansion node. Figure 6 The front view of the ArcticBlue expansion node (Visual Status Beacon removed). Component Description The front bezel mounts on the front of the expansion node, and contains the Front bezel Visual Status Beacon light bar, which provides status information for the (not shown) expansion node. See Front Bezel Visual Status Beacon on page 78 for more information. December 2015 User Guide—Spectra BlackPearl Gateway...
Figure 7 The rear view of the ArcticBlue expansion node. Component Description Five hot‐swappable fans provide the cooling for the ArcticBlue expansion node. Fans Power supplies The ArcticBlue expansion node includes two power supplies to provide N+1 redundancy and fail‐over protection. Each power supply has its own AC power connector. Each power supply has a single LED that lights to indicate when the power is on and functioning normally. SAS connectors The rear panel of the ArcticBlue expansion node has two SAS ports used to connect an expansion node to a BlackPearl gateway. LACK EARL NTERFACE The BlackPearl user interface provides browser‐based configuration, management, and monitoring of the BlackPearl gateway. The following sections describe the common features that appear in all screens in the user interface. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 1 — Product Overview BlackPearl User Interface Menus The menu bar appears along the top edge of each screen. Use the menu bar drop‐down menus to navigate through the interface. Menu Status Power Alerts Figure 8 The Dashboard screen of the BlackPearl user interface. The following table provides an overview of the screens available under each menu. Menu Available Options The Dashboard navigation link returns you to the Dashboard screen from any other Dashboard screen in the interface. The Dashboard screen displays the general status of the gateway, tape cache, and network connections. Clicking any of the panes on the Dashboard takes you to a details screen for that selection. The Dashboard screen also displays performance metrics for the gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 26
Mail Recipients—Provides controls for configuring mail recipient accounts to receive emails when a message severity threshold is reached, or when AutoSupport Log sets (ASLs) are generated by the gateway. Users—Provides controls for creating new S3 user accounts that act as owners for buckets, editing the login password, and displaying the S3 credentials for each user. The Status menu provides access to the tools for monitoring the BlackPearl gateway Status in your environment. Hardware—Displays information about the gateway, its components, and the tape drives installed in the Spectra Logic tape library. Selecting the tabs on the Hardware screen displays detailed component status information. Tape Management—Provides controls for managing the tape media in the Spectra Logic tape library connected to the BlackPearl gateway. S3 Jobs—Displays information about the status of all S3 jobs currently being processed by the system Messages—Displays system messages for the system. Performance—Displays performance metrics for the tape cache, individual drives, network connections, and the CPUs in the integrated server. Reports—Provides controls for generating reports about the configuration and (JavaScript status of the gateway. Reports can be generated in XML or JSON Object Notation) formats. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 27
Activation Keys—Provides controls for entering activation keys. Logs—Displays any current ASL sets on the gateway and provides controls for generating a new log set. Documentation—Displays BlackPearl documentation that is present on the system. Contact Information—Displays contact information for Spectra Logic Technical Support, as well as the part and serial numbers for the gateway. Tools—Displays tools to troubleshoot any internal or external server cabling errors. Logout Logs the current user out of the BlackPearl user interface and returns to the login screen. The information in the following table can be found on the Status bar, located at the bottom of all screens. Status Bar Available Options Hardware Provides an at‐a‐glance status of the overall health of the BlackPearl gateway. Clicking this link takes you to the Hardware screen. Messages Displays the severity, date, and time of the last informational, warning, or error message that was generated. Clicking this link takes you to the Messages screen. Note: This link does not display if there are no current system messages. Power Provides controls for rebooting and shutting down the gateway. Note: The connection to the user interface is lost after running the reboot command. Wait while the gateway reboots before attempting to reconnect to the user interface. December 2015 User Guide—Spectra BlackPearl Gateway...
Error A system component experienced an error condition. Check messages to determine the component and its error condition. Unknown The status of a system component cannot be determined. Check messages to determine the component and its status. Supported Browsers The BlackPearl user interface supports the following standard web browsers: Google ® Chrome™ version 20 or later Mozilla ® ® FireFox version 13 or later Apple ® ® Safari version 5 or later Microsoft ® ® Internet Explorer version 8 or later Note: Spectra Logic recommends using Google Chrome to access the BlackPearl user interface. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Initial Configuration This chapter describes the initial setup of the Spectra BlackPearl Deep Storage Gateway, necessary for operation in your environment. Task Before You Begin page 29 Connect Ethernet Cables page 30 Power On the Gateway page 30 Configure the BlackPearl Management Port page 31 Log Into the BlackPearl User Interface page 32 Enter Activation Keys page 34 Configure the Data Connection page 35 Create a User page 37 View S3 Credentials page 38 Configure the Cache page 39 Next Steps page 41 EFORE EGIN Make sure the gateway is installed in accordance with the Spectra ...
ABLES Before proceeding with the below sections, you must connect Ethernet cables to the management and data ports on the BlackPearl gateway rear panel. See Rear Panel on page 21 for the location of the Ethernet ports on the rear of the gateway. OWER N THE ATEWAY To power on a BlackPearl gateway, remove the front bezel and then gently press the power button on the front panel. The power LED illuminates indicating that power is on. See System Status LEDs on page 97 for more information Power button Power LED Figure 9 Press the power button. Wait while the BlackPearl gateway completes its power‐on sequence, which takes approximately 5 to 10 minutes, depending on the configuration. During the power‐on sequence, the system initializes all of its installed components. Note: Do not use the gateway’s front panel power button to power down the gateway. See Reboot or Shut Down a BlackPearl Gateway on page 120. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 2 — Initial Configuration Configure the BlackPearl Management Port ONFIGURE THE LACK EARL ANAGEMENT The default IP address for the BlackPearl management port is set to 10.0.0.2, with a netmask of 255.255.255.0. If your network is already using this IP address, or you want to configure a different IP address for the management port, use the BlackPearl console to configure the management port IP address. If you do not want to change the default management port IP address, skip to Log Into the BlackPearl User Interface on page You must connect Ethernet cables as described in Connect Ethernet Cables on Important page 30 before either proceeding with the steps below or skipping this section and accepting the default IP address for the management port.
Chapter 2 — Initial Configuration Log Into the BlackPearl User Interface 2. Press CTRL-N. The Configure Management Network Interface screen displays. Figure 11 The Configure Management Network Interface screen. 3. Select either DHCP or Static as the addressing method. If you select static addressing, enter the following information: IP Address—Enter a valid IPv4 address. Netmask—Enter the subnet mask. Default Gateway—Enter the default network gateway. 4. Select OK. The console screen displays showing the new IP address. 5. Connect a cable from your network to the BlackPearl management port on the BlackPearl gateway. You are now able to connect to the BlackPearl user interface with the IP address displayed in Step 6. Disconnect the monitor and USB keyboard from the BlackPearl ...
Page 33
BlackPearl user interface. Spectra Logic recommends that you change the default password (see Configure Users on page 69). Figure 12 The BlackPearl Login screen. 5. Click > to log in. Note: There is no limit to the number of users who can log in to the user interface. Spectra Logic recommends only one person use the interface at a time to avoid conflicting operations. Important The remainder of this guide assumes you are logged in to the BlackPearl user interface. December 2015 User Guide—Spectra BlackPearl Gateway...
Contacting Spectra Logic on page Use the following instructions to enter an activation key. 1. Select Support > Activation Keys to display the Activation Keys screen. Any previously entered keys are listed. Figure 13 The Activation Keys screen. 2. Select Action > New. The Enter Activation Key dialog box displays. Figure 14 The Enter Activation Key dialog box. 3. Enter the key, exactly as provided, in the Activation Key field and click Create to save the key on the gateway. The Activation Keys screen displays with the newly entered key listed. If necessary, repeat Step 1 through Step 3 to add additional keys. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 2 — Initial Configuration Configure the Data Connection ONFIGURE THE ONNECTION This section describes using the BlackPearl user interface to configure the data connection for the BlackPearl gateway. The gateway includes two 10GBase‐T ports, and two 10 GigE ports on the rear panel (see Figure 5 on page 21). You can only create one data connection to the gateway. You Notes: can configure link aggregation for better performance. You can only use the BlackPearl management port to access the BlackPearl user interface. You cannot use this port for data transfer. 1. From the menu bar, select Configuration > Network, or select the Network pane from the Dashboard screen. The Network screen displays with information about the network connections of the gateway. Figure 15 The Network screen. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 36
The Aggregate All interface type options allow you to configure a link aggregation using all the ports of that interface type. Link aggregation uses multiple Ethernet ports, configured with a single MAC address, to improve data transfer speeds. See Link Aggregation Notes on page 156 for more information. 4. Select either DHCP or Static as the addressing method. If you select static addressing, click the + button and enter the following information: IP Address—Enter a valid IPv4 address. Netmask—Enter the subnet mask. Note: If desired, you can enter Aliases, multiple IP and Netmask addresses assigned to the data port. Use the + button at the bottom of the Edit Data Ports dialog box to increase the number of IP and Netmask addresses. A maximum of 16 additional IP and Netmask addresses can be configured. 5. Enter the Default Gateway. 6. Change the MTU (Maximum Transmission Unit) value, if desired. If you set the MTU value to something other than 1500, ensure that your switch configuration supports larger MTU settings, as well as all the hosts on the network. 7. Click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
REATE A Use the instructions in this section to create users, which act as S3 users when interacting with the BlackPearl gateway through a Spectra S3 SDK (Software Development Kit) client, or Spectra S3 API. Each user has a unique S3 Access ID and Secret Key. Note: Users are not able to log into the BlackPearl user interface. Only the primary administrator account can log into the interface. You cannot create additional administrator accounts. 1. From the menu bar, select Configuration > Users. The Users screen displays. Figure 17 The Users screen. 2. Select Action > New from the menu bar. The New User dialog box displays. Figure 18 The New User dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
List The user can see the bucket and can list the objects in a bucket. Read The user can get objects and create get jobs. The user can put objects and create put jobs. Write The user can delete objects, but cannot delete the bucket. Delete The user can modify or cancel jobs created by other users. The user can also see the details of jobs created by other users. Note that all users can view all jobs, but by default, only the initiator of the job can see the full details of a job. The user receives full access to the bucket, including all Owner permissions listed above. 9. If desired, under Global Data Policy Access Control List, select the check box to allow the user access to any data policy created on the gateway. 10. Click Create to create the new user. The gateway generates a unique S3 Access ID and Secret Key for the user. If desired, repeat Step 2 through Step 10 to create additional users. S3 C REDENTIALS Use the instructions in this section to view the S3 credentials of a user. December 2015 User Guide—Spectra BlackPearl Gateway...
ONFIGURE THE ACHE The cache on the BlackPearl gateway acts as a buffer, storing data until it can be written to tape media. The cache is configured to maximize capacity by default, but can be re‐configured to provide improved data transfer performance. Spectra Logic recommends keeping the cache configuration set for greater capacity Important so that the cache is less likely to completely fill with data. If you do not want to change the cache configuration, skip to Next Steps on page If desired, use the instructions in this section to change the cache from the default capacity configuration to a performance configuration. Changing the cache configuration deletes all data currently in the cache.
Page 40
Configure the Cache 1. From the menu bar, select Configuration > Advanced Bucket Management. The Advanced Bucket Management screen displays. Figure 20 The Advanced Bucket Management screen. 2. Select Action > Manage Cache and Online Disk. The Change Cache Configuration dialog box displays. Figure 21 The Change Cache Configuration dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
5. Enter DELETE_AND_REBOOT in the entry field, and then click Reconfigure. The BlackPearl gateway reconfigures the cache and reboots the gateway. The connection to the user interface is lost. 6. When the gateway finishes initializing, log into the user interface as described in Log Into the BlackPearl User Interface on page TEPS The BlackPearl gateway now has the necessary components configured to begin designing your storage architecture. Continue with one of the following steps: See Understanding Spectra S3 Concepts on page 42 for information about Spectra S3 and Advanced Bucket Management concepts you need to understand before you begin designing the storage architecture of the BlackPearl gateway. See Additional Configuration Options on page 59 for information about the additional options that can be configured on the BlackPearl gateway. See Operating the BlackPearl Gateway on page 91 for information about day‐to‐day monitoring and operation of the gateway. See Using AutoSupport on page 130 to set up AutoSupport to collect and email log sets. See Maintaining the BlackPearl Gateway on page 140 for maintenance options for the gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Understanding Spectra S3 Concepts This chapter explains the concepts of the BlackPearl gateway advanced bucket management. It is important to understand the information in this chapter before you begin designing the storage architecture of the BlackPearl gateway. Task Spectra S3 Overview page 43 Spectra S3 Clients page 44 Storage Domains page 45 Data Policies page 45 Data Persistence Rules page 45 Tape and Disk Partitions page 46 Tape Partitions page 46 Disk Partitions page 47...
Chapter 3 — Understanding Spectra S3 Concepts Spectra S3 Overview S3 O PECTRA VERVIEW The BlackPearl Deep Storage Gateway allows data to move seamlessly into tape storage in a way not previously possible. Spectra S3 is the first native REST‐based interface to deep storage which enables easy archiving of large amounts of bulk data. It enables users to deploy a tier of deep storage that is cost effective, easy to manage, and scalable to exabytes of data. Storing large amounts of bulk data on tape has historically presented challenges. Spectra S3 addresses these challenges: Tape drives are sequential block storage devices, with data laid out in a sequential manner along the full length of the tape. This makes it inefficient to retrieve data out of order. Spectra S3 plans and queues a large amount of data to be efficiently written to tape; it logically groups data on tape in a way that reflects how the client is likely to read it back. Because of the mechanical nature of the tape media and drives, tape drives demand a large amount of data to be available, via a fast connection. When data is not efficiently streamed for the tape drives to write (due to slow data buffering or a slow connection to the drive), the result is poor write performance. This poor performance is due to a phenomenon referred to as ʺshoe‐shiningʺ. When a drive is sent a small amount of data, it writes the data and then is forced to stop. Because the tape cannot stop instantaneously, the drive overshoots a small amount and the tape is not in position for the next write operation. To compensate, the tape drive rewinds to get back to the correct position for the next write. If the next write also has a small amount of data, then the drive writes the next portion and again stops, overshoots, and ...
Chapter 3 — Understanding Spectra S3 Concepts Spectra S3 Overview The first of these additional operations is called START BULK PUT. It is an HTTP PUT operation that provides the BlackPearl gateway with information about the objects that the client wants to send as a single job for storing on tape. The START BULK PUT command is sent with a payload that is made up of a list of object names and corresponding object sizes. This information allows the BlackPearl gateway to plan the initial storage of the objects in its cache, and how it will store the data on tape. The response to the START BULK PUT command is a specifically ordered list of how the BlackPearl gateway wants those files (objects) sent. The second command is called START BULK GET. The START BULK GET command is actually an HTTP PUT command because it too contains a payload for the BlackPearl gateway. This payload is a list of objects that the client wants to get from the BlackPearl gateway. It is not necessary for the request payload to contain the size of the files because the BlackPearl gateway already knows the sizes of the objects (files). The response to the request is again an ordered list of the objects and information about the objects, including if they are already in the cache and ready to be retrieved from cache by a GET command. Knowing the files that the client wants to retrieve, the BlackPearl gateway can make the best use of its resources in retrieving the objects from tape. For example, if the list of objects spans across four different tapes and there are four tape drives available, those four tapes can all be loaded into drives and the objects can be read back in parallel, greatly improving the speed at which the client can get all of the objects. Without the START BULK GET request, the client would be asking the BlackPearl gateway for those objects in a less efficient manner. Lastly, because the BlackPearl gateway is focused on tape media, the Spectra S3 API supports commands that allow interaction with the tapes and tape library. For more information on the Spectra S3 interface, see the Spectra BlackPearl ...
Chapter 3 — Understanding Spectra S3 Concepts Storage Domains TORAGE OMAINS A storage domain is a collection of data partitions and, when applicable, media type combinations. Storage domains define the possible places where data sent to the BlackPearl Deep Storage Gateway can be stored. Data persistence rules and data policies further define where and for how long specific data is stored. Entire data partition/media type combinations are members of storage domains. When additional capacity is required, a single disk partition or tape is allocated out of the member data partitions to fulfill the capacity requirement. OLICIES A data policy defines data integrity policies, default job attributes, and persistence rules, which define where data should be persisted. A data policy may be used by multiple buckets, but a bucket uses precisely one data policy. A data policy consists of one or more permanent persistence rules, zero or more temporary persistence rules, and zero or more retired persistence rules. A persistence rule can be permanent, meaning that data is persisted in the specified storage domain at all times, or temporary, meaning that data is persisted in the specified storage domain under certain circumstances, and then it can be deleted from that storage domain. Existing permanent and temporary persistence rules may be retired so that the rule is not applied for any new incoming data, but continues to retain data previously written. Data Persistence Rules Each data policy must have one or more permanent persistence rules. Each persistence rule targets a specified storage domain. There are two types of persistence rules: ...
Chapter 3 — Understanding Spectra S3 Concepts Tape and Disk Partitions The same storage domain cannot be specified multiple times using different persistence rules in the same data policy. The same storage domain can be referred to across different data policies. Data persistence rules must specify the level of physical isolation required for the data retention. There are three types of data retention: Standard — Data is isolated according to the standard storage domain isolation requirements. Bucket Isolated — Data from different buckets cannot be mixed on the same physical storage media. Secure Bucket Isolated — Data from different buckets cannot be mixed on the same physical storage media, and media cannot be reclaimed into the general pool once assigned to a bucket; it can only be reclaimed for use within the same bucket. The Standard isolation level provides the best capacity Notes: utilization and overall performance. Bucket Isolated and Secure Bucket Isolated allocate an entire tape or pool to a bucket when needed. Allocating an entire ...
Chapter 3 — Understanding Spectra S3 Concepts Tape and Disk Partitions Tape drive cleaning can be initiated through the Spectra S3 API. See the Spectra BlackPearl Spectra S3 API Reference for more information. Tape drive cleaning cannot be initiated through the BlackPearl user interface Disk Partitions Disk partitions are comprised of storage pools on external SAS expansion nodes. There are two types of disk partitions. Online disk partitions are created on Spectra BlackPearl expansion nodes, while Nearline disk partitions are created on Spectra ArcticBlue expansion nodes. Online ‐ Online storage using BlackPearl expansion nodes is used as a temporary, high‐performance storage target for highly transactional data. Nearline ‐ Nearline storage using ArcticBlue expansion nodes is a cost effective storage target for deep storage. Nearline storage is not recommended for frequent reads or writes. Nearline storage pools on the ArcticBlue expansion node are automatically created by the BlackPearl gateway when the gateway detects a sufficient number of disks for a new storage pool, and there is a capacity key installed on the gateway to license the additional storage space. Online storage pools are manually created using the BlackPearl user interface after you attach a BlackPearl expansion node (see Create Online Disk Pool on page 77).
HAPTER Configure Advanced Bucket Management Settings This chapter provides instructions on how to configure the Advanced Bucket Management features. Task Create a Disk Partition page 49 Create a Tape Partition page 51 Create a Storage Domain page 51 Create a Data Policy page 53 Create a Bucket page 57 Transfer Data page 58...
Chapter 4 — Configure Advanced Bucket Management Settings Create a Disk Partition REATE A ARTITION Disk partitions are collections of one or more storage pools, which are configured on either ArcticBlue expansion nodes, or BlackPearl expansion nodes, connected to the BlackPearl gateway. Disk partitions are specified in storage domains as storage targets. There are two types of disk partitions; nearline storage, which is provided by an ArcticBlue expansion node, and online storage, which is provided by a BlackPearl expansion node. Nearline storage pools on ArcticBlue expansion nodes are automatically created by the BlackPearl gateway when the system detects that new disk storage is connected to the gateway. A capacity key licensing the disk storage must be entered in to the gateway before automatic storage pool creation begins. Online storage pools must be created manually using the BlackPearl user interface. See Create Online Disk Pool on page 77 for more information. Once the storage pools are created, they can be added to a disk partition. Use the instructions in this section to create a new disk partition. December 2015 User Guide—Spectra BlackPearl Gateway...
Create a Disk Partition 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen. Figure 22 The Advanced Bucket Management screen. 2. Select Action > New Disk Partition. The New Disk Partition dialog box displays. Figure 23 The New Disk Partition dialog box. 3. Enter a name for the disk partition in the Disk Partition Name field. December 2015 User Guide—Spectra BlackPearl Gateway...
6. Click Create. The new disk partition displays on the Advanced Bucket Management screen. REATE A ARTITION Use the User Guide for your Spectra tape library to create a partition using the library’s BlueScale interface. Once the BlackPearl gateway sees a partition on a tape library connected to it, the tape partition is automatically listed on the Advanced Bucket Management screen. REATE A TORAGE OMAIN A storage domain is a named collection of member data partitions and, when applicable, media type combinations. Storage domains define the possible places where data sent to the BlackPearl Deep Storage Gateway can be stored. Data persistence rules and data policies further define where and for how long to store specific data. Entire data partition/media type combinations are members of storage domains. When a bucket requires additional capacity, a single disk partition or tape is allocated out of the members to fulfill the capacity requirement. Use the instructions in this section to create a new storage domain. 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). December 2015 User Guide—Spectra BlackPearl Gateway...
2. Select Action > New Storage Domain. The New Storage Domain dialog box displays. Figure 24 The New Storage Domain dialog box. 3. Enter a name for the disk partition in the Disk Partition Name field. 4. Select the Write Optimization for the storage domain. This setting specifies whether job chunks are written as quickly as possible or across as few pieces of media as possible. For example, when Performance mode is set for a tape partition, job chunks are written as quickly as possible, using all tape drive resources, even if that means that more tapes are allocated to the bucket than are necessary to write the data. It is better to use Capacity mode if the tapes will be ejected after the job completes or if the bucket is written to very rarely and capacity in the library is of concern. Performance mode is recommended for tape partitions in all other cases. Storage domains for pool partitions should generally have a Capacity write optimization because pools are very fast and under less contention. It is rare for a pool storage domain to benefit from Performance mode. December 2015 User Guide—Spectra BlackPearl Gateway...
Use the Media Type drop‐down menu to select the media type for the tape partition. You must select the media type that matches the media Notes: present in the tape library partition. This option does not display if you select a disk partition in Step d. Use the Write Preference drop‐down menu to select the write preference for this member of the storage domain. This setting determines the preferred usage of the partition when additional capacity is needed. The gateway uses a partition with High write preference before a partition with Normal write preference, and so on. Use Never Select to indicate that a partition is read‐only. If desired, repeat Step a and Step d to add additional members to the storage pool. 7. Click Create. The new storage pool displays on the Advanced Bucket Management screen. REATE A OLICY A data policy defines data integrity policies, default job attributes, and persistence rules, which define where data should be persisted. A data policy may be used by multiple buckets, but a bucket uses precisely one data policy. December 2015 User Guide—Spectra BlackPearl Gateway...
Existing permanent and temporary persistence rules may be retired so that the rule is not applied for any new incoming data, but will continue to retain data previously written. Use the instructions in this section to create a new data policy. 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). 2. Select Action > New Data Policy. The New Data Policy dialog box displays. Figure 25 The New Data Policy dialog box. 3. Enter a name for the data policy in the Data Policy Name field. December 2015 User Guide—Spectra BlackPearl Gateway...
6. Select the type of Versioning you want to use for the data policy. You must select either None or Keep Latest. None — Only one version of an object may exist at any time and the version number of the object is always 1. Keep Latest — Only one version of the data is available at a time. When a new version of an object is written, the old version is retained until the new version is fully persisted in compliance with the data policy, and then the old version is deleted. The Keep Latest setting cannot be used for a data policy Notes: which uses a storage domain configured with the LTFS File Name option set to Object Name. See Create a Storage Domain on page 51 for more information. The Keep Latest setting requires that the PUT job for the earlier version of the object complete before the PUT of the latest version of the object with the same name in order for the PUT job to succeed. If the PUT of the earlier version is not complete before the PUT of the latest version, the BlackPearl gateway believes the latest version to be the same object as the earlier version and rejects it, and only the earlier version is retained. December 2015 User Guide—Spectra BlackPearl Gateway...
Enter the Minimum Days to Retain in the entry field to specify the minimum number of days the gateway should retain data written using a temporary persistence rule. The Minimum Days to Retain for a persistence rule targeting a Note: storage domain using a nearline pool (an ArcticBlue expansion node) must be 90 days or greater. If desired, repeat Step a and Step e to add additional storage domain members and persistence rules to the data policy. 8. Add a user or S3 group to the Access Control List for the data policy. a. In the Access Control List pane, click Add. A new row appears in the pane. b. Use the Name drop‐down menu to select a previously created user or S3 group. If desired, repeat Step a and Step b to add additional users or S3 groups to the access control list. 9. Click Create. The new data policy displays on the Advanced Bucket Management screen. December 2015 User Guide—Spectra BlackPearl Gateway...
1. From the menu bar, select Configuration > Buckets. The Buckets screen displays. Figure 26 The Buckets screen. 2. Select Action > New from the menu bar. The New Bucket dialog box displays. Figure 27 The New Bucket dialog box. 3. Enter a name for the bucket in the Bucket Name field. The bucket name cannot use the colon (:) or forward slash (/) Notes: characters. The bucket name cannot exceed 255 characters. 4. Using the drop‐down menu, select an Owner for the bucket from the list of users already created on the gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
List The user can see the bucket and can list the objects in a bucket. Read The user can get objects and create get jobs. Write The user can put objects and create put jobs. Delete The user can delete objects, but cannot delete the bucket. The user can modify or cancel jobs created by other users. The user can also see the details of jobs created by other users. Note that all users can view all jobs, but by default, only the initiator of the job can see the full details of a job. The user receives full access to the bucket, including all Owner permissions listed above. If desired, repeat Step a through Step c to add additional users or groups. 7. Click Create. The Buckets screen displays with the newly created bucket listed. RANSFER After completing the above sections of this chapter, you are ready to begin transferring data to, and from, the BlackPearl gateway. To transfer data using the Spectra Deep Storage Browser, see Using the Deep Storage Browser on page 122. To transfer data using a Spectra S3 client, consult the Spectra BlackPearl Spectra S3 API Reference, and documentation specific to each Spectra S3 client. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Additional Configuration Options This chapter describes using the BlackPearl user interface to configure additional options for the Spectra BlackPearl Deep Storage Gateway. Task Configure Services page 60 Configure the SNMP Service page 60 Configure the Spectra S3 Service page 62 Configure Network Connections and Settings page 64 Edit the System Name page 64 Configure Ethernet Ports page 65 Configure DNS Settings page 66 Configure SMTP Settings page 67 Configure Date and Time page 69 Configure Users page 69 Create New S3 Group page 70 Edit a User...
Figure 28 The Services screen. 2. Double‐click the SNMP service, or select the SNMP service and select Action > Show Details. The SNMP details screen displays. 3. On the SNMP details screen, select Action > Edit. The Edit SNMP Service dialog box displays. Figure 29 The Edit SNMP Service dialog box. 4. If desired, change the value of the Community String. Any incoming SNMP queries that use a different community string than the one set here fail. If no community string is specified, then the BlackPearl gateway responds to all SNMP queries. 5. Enter the primary contact for the BlackPearl gateway in the Contact field. 6. Enter the physical location of the gateway in the Location field. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 61
Enter a community string value in the Community String field. This community string is set for each client. The clients monitor SNMP notifications for any that use the string specified here. Repeat Step a through Step e as needed to add additional clients. 8. Click Save. Download the MIB File If you want to communicate with the gateway using SNMP, you must first download the BlackPearl MIB (Management Information Base) file, and load the file into a compatible network node manager program, such as ® ® OpenView . 1. Select Configuration > Services to display the Services screen (see Figure 28 on page 60). 2. Double‐click the SNMP service row, or select the SNMP service row and select Action > Show Details. The SNMP details screen displays. December 2015 User Guide—Spectra BlackPearl Gateway...
3. Click Download MIB. Using your web browser, save the file to your local host. Figure 31 Download the MIB file. 4. Load the file into the network node manager program. 5. You can now use your network node manager program to communicate with the BlackPearl gateway, using the settings configured in Configure the SNMP Service on page Configure the Spectra S3 Service 1. From the menu bar, select Configuration > Services to display the Services screen (see Figure 28 on page 60). Figure 32 The Services screen. 2. Double‐click the S3 service, or select the S3 service and select Action > Show Details. The S3 details screen displays. December 2015...
Page 63
If the Data Path Backend Auto-Activate Timeout is set to 0, the data path backend will never auto‐activate. 6. Using the drop‐down menu, select a behavior for the Default Import Conflict Resolution Mode. This setting sets the default behavior for the gateway when importing a foreign disk pool. Value Description Abort Abort the import process if a file name conflict is discovered. Accept Highest Keep the file with the highest version number. Version Number Accept Most Recent Keep the file with the most recent creation date. Creation Date Keep Existing Keep the file currently in the BlackPearl database. Replace Existing Keep the file currently being imported. 7. Click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
ETTINGS Use the Network screen to edit the system name, configure Ethernet ports and DNS settings, and to enter SMTP and NTP information. Figure 34 The Network screen. Edit the System Name 1. From the menu bar, select Configuration > Network, or click the Network pane from the Dashboard screen. The Network screen displays. 2. In the Network Interfaces pane, double‐click the system name, or select the system name and then select Action > Edit. The Edit System Name dialog box displays. Figure 35 The Edit System Name dialog box. 3. Enter the desired Name for the system, and click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
Configure the Data Connection on page 35 Configure the Management Port on page 65 Clear an Ethernet Configuration on page 66 Configure the Management Port 1. From the menu bar, select Configuration > Network, or click the Network pane from the Dashboard screen. The Network screen displays (see Figure 34 on page 64). 2. In the Network Interfaces pane, double‐click the Management row, or select the Management row and then select Action > Edit. The Edit Management dialog box displays. Figure 36 The Edit Management dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
If you select DHCP, you are not able to see the IP address assigned by DHCP before Important you are logged out of the BlackPearl user interface. Contact your system administrator to determine the DHCP address for the management port.
Figure 37 Edit DNS information. 3. Select DHCP to have the gateway determine the address of name servers and search domains automatically. —OR— Select Manual to enter information for name servers and search domains manually. Note: The buttons for DHCP and Manual are only usable when the BlackPearl management port is configured as DHCP. If the management interface is set to a static IP address, the buttons are greyed out, and the information must be entered manually. 4. If the BlackPearl management port is configured with a static IP address, or if you selected Manual, enter the following information: a. Enter the IP address of one or more name servers in the Name Servers field. b. Enter the URL of one or more search domains in the Search Domains field. 5. Click Save. Configure SMTP Settings Use the Email settings to associate the BlackPearl gateway with a mail server. The gateway uses this SMTP server to send emails whenever ASLs or certain types of messages are generated. Use the following instructions to enter SMTP information on the gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 68
Figure 38 The SMTP pane of the Network screen. 2. Double‐click the name of the SMTP server, or select the name of the SMTP server and then click Action > Edit. The Email dialog box displays. Figure 39 The Email dialog box. 3. Enter the SMTP Server and SMTP Port information. 4. If your SMTP server uses TLS (Transport Layer Security) authentication, select the Enable TLS Authentication check box and enter the required username and password information. 5. Enter an email address in the From Address field. This is the email address that displays as the sender whenever the gateway generates an email. This email address should uniquely identify the BlackPearl gateway to assist in troubleshooting and be recognized by the SMTP server as a valid domain address. 6. Click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
Figure 40 The Date and Time pane of the Network screen. 2. Double‐click the System Time to edit the date and time, or select the System Time row and select Action > Edit. The Time Settings dialog box displays. Figure 41 The Time Settings dialog box. 3. Select Manual or NTP. a. If you select Manual, enter the current time in the Time field. Enter either 12‐hour time values and include AM or PM, or use 24‐hour time values. Click the empty Date field. A calendar appears. Select the current date. b. If you select NTP, enter the NTP server information for the Primary NTP Server. If desired, enter the NTP server information for the Secondary NTP Server. ONFIGURE SERS Use the instructions in this section to create a new S3 user group, edit existing users, change passwords, and configure the session timeout setting. To create new users, see Create a User on page December 2015 User Guide—Spectra BlackPearl Gateway...
An S3 group on the BlackPearl gateway is a group of previously created S3 users. Members of an S3 group can be individual users, or groups of users. When creating an S3 group, you specify the global bucket and data policy access control lists. Use the instructions in this section to create a new S3 group. 1. From the menu bar, select Configuration > Users. The Users screen displays. Figure 42 The Users screen. 2. Select Action > New S3 Group from the menu bar. The New S3 Group dialog box displays. Figure 43 The New S3 Group dialog box. 3. Enter the desired Name for the group. December 2015 User Guide—Spectra BlackPearl Gateway...
The S3 group can modify or cancel jobs created by other users. The S3 group can also see the details of jobs created by other users. Note that all users can view all jobs, but by default, only the initiator of the job can see the full details of a job. Owner The S3 group receives full access to the bucket, including all permissions listed above. 6. Under Global Data Policy Access Control List, select the check box to allow the user access to any data policy created on the gateway. 7. Click Create to create the new S3 group. If desired, repeat Step 2 on page 70 through Step 7 to create additional S3 groups. Edit a User 1. From the menu bar, select Configuration > Users. The Users screen displays a list of all configured users (see Figure 17 on page 37). December 2015 User Guide—Spectra BlackPearl Gateway...
Page 72
7. The S3 Access ID and S3 Secret Key fields are generated automatically and cannot be changed. 8. From the drop‐down list, select a Default Data Policy for the user. If specified, the gateway uses the selected data policy for all buckets created by the user, unless a different policy is specified during bucket creation. 9. Select or clear options for the Global Bucket Access Control List. These options give or deny permission for the user being created to perform the action described in the table below, for all buckets present on the gateway, as well as any buckets created at a future date. Name Description The user can see the bucket and can list the objects in a List bucket. Read The user can get objects and create get jobs. Write The user can put objects and create put jobs. Delete The user can delete objects, but cannot delete the bucket. December 2015 User Guide—Spectra BlackPearl Gateway...
Delete a User 1. From the menu bar, select Configuration > Users. The Users screen displays a list of all configured users (see Figure 17 on page 37). 2. Select the user you want to delete, and then select Action > Delete. A confirmation window displays. 3. Click Delete to delete the user. Change Password and Session Timeout Setting Use the instructions in this section to change the password or configure session timeout settings for the Primary Administrator. Only the Primary Administrator can access the BlackPearl user interface. To edit the other parameters of the Primary Administrator, see Edit a User on page 1. From the menu bar, select Configuration > Users. The Users screen displays a list of all configured users (see Figure 17 on page 37). December 2015 User Guide—Spectra BlackPearl Gateway...
Page 74
Note: If you are only changing the session timeout, leave the password fields blank. The password is not changed. 6. If desired, enter the value for the session timeout in minutes. This value cannot exceed 999 minutes. 7. The S3 Access ID and S3 Secret Key fields are generated automatically and cannot be changed. 8. When changing the password or setting a new timeout value, leave the Default Data Policy, Global Bucket Access Control List, and Global Data Policy Access List options as is. 9. Click Save to save the new password and session timeout setting. Note: The new password does not take effect until after you log out of the BlackPearl user interface (see Exit the BlackPearl User Interface on page 121). December 2015 User Guide—Spectra BlackPearl Gateway...
Bucket dialog box displays. Figure 46 The Edit Bucket dialog box. 3. The bucket name is greyed out and cannot be changed. 4. From the drop‐down list, change the Owner assigned to the bucket. After changing bucket owners, you may need to reconfigure your client application Important to access the bucket. 5. Use the Data Policy drop down menu to change data policy assigned to the bucket. For more information on data policies, seeData Policies on page December 2015 User Guide—Spectra BlackPearl Gateway...
Any bucket data that was written to tape media is retained until the tape is loaded into a drive and new data is written. 1. From the menu bar, select Configuration > Buckets. The Buckets screen displays (see Figure 26 on page 57). December 2015 User Guide—Spectra BlackPearl Gateway...
1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). 2. Select Action > New Online Disk Pool. The New Online Disk pool dialog box displays. Figure 48 The New Online Disk Pool dialog box. 3. Using the drop‐down menu, select the type of pool you want to create. Only valid pool configuration options display, you cannot create pools outside of the pre‐configured sizes. 4. Click Create Pool. The new online disk pool is listed on the Advanced Bucket Management screen. December 2015 User Guide—Spectra BlackPearl Gateway...
Import Disk Pool Data present on nearline storage pools on ArcticBlue expansion nodes can be moved from one BlackPearl gateway to another, either to increase name space redundancy, or as part of disaster prevention. Use the instructions in this section to import a pool. 1. Ensure the settings for the Spectra S3 service Default Import Conflict Resolution Mode are set to your preference. See Configure the Spectra S3 Service on page 62 for more information. 2. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). 3. Select the nearline pool you want to import in the Storage Pools pane, and select Action > Import Pool. 4. Follow the on‐screen prompts to finish importing a pool. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Working with Tape Libraries and Media This chapter describes using the BlackPearl user interface to perform tasks relating to tape libraries and tape media. Task Format Tapes page 80 Inspect Tapes page 82 Eject Tapes page 83 Edit Tape Eject Information page 83 Eject a Single Tape page 84 Cancel Tape Ejection page 85 Import Tapes page 86 Import Foreign Tapes page 87 Put a Tape Library Partition in Standby Mode page 88 Activate a Tape Library Partition page 89...
Any data currently on the tape media is lost during the format operation. Caution Tapes are not eligible for formatting if they have a state of EJECTED, LOST, EJECT_PENDING, or OFFLINE. In addition, the Force parameter must be used to format a tape that contains data written by a BlackPearl gateway, to format a tape before it is inspected, to format a tape that has already been formatted by a BlackPearl gateway, or to format a tape that currently has reads or writes scheduled. If a tape contains data written by the current BlackPearl gateway, you must delete the objects and buckets before formatting the tape even if the force parameter is selected. 1. From the menu bar, select Status > Tape Management. The Tape Management screen displays. Any unformatted tapes display a state of Unknown on the Tape Management screen. Figure 50 The Tape Management screen. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 81
Do not use the Force option to force a format on a cleaning tape. If you do so the Important cleaning tape is set to “expired” and no longer usable for cleaning drives. December 2015 User Guide—Spectra BlackPearl Gateway...
Pending Inspection state (see State on page 100) and become unusable by the gateway. To return the cartridge to a usable state, manually request an inspection of the cartridge. Use the instructions in this section to inspect a tape. 1. From the menu bar, select Status > Tape Management. The Tape Management screen displays. Any tapes requiring inspection display a state of Pending Inspection on the Tape Management screen. Figure 53 The Tape Management screen. 2. Select the tape you want to inspect, and then select Action > Inspect. The Inspect Tape dialog box displays. Figure 54 The Inspect Tape dialog box. 3. Click Inspect to begin inspecting the tape. December 2015 User Guide—Spectra BlackPearl Gateway...
Always store tapes ejected from the Spectra tape library in TeraPack magazines. When tapes are outside the library, Spectra Logic recommends storing them in magazines with dust covers. See “Storing Cartridges” in your library User Guide for more information. Do not use the tape library front panel or RLC connection to move tape cartridges Important while the tape library is under the control of the BlackPearl gateway. Tapes can either be ejected one at a time, or as a group by ejecting all the tapes associated with a selected bucket. Use the instructions below to eject one or more tapes from the BlackPearl gateway. Note: Spectra T50e and T120 libraries must be configured in Standard eject mode to eject tapes. If your library has only one partition, it is already in Standard eject mode. If there is more than one ...
Figure 56 The Edit Tape dialog box. 3. Enter information in the Eject Label and Eject Location fields. This information is stored on the tape and is visible when re‐importing the tape into a BlackPearl gateway. 4. Click Save. Eject a Single Tape Ejecting a tape moves that tape to the tape library Entry/Exit pool. Any objects on the exported tape are inaccessible until the tape is re‐imported into a storage pool. Use the instructions in this section to eject a tape. 1. Select Status > Tape Management to display the Tape Management screen. Figure 57 The Tape Management screen. December 2015 User Guide—Spectra BlackPearl Gateway...
Figure 58 The Eject Tape dialog box. 3. If desired, enter information in the Eject Label and Eject Location fields. This information is stored on the tape and is visible when re‐importing the tape into a BlackPearl gateway. You are not required to enter this information. Note: If you previously entered information for this tape cartridge, prior to ejecting it, as described in Edit Tape Eject Information on page 83, that information is displayed in the entry fields automatically. 4. Click Eject. The tape is marked as ejected in the BlackPearl gateway database, and moved to the Entry/Exit pool in the attached tape library. Consult your library User Guide for instructions on exporting tape media from the library. Cancel Tape Ejection If you requested a tape eject but it has not yet started, or you requested a bucket eject, but not all tapes are moved to the Entry/Exit pool, you can cancel the ejects in progress. Any tapes not already moved to the Entry/ Exit pool of the tape library are left in the storage partition and are usable by the BlackPearl gateway. Any tapes that were moved to the Entry/Exit pool must be exported from the library and re‐imported as described in Import Tapes on page 86. Use the instructions in this section to cancel a tape ejection. December 2015 User Guide—Spectra BlackPearl Gateway...
To cancel all tape ejections, select Action > Cancel All Tape Ejects. To cancel a single tape ejection, select the tape for which you want to cancel the ejection, and then select Action > Cancel Tape Eject. MPORT APES Use the instructions in this section to import tape media into the BlackPearl gateway database. 1. Import the tape media into the Entry/Exit pool of the tape library associated with the BlackPearl gateway as described in your library User Guide. 2. Select Status > Tape Management from the menu bar. The Tape Management screen displays. Figure 60 The Tape Management screen. December 2015 User Guide—Spectra BlackPearl Gateway...
If the bucket associated with the imported tape media no longer Note: exists, the tape cartridges are marked for formatting and reclaimed by the gateway. MPORT OREIGN APES When inspecting tapes in the tape library, if the BlackPearl gateway determines that one or more tape cartridges have been previously used in a different gateway, the gateway marks those tapes as foreign. Importing foreign tapes imports the selected tape cartridges into the new BlackPearl gateway. If one or more buckets being imported does not already exist, the data policy, storage domain, and user to use for any new buckets must be specified. Use the instructions in this section to import foreign tapes. 1. Select Status > Tape Management from the menu bar. The Tape Management screen displays. Figure 61 The Tape Management screen with foreign tapes listed. December 2015 User Guide—Spectra BlackPearl Gateway...
5. Using the User for new buckets drop‐down list, select a user from the list of previously created users for all buckets on the foreign tape. 6. Click Save. The foreign tape is imported into the BlackPearl gateway. Repeat Step 2 on page 88 through Step 6 to import additional foreign tapes. UT A IBRARY ARTITION IN TANDBY If you need to perform service on the tape library associated with your BlackPearl gateway, you must first put the tape library into a standby state. Otherwise, the BlackPearl gateway may attempt to use the tape library while it is in service. Putting the tape library into standby allows you to service the tape library without disconnecting the interface cables between the tape library and the BlackPearl gateway. Use the instructions in this section to put a tape library partition into standby. 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). December 2015 User Guide—Spectra BlackPearl Gateway...
3. Click Save. The tape partition enters the standby state. Note: If you have multiple partitions in the same tape library configured for use by the BlackPearl gateway, you must repeat steps Step 2 on page 89 and Step 3 for each partition in the tape library that requires service. Once you have completed service on the tape library, return the tape library to service using the steps in Activate a Tape Library Partition. CTIVATE A IBRARY ARTITION If you add a new tape library to your BlackPearl gateway, or your existing tape library has completed service, you must activate the tape partition in the BlackPearl user interface before the gateway is able to transfer data to the tape library. Use the instructions in this section to activate a tape library. Note: If you are activating a new tape library, you must create a partition on the library so that the BlackPearl gateway can automatically detect the new tape library. 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen (see Figure 22 on page 50). December 2015 User Guide—Spectra BlackPearl Gateway...
Page 90
Chapter 6 — Working with Tape Libraries and Media Activate a Tape Library Partition 2. Select the tape partition in the Tape Partitions pane, and select Action > Activate Tape Partition. The Activate Tape Partition confirmation window displays. Figure 64 The Activate Tape Partition confirmation window. 3. Click Save. The tape partition is activated and is usable by the BlackPearl gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Operating the BlackPearl Gateway This chapter describes procedures for day‐to‐day monitoring and operation of the Spectra BlackPearl Deep Storage Gateway. Topic Download an Object page 92 Cancel a Spectra S3 Job page 93 Monitor the BlackPearl Gateway page 94 Front Bezel Visual Status Beacon page 95 Configuring the Visual Status Beacon Color page 96 System Status LEDs page 97 Check System Messages page 98 View the Status of Hardware Components page 99 View the Status of Services page 100 View the Status of the Database and Cache page 101 View Bucket Contents page 103 View Spectra S3 Jobs Information...
Chapter 7 — Operating the BlackPearl Gateway Download an Object OWNLOAD AN BJECT Objects present on the BlackPearl gateway can be downloaded using the BlackPearl user interface, if desired. Only one object can be selected for download at a time. Notes: The object must be smaller than 100 GB. Objects larger than 100 GB must be downloaded through a Spectra S3 client. Use the instructions in this section to download an object through the BlackPearl user interface. 1. From the menu bar, select Configuration > Buckets. The Buckets screen displays (see Figure 22 on page 50). 2. Double‐click the bucket that contains the object you want to download. The Bucket Details screen displays a list of all objects in the bucket. Figure 65 The Bucket details screen. 3. Select the object you want to download, and select Action > Download. ...
Chapter 7 — Operating the BlackPearl Gateway Cancel a Spectra S3 Job S3 J ANCEL A PECTRA You can use the BlackPearl user interface to cancel an in‐progress Spectra S3 job instead of using your Spectra S3 client. Use the instructions in this section to cancel a Spectra S3 job. 1. From the menu bar, select Status > S3 Jobs to display the S3 Jobs screen. Figure 66 The S3 Jobs screen. 2. Select the job to cancel and then select Action > Cancel. The Cancel Job window displays. Figure 67 The Cancel Job screen.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway ONITOR THE LACK EARL ATEWAY The Visual Status Beacon on the front bezel, and the BlackPearl user interface, combine to provide a number of tools for monitoring the health and performance of the BlackPearl gateway and its components. The Visual Status Beacon light bar in the front bezel changes color to indicate the current status of the gateway (see Front Bezel Visual Status Beacon on page 95). System messages provide important information about the BlackPearl gateway and its operation (see Check System Messages on page 98 for more information). Icons on the Hardware screen provide overall status of the hardware components in each group (see View the Status of Hardware Components on page 99 for more information). Clicking the text next to each icon displays detailed status information for the components in the group. You can also use the BlackPearl user interface to do the following: View the status of services (see View the Status of Services on ...
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway Front Bezel Visual Status Beacon The Visual Status Beacon light bar in the front bezel provides an at‐a‐ glance status of the gateway to which it is mounted. The light bar changes color to indicate the status of the gateway. See the chart below for each color displayed and its associated condition. Color Display Condition Purple Scroll The gateway is operating normally. The color displayed when the gateway is Note: operating normally can be changed on the Hardware screen. See Configuring the Visual Status Beacon Color on page 96 for more information. The gateway is experiencing a Warning condition. Log in Yellow Scroll to the BlackPearl user interface to determine the cause of the warning. The gateway is experiencing an Error condition. Log in to Red Scroll the BlackPearl user interface to determine the cause of ...
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway Configuring the Visual Status Beacon Color The BlackPearl gateway is configured to display a purple scrolling light on the Visual Status Beacon when the gateway is operating normally. If desired, you can change the color displayed for normal operation. 1. From the menu bar, select Status > Hardware, or click the Hardware pane on the Dashboard, or click the Hardware link on the status bar. The Hardware screen displays. 2. Click Bezel. The Bezel pane of the Hardware screen displays. 3. Click the colored box next to Select Bezel Color. The color picker window displays. Figure 68 Use the color picker to set the color of the Visual Status Beacon when the gateway is operating normally.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway System Status LEDs The system status LEDs provide information about the status of the gateway, its fans, network connections, and power supplies. See the table below for a list of each system status LED and its function. Power LED Hard drive LED Network 1 LED Network 2 LED Fan failure/ Overheat LED Power failure LED Figure 69 System status LEDs.
Monitor the BlackPearl Gateway Check System Messages Check the system messages regularly. These messages provide important information about the BlackPearl gateway and its operation. Reviewing the messages is the first step in troubleshooting. If any system messages are generated by the gateway, the status bar displayed at the bottom of all BlackPearl screens shows the most recent date a message was generated. If there are no system messages, this text does not display. Figure 70 A system message displayed on the BlackPearl user interface status bar. 1. From the menu bar, select Status > Messages, or click the Messages link on the status bar, to display the Messages screen. Figure 71 The Messages screen. Pay extra attention to any messages flagged with the Warning or Error icon (see Status Icons on page 28), and follow any recommended steps. Contact Spectra Logic Technical Support if you need assistance (see ...
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway View the Status of Hardware Components The BlackPearl user interface lets you monitor the status of hardware components in the system, and the connected library tape drives, without having direct physical access. This is especially useful when your BlackPearl gateway is operating in a “lights out” data center. Check the BlackPearl user interface regularly to ensure that you always know the status of the hardware components. 1. From the menu bar, select Status > Hardware or click the Hardware pane on the Dashboard, or click the Hardware link on the status bar. The Hardware screen displays. Toolbar Beacon button Figure 72 The Hardware screen. 2. Use the toolbar menu on the left‐hand side of the screen to view ...
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway Clicking... Shows the... CPU status and temperature System System memory status and size Status, manufacturer, model, size, and serial number for each boot drive Status of tape drives in the tape library connected to the gateway Tape Drives Turn Beacon On Click Turn Beacon On to cause the Visual Status Beacon light on a BlackPearl gateway to flash blue. This is useful when you have multiple gateways and need to locate a specific one, for example to replace a component. Click the button a second time to stop the light from flashing. View the Status of Services The Services screen provides status information about services that are ...
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway View the Status of the Database and Cache The System Pools pane of the Advanced Bucket Management screen provides status information about the database and cache pools configured on the BlackPearl gateway, as well as status information for each system pool. 1. From the menu bar, select Configuration > Advanced Bucket Management to display the Advanced Bucket Management screen. Figure 74 The System Pools pane of the Advanced Bucket Management screen.
Page 102
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway 2. To view additional information about a system pool, select the system pool and then select Action > Show Details. The system pool name details screen displays. Figure 75 The BlackPearl_Cache details screen. The system pool name details screen displays the following information: This row... Shows... Name The name of the pool. This name cannot be edited. Health The current health of the pool. High Water Mark When the used space on the pool reaches this percentage, an alert is generated. No alert is generated when the percentage is set to zero. Data Configuration The protection level for the pool.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway View Bucket Contents Use the instructions in this section to view the contents of a bucket configured on the BlackPearl gateway. 1. From the menu bar, select Configuration > Buckets. The Buckets screen displays (see Figure 22 on page 50). 2. Double‐click the name of the bucket for which you want to view the contents. The details screen for the bucket displays. Figure 76 The details screen for a selected bucket. The bucket details screen displays the following information for each object contained in the bucket: This row... Shows...
Page 104
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway If desired, select the Show completed & cancelled jobs check box to display job completed or cancelled in the last 30 days. Clear the check box to hide completed and cancelled jobs. The S3 Jobs screen displays the following information: This column... Shows... Bucket The name of the bucket that is acted on by the job request. Request Type If the job is a “PUT” (write), “GET” (read), or “VERIFY (verify) operation. Priority The priority for processing the job. The job priority determines the resources assigned and the processing order. Values: Critical, Urgent, High, Normal, Low, Background. Status The current status of the job.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway View Tape Media Information The Tape Management screen allows you to view the status of all tapes in the associated Spectra Logic tape library, or in a specified bucket. 1. Display the Tape Management Screen: To view the status of all tapes in the associated tape library, from the menu bar, select Status > Tape Management. The Tape Management screen displays. Figure 78 The Tape Management screen. To view the status of the tapes associated with a bucket: a. From the menu bar, select Configuration > Buckets. The Buckets screen displays.
Page 106
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway This column... Shows... The status of the tape: State During normal operation, the tape state is Managed. Other possible states are: Bad—The tape cartridge is bad and is not usable by the gateway. BlackPearl‐Foreign—A tape from another BlackPearl gateway. This data must be copied into a bucket on this gateway before it is accessible. Data Checkpoint Failure—The tape should contain data that is recognizable to the BlackPearl gateway, but the gateway could not verify that the data on the tape is at the correct checkpoint or there was an error rolling back to a checkpoint. Data Checkpoint Missing—The tape should contain data that is recognizable to the BlackPearl gateway, but the checkpoint containing the data could not be found on the tape. Import in Progress—A foreign tape is in the process of being imported into the BlackPearl gateway. LTFS Foreign—An LTFS formatted tape not associated with a BlackPearl gateway. This data must be copied into a bucket on this gateway before it is accessible. Managed—The tape is ready for use.
Page 107
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway This column... Shows... The amount of space on the tape cartridge containing data. Used The serial number of the partition on the Spectra Logic tape library containing Tape Library the tape cartridge. Partition The name of the bucket to which the tape is assigned. Bucket The last error, if any, that was detected when reading data from, or writing data Most Recent Error to, the tape cartridge. Write Protected The status of the write‐protect switch on the cartridge. Last Modified The timestamp of the last time data was written to the tape cartridge. 2. To display detailed information about a tape cartridge, double click the tape cartridge row. A details screen for the selected tape displays. Figure 80 The details screen for a selected tape.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway This row... Shows... The serial number of the partition on the tape library Tape Library containing the tape cartridge. Partition The status of the write‐protect switch on the cartridge. Write Protected The timestamp of the last time the tape was loaded into a Last Accessed tape drive. Last Modified The timestamp of the last time data was written to, or read from, the tape cartridge. The name of the bucket to which the tape is assigned. Bucket Eject Label A user‐defined label entered when the tape is ejected. Eject Location A user‐defined label entered when the tape is ejected. If there are any tape errors associated with the specified cartridge, they display in the Tape Errors pane of the details screen.
Page 109
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway 1. From the menu bar, select Status > Performance. The Performance screen displays. Figure 81 The Performance screen. 2. Select Cache, Drives, CPUs, or Network to display performance information about the selected component. Note: If you select Cache, Drives, or Network, use the Cache, Disk, or Interface drop‐down menu to select a specific cache, disk drive, or network connection to monitor. 3. Select the time interval using the Resolution drop‐down menu. The data can be displayed in 1 second increments (5 minutes total) or 1 hour increments (25 hours total). 4. Select or clear options under Select elements to plot to indicate which ...
Page 110
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway 7. To see the performance data in greater detail, select the desired section you want to magnify in either the main or range indicator graph. Using the mouse, click and drag the cursor horizontally over the section of the detail graph that you want to magnify. The highlighted section of data is shown on the main graph. The range indicator graph continues to display the original range of data, with the section that is currently being shown on the main graph highlighted. Main graph Range indicator graph Highlighted section currently displayed on main graph Figure 82 Highlight a section of data to show in greater detail.
Chapter 7 — Operating the BlackPearl Gateway Monitor the BlackPearl Gateway View Reports The Reports screen allows you to generate reports on all aspects of the BlackPearl gateway, including component status, and configuration. Reports can be saved in either JSON or XML format. 1. From the menu bar, select Status > Reports to display the Reports screen. Figure 83 The Reports screen. 2. Select check boxes next to the report(s) you want to generate. Note: Use the All or None buttons at the bottom of each report group to select or clear that group of reports. The All and None buttons at the bottom of the screen select or clear all reports shown on the screen. 3. Select the Format for the report(s). Only one format can be selected. 4. Click Save. The selected reports are saved to your local host. 5. Open the report using a compatible program.
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore & R ATABASE ACKUP ESTORE The BlackPearl gateway database contains a list of all objects stored on the gateway cache and tape media. Backing up the database allows you to restore the database in the event of data corruption, or if you want to restore the system to the state it was in when the database backup was generated. When restoring from a database backup, all changes since the database backup are Caution lost. Any tape media with objects created after the database backup are reclaimed by the gateway.
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore Manually Generate a Database Backup Use the instructions in this section to create a database backup manually. 1. From the menu bar, select Configuration > Database Backup. The Database Backup screen displays. Figure 84 The Database Backup screen. 2. Select Action > Start Immediate Backup. A confirmation window displays. Figure 85 The Start Immediate Backup confirmation window.
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore Create a Database Backup Schedule Database backup schedules can be configured at intervals based on hours, number of days, or days of the week. Decide which interval to use for the schedule and follow the appropriate instructions. Create an Hourly Schedule on page 114—Create backups every selected number of hours. Create a Daily Schedule on page 115—Create backups every selected number of days. Create a Weekly Schedule on page 116—Create backups on certain days of the week. Create an Hourly Schedule 1. From the menu bar, select Configuration > Database Backup. The ...
Page 115
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore 4. Enter a number for the Minimum backups to keep on tape. When the gateway generates a backup that exceeds the value configured, the gateway automatically deletes the oldest backup. 5. Enter a number for Every _ hours on the hour. This value specifies the interval, in hours, between generating backups. For example, if this value is set to 4, the system creates a backup every four hours. 6. Click Save. Create a Daily Schedule 1. From the menu bar, select Configuration > Database Backup. The ...
Page 116
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore 6. Enter a number for Every_days. This value specifies the interval, in days, between generating database backups. For example, if this value is set to 2, the gateway generates a backup every two days at the time specified in Step 7. Click Save. Create a Weekly Schedule 1. From the menu bar, select Configuration > Database Backup. The Database Backup screen displays. Figure 90 The Database Backup screen. 2. Select Action > Change Schedule. The Modify Database Backup ...
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore Restore from a Database Backup Restoring a database backup returns the gateway to the state it was in when the backup was created. All objects written to the gateway after the backup was created are inaccessible. Restoring a database backup deletes all data changes made after the backup was Caution created, and deletes any backups that were saved after the one you are using for the restore process.
Chapter 7 — Operating the BlackPearl Gateway Database Backup & Restore Delete Backup Use the following instructions to delete a database backup. 1. From the menu bar, select Configuration > Database Backup. The Database Backup screen displays. Figure 94 The Database Backup screen. 2. Select the backup you want to delete in the Backups pane, and then select Action > Delete. A confirmation screen displays. 3. Click Delete to confirm the operation. The backup is deleted. Edit Backup Data Policy Use the following instructions to edit the data policy used for the database backup bucket.
Chapter 7 — Operating the BlackPearl Gateway Manually Starting the S3 Data Path Backend 2. From the menu bar select Action > Edit Data Policy. The Modify Data Policy screen displays. Figure 96 The Modify Data Policy screen. 3. Use the Data Policy to Use drop‐down menu to select a new data policy for the database backup bucket. S3 D ANUALLY TARTING THE ACKEND If the BlackPearl gateway is powered off for longer than the timeout value ...
Chapter 7 — Operating the BlackPearl Gateway Reboot or Shut Down a BlackPearl Gateway EBOOT OR OWN A LACK EARL ATEWAY This section discusses rebooting or shutting down a gateway. Using the BlackPearl User Interface Use the following instructions to reboot or shutdown a gateway using the BlackPearl user interface. 1. Click the power icon in the lower right‐hand corner of any screen in the BlackPearl user interface. The Power screen displays. Power Figure 98 The Power icon. 2. Click either Reboot or Shutdown. ...
Under some circumstances, Spectra Logic Technical Support may direct you to perform a power‐cycle reset of a BlackPearl gateway to recover from an error. To power‐cycle reset a BlackPearl gateway, remove the front bezel, and then press and hold the front panel power button (Figure 9 on page 30) until the button’s LED turns off. After a few moments, press the button again to turn the gateway back on. Do not use the power button to turn off a BlackPearl gateway unless you are Caution specifically instructed to do so by Spectra Logic Technical Support. XIT THE LACK EARL NTERFACE To exit the BlackPearl user interface, close the browser or click Logout on ...
Page 122
HAPTER Using the Deep Storage Browser This chapter describes using the Spectra Deep Storage Browser to perform file storage operations with a Spectra BlackPearl Deep Storage Gateway. Task Introduction page 123 Requirements page 123 Download page 123 Launch the Deep Storage Browser page 124 Connect to a BlackPearl Gateway page 124 Using the Browser page 126 Interface Overview page 126 Copy a File to the Gateway page 128 Read a File from the Gateway page 128...
The Deep Storage browser is not designed for daily backups because the Deep Storage browser does not support versioning. Once a file is copied to the BlackPearl gateway and written to tape, you cannot overwrite that file with a newer version. Even if you delete the file on the BlackPearl gateway, the file transfer operation fails with the error message “Versioning is not supported”. EQUIREMENTS The Deep Storage browser has the following requirements: The BlackPearl gateway must be running BlackPearl 1.1 software, or later. The Deep Storage browser cannot overwrite existing files. Ensure that none of the names of files to transfer duplicate the names of files already in the destination, or the entire data transfer fails. The Deep Storage browser operates by moving data from the selected source location, through the host computer running the Deep Storage browser, to the destination location. This occurs even if there is a direct connection between the source and destination. This can result in slower data transfer performance depending on the host computer CPU, memory, and network configurations. Files being stored as objects to a BlackPearl based tape library storage solution must follow the Amazon S3 naming restriction. See http:// docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html for more information. OWNLOAD Use the instructions in the following sections to download the Deep Storage browser for Microsoft Windows or Apple Mac OS operating systems. Using a web browser, navigate to https://developer.spectralogic.com/ ds3browser. December 2015 User Guide—Spectra BlackPearl Gateway...
Apple Mac OS Operating System Software Click Application > Deep Storage Browser to launch the program ONNECT TO A LACK EARL ATEWAY Before you can initiate file storage operations, you must first setup the logical connection between the Deep Storage browser and the BlackPearl gateway. 1. Launch the Deep Storage browser using the method appropriate for your operating system (see Launch the Deep Storage Browser). The New Deep Storage Browser Session dialog box displays. Figure 99 The New Deep Storage Browser Session dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
5. Enter the S3 Access ID and S3 Secret Key for a user currently configured on the BlackPearl gateway. See View S3 Credentials on page 38 for more information. Only one user at a time can access the gateway using a Deep Notes: Storage browser. Only the buckets assigned to the user are accessible using the Deep Storage browser. 6. Optionally, select the Save Session check box. If selected, the above information is pre‐entered the next time you launch the Deep Storage browser. 7. Click Save. The Spectra Logic Deep Storage Browser main window displays. Figure 100 The Spectra Logic Deep Storage Browser main window. December 2015 User Guide—Spectra BlackPearl Gateway...
SING THE ROWSER The Deep Storage browser features an easy to use, drag‐and‐drop system for transferring files to and from the BlackPearl gateway. Use the instructions in this section to familiarize yourself with the browser, and to perform file transfer operations. Interface Overview This section provides an overview of the Deep Storage browser interface. Local host navigation icons BlackPearl navigation icons Local host BlackPearl pane pane Jobs/Log pane Figure 101 The Spectra Logic Deep Storage Browser main window. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 127
Type—The type of file or directory. Date Modifed—The date and time of the last time the file or folder was modified. This pane displays the following information about the contents of the currently BlackPearl selected location on the BlackPearl gateway. pane Name—The name of an object or bucket. Owner—The username of the assigned owner of the bucket. Only buckets assigned Deep Storage to the user accessing the gateway using the browser display. Size—The size of the file. Kind—The type of file on the gateway. Values: Object, Bucket. Created—The date and time the object or bucket was created. Jobs/Log pane This pane displays either the current job list, or the current session log. Jobs—The status of the current job being processed by the Deep Storage browser. If there are no active jobs this pane is blank. Log—The current session log of all commands sent to the BlackPearl gateway. This pane also displays any errors that occurred. December 2015 User Guide—Spectra BlackPearl Gateway...
If any names of files selected for copying to the gateway are duplicates of files already Important present on the gateway, the operation fails. No files are copied to the gateway. Read a File from the Gateway Use the instructions in this section to use the Deep Storage browser to copy a file from tape using the BlackPearl gateway. 1. Launch the Deep Storage browser using the method appropriate for your operating system (see Launch the Deep Storage Browser on page 124). The New Deep Storage Browser Session dialog box displays. If you previously connected to the BlackPearl gateway and elected to save the session information, the login information is pre‐entered in the dialog box. Click OK. The Deep Storage Browser main window displays. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 129
Chapter 8 — Using the Deep Storage Browser Using the Browser If you did not save the session information or are connecting to a BlackPearl gateway for the first time, complete the steps in Connect to a BlackPearl Gateway on page 124. 2. In the Deep Storage browser main window, navigate to the target destination in the local host pane. 3. In the BlackPearl pane of the Deep Storage browser, navigate to the source bucket location. 4. In the BlackPearl pane, select the file(s) you want to transfer to the local host. To select a consecutive group of files or folders, click the first Notes: item, press and hold down the Shift key, and then click the last item. To select non‐consecutive files or folders, press and hold down the Ctrl key, and then click each item that you want to select. 5. Drag the selected files from the BlackPearl pane to the local host pane. The files immediately begin copying to the local host. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 130
HAPTER Using AutoSupport This chapter describes using the BlackPearl user interface to configure the support features of the Spectra BlackPearl Deep Storage Gateway. Task About AutoSupport page 131 Enter Contact Information page 131 Configure Mail Recipients page 132 Add a New Recipient page 132 Edit a Mail Recipient page 133 Send a Test Email page 134 Delete a Mail Recipient page 135 Log Sets page 135 Manually Generate Log Sets page 136 Email a Log Set page 137 Download a Log Set page 138 Configure a Log Set Schedule page 138 Delete a Log Set or Log Set Schedule...
BOUT UPPORT AutoSupport lets the BlackPearl gateway automatically contact mail recipients when certain kinds of messages are generated. It is also used to generate AutoSupport Log (ASL) sets for use by Spectra Logic Technical Support. You can configure the gateway to email ASL sets when critical events occur, or on a monthly basis. You can also choose to have mail recipients receive ASL sets. NTER ONTACT NFORMATION Contact information helps Spectra Logic in contacting the administrator of the BlackPearl gateway during troubleshooting. Entering the contact information is typically a one‐time‐only process. 1. From the menu bar, select Support > Contact Information to display the Contact Information screen. 2. Click New in the Customer Contact Information pane. The New Contact Information dialog box displays. Figure 102 The New Contact Information dialog box. 3. Enter the requested information and click Create. December 2015 User Guide—Spectra BlackPearl Gateway...
ECIPIENTS You can configure AutoSupport to email system messages and log sets, as they are generated, to selected recipients. All log sets and messages are sent to a previously configured mail recipient. You cannot send log sets or messages directly to an email address. Use the Mail Recipient screen to add, edit, or delete mail recipient accounts. Figure 103 The Mail Recipients screen. Add a New Recipient 1. From the menu bar, select Configuration > Mail Recipients. The Mail Recipients screen displays. 2. Select Action > New. The New Mail Recipient dialog box displays. Figure 104 The New Mail Recipient dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
Choose the gateway recipient should receive. The BlackPearl automatically sends email message severities messages of the selected severity to the recipient when they are generated. you want to receive Note: For the mail recipient to receive all messages generated by the gateway, select all boxes. 4. Click Create to save the information. The Mail Recipients screen re‐ displays with the new mail recipient added to the list of mail recipients. Repeat Step 1 through Step 4 to configure additional mail recipients. Edit a Mail Recipient Use the following steps to edit a mail recipient account. 1. From the menu bar, select Configuration > Mail Recipients. The Mail Recipients screen displays with any already configured mail recipients listed (see Figure 103 on page 132). December 2015 User Guide—Spectra BlackPearl Gateway...
Figure 105 Edit the information for the selected mail recipient. 3. Change the information for the recipient as required and then click Save. Send a Test Email Use the following steps to send a test email to a mail recipient. 1. From the menu bar, select Configuration > Mail Recipients. The Mail Recipients screen displays with any already configured mail recipients listed (see Figure 103 on page 132). 2. From the list of mail recipients, select the name of the recipient you want to receive a test email, and then select Action > Send test email. Figure 106 The Mail Recipients screen. The BlackPearl gateway immediately sends a test email to the selected account. December 2015 User Guide—Spectra BlackPearl Gateway...
132). 2. From the list of mail recipients, select the name of the recipient whose account you want to delete and then select Action > Delete. A dialog box displays asking you to confirm the deletion of the mail recipient. Note: The default Spectra mail recipient cannot be deleted. Figure 107 Delete the selected mail recipient. 3. Click Delete to confirm the deletion. The BlackPearl gateway automatically generates log sets when errors occur. Log sets can also be generated manually, or generated on a schedule. The gateway generates three types of log sets: Log Sets contain information about the configuration and status of the BlackPearl gateway and are used for general troubleshooting. Log sets can be mailed to configured mail recipients or to Spectra Logic Technical Support. Statistic Log Sets contain performance data about the gateway and are used by Spectra Logic Technical Support for in‐depth troubleshooting. Statistic log sets are too large to be mailed directly from the gateway and must be downloaded. Kernel Log Sets are generated whenever a process on the gateway fails. This report cannot be generated manually. December 2015 User Guide—Spectra BlackPearl Gateway...
1. From the menu bar, select Support > Logs. The Logs screen displays. 2. Create the desired log set: Select Action > New Log Set to generate a log set for use in general troubleshooting. Continue with Email a Log Set on page 137 or Download a Log Set on page 138. —OR— Select Action > New Statistic Log Set to generate a log set used for in‐depth troubleshooting. This log is not human readable. To see performance statistics in a human readable form, see View Performance Metrics on page 108. Continue with Download a Log Set on page 138. —OR— December 2015 User Guide—Spectra BlackPearl Gateway...
Select the Application for which you want to generate a log set. Application Description S3 Server The S3 Server log shows all Spectra S3 API commands sent to the gateway. Data Planner The Data Planner log shows how data sent to the gateway is organized and stored to tape. b. Click Create. Continue with Email a Log Set on page 137 or Download a Log Set on page 138. Email a Log Set Use the instructions in this section to email a log set. Note: You must configure the SMTP settings on the gateway before you can send emails. See Configure SMTP Settings on page 67 to configure the SMTP settings. 1. From the menu bar, select Support > Logs. The Logs screen displays (see Figure 108). December 2015 User Guide—Spectra BlackPearl Gateway...
2. Select the log set you want to download, and then select Action > Download. The log set begins downloading to your host computer. Configure a Log Set Schedule Use the instructions in this section to configure a log set schedule. 1. From the menu bar, select Support > Logs. The Logs screen displays (see Figure 108 on page 136). 2. Select Action > New Log Set Schedule. The New Log Set Schedule dialog box displays. Figure 111 The New Log Set Schedule dialog box. December 2015 User Guide—Spectra BlackPearl Gateway...
4. Optionally, use one of the following commands to delete log sets in bulk: Command Description Action > Delete All Log Sets Deletes all log sets present on the gateway. Action > Delete All Statistic Log Sets Deletes all statistic log sets on the gateway. Action > Delete All Kernel Logs Deletes all kernel log sets on the gateway. Action > Delete All Data Path Logs Deletes all data path log sets on the gateway. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 140
HAPTER Maintaining the BlackPearl Gateway This chapter describes the maintenance procedures for the Spectra BlackPearl Deep Storage Gateway. Task Accessing the Technical Support Portal page 141 Create an Account page 141 Log Into the Portal page 142 Configuring Automated Software Upload page 143 Updating Software page 144 Check the Current Software Version page 145 Check the Currently Released Software page 145 Version Download and Stage the Updated Software page 146 Install the Update page 148 Replacing a Failed Component page 149 Identify the Failed Component...
Create an Account Access to User Guides and compatibility matrices does not require you to create an account. You must create a user account and log in to access Release Notes or repair documents, to download the latest version of BlackPearl software, or to open a support ticket. Note: If you own multiple Spectra Logic products, the serial numbers for all products are associated with your account. If you do not see the serial numbers for all of your products when you log in, contact Technical Support (see Contacting Spectra Logic on page 1. Access the Technical Support portal login page at support.spectralogic.com. 2. On the home page, click Sign up for one now! Figure 112 The Spectra Logic Technical Support portal home page. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 10 — Maintaining the BlackPearl Gateway Accessing the Technical Support Portal 3. Enter your registration information. Your account is automatically associated with the serial numbers of all Spectra Logic products owned by your site. If you have an invitation, follow the link and enter the invitation code. Figure 113 Follow the link to enter your invitation code or enter your registration information. If you do not have an invitation, enter the requested information to create your account. When you are finished, click Sign Up. When the account is approved, you receive an email with a link to setup your initial password. Use your email address and the password provided ...
4. Use the drop‐down menu to select the Check for updates frequency. 5. Optionally, select the Email Notifications Only check box to only receive an email when an updated software package is available instead of automatically download the file. 6. Select either Spectra Logic or Use Proxy as the Upload From location. Important Spectra Logic recommends using the Spectra Logic package server. If you select Use Proxy, enter the following information: Proxy IP Address—Enter a valid IPv4 address. Proxy Port—Enter the port used to access the proxy server. 7. Click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 10 — Maintaining the BlackPearl Gateway Updating Software PDATING OFTWARE Some problems with the BlackPearl gateway may be fixed by updating the gateway’s software. Spectra Logic provides complete support for the most current release of software and one revision back. Customers using previously released software packages are asked to update to the current release as soon as possible. Note: You must have a current software update key entered in the gateway you want to update. See Database Backup & Restore on page 112 for more information. If Automated Software Upload is enabled, the gateway sends an email to all users configured to receive Warning or Informational emails (see Configure Mail Recipients on page 132) and posts a system message to the Messages screen. If configured to do so, the gateway also downloads the updated software. The method used to update the gateway depends on if the Automated Software Upload feature is enabled or not, and if enabled, whether it is configured to download the updated software. If the update package downloaded automatically, skip to Install the Update on page 148. If you were notified that an update is required, but the update did not download automatically, skip to Download and Stage the Updated Software on page 146. If you do not know if the gateway needs an update installed, ...
Chapter 10 — Maintaining the BlackPearl Gateway Updating Software Check the Current Software Version Use the following steps to determine the current software version running on your BlackPearl gateway. 1. From the menu bar, select Support > Software. The Software screen displays. 2. The current software version is listed next to Current Version in the Software Update pane. Figure 115 The current BlackPearl software version. Check the Currently Released Software Version Follow these steps to check the currently recommended BlackPearl ...
Chapter 10 — Maintaining the BlackPearl Gateway Updating Software 3. On the Product Software page, locate the BlackPearl gateway in the Spectra Product column. The currently released BlackPearl software version is listed in the Current Version column. Figure 116 The Product Software screen. 4. Compare the Current Version available for the BlackPearl gateway to the version installed on the gateway. Download and Stage the Updated Software Use the instructions in this section to download and stage the updated software for the BlackPearl gateway. 1. Log into your account on the Technical Support portal at support.spectralogic.com. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 147
Chapter 10 — Maintaining the BlackPearl Gateway Updating Software 2. Select Downloads > Product Software. The Product Software Screen displays. Figure 117 The Product Software screen. 3. Locate the BlackPearl gateway in the Spectra Product column. The currently released BlackPearl software version is listed in the Current Version column. 4. Click the name of the BlackPearl package. The package begins downloading through your web browser. Do not unzip the downloaded file. December 2015 User Guide—Spectra BlackPearl Gateway...
Chapter 10 — Maintaining the BlackPearl Gateway Updating Software 5. From the BlackPearl menu bar, select Support > Software to display the Software screen. Click Choose File. Using your web browser, browse to the location of the update file and select the file to upload. The file is staged to the system. Figure 118 The Software Update screen with an available software package listed. Install the Update 1. Discontinue all file storage operations on the BlackPearl gateway. The gateway automatically reboots as part of the update process. 2. From the menu bar, select Support > Software to display the Software ...
Chapter 10 — Maintaining the BlackPearl Gateway Replacing a Failed Component 4. When the update is complete, the BlackPearl gateway automatically reboots to begin using the latest software. 5. Restart file storage operations. EPLACING A AILED OMPONENT If a component in a BlackPearl gateway is not functioning properly, the system generates a message and the hardware icon on the status bar of the BlackPearl user interface changes to an error icon (see Status Icons on page 28). Identify the Failed Component 1. From the menu bar, select Status > Hardware. The Hardware screen displays. The malfunctioning component is indicated by an error icon. Figure 121 The Hardware screen showing a failed component.
Page 150
Chapter 10 — Maintaining the BlackPearl Gateway Replacing a Failed Component 2. If you have multiple BlackPearl gateways, you can use the beacon feature to help locate the gateway with the failed component. On the Hardware screen, click the server name. The screen refreshes to show the main Hardware screen. Figure 122 The Hardware screen. 3. Click Turn Beacon On. The BlackPearl gateway Visual Status Beacon light bar flashes blue, making it easy to find. 4. After you locate the unit in your data center, click Turn Beacon Off to stop the lights from flashing. 5. For specific part replacement procedures, refer to one of the following guides, which can be found after logging into the Spectra Logic support portal at support.spectralogic.com. The Spectra 12‐ & 36‐Drive Chassis Boot Drive Replacement Guide provides instructions for replacing a failed boot drive in the gateway. The Spectra 12‐, 36‐ & 45‐Drive Chassis Drive Replacement Guide ...
Page 151
Chapter 10 — Maintaining the BlackPearl Gateway Replacing a Failed Component The Spectra 96‐Drive Chassis Drive Replacement Guide provides instructions for replacing a failed data drive in the ArcticBlue expansion node. The Spectra 96‐Drive Chassis Fan Replacement Guide provides instructions for replacing a failed fan in the ArcticBlue expansion node. The Spectra 96‐Drive Chassis Power Supply Replacement Guide provides instructions for replacing a failed power supply in the ArcticBlue expansion node. The Spectra 96‐Drive Chassis I/O Module Replacement Guide provides instructions for replacing a failed I/O module in the ArcticBlue expansion node. December 2015 User Guide—Spectra BlackPearl Gateway...
HAPTER Troubleshooting and Support Use the information in this appendix to troubleshoot problems on the Spectra BlackPearl Deep Storage Gateway as they arise, before contacting Spectra Logic Technical Support. Task Resolving a BlackPearl Management Port IP page 153 Address Conflict Using the Console page 153 Using a Separate Computer page 153 Network Setup Tips page 155 Configuration page 155 Connectivity to the Network page 156 Troubleshooting page 158 Tools page 158 Detect Topology Errors page 159 Spectra Logic Technical Support page 160 Before Contacting Support page 160 Determine Gateway Serial Number...
Chapter 11 — Troubleshooting and Support Resolving a BlackPearl Management Port IP Address Conflict IP A ESOLVING A LACK EARL ANAGEMENT DDRESS ONFLICT The default address of the BlackPearl management port is set to 10.0.0.2 with a netmask of 255.255.255.0. If your network is already using this IP address, you are not able to access the BlackPearl user interface. One resolution to the issue is to change the IP address of the machine already on your network to a different address. Then connect to the BlackPearl gateway as described in Log Into the BlackPearl User Interface on page 32. If you cannot, or do not want to change the IP address of the existing machine, follow the instructions in this section to connect your BlackPearl gateway to your network. Using the Console Using the BlackPearl console is the recommended way to change the BlackPearl management port IP address. For instructions on using the console to configure the management port IP address, see Configure the BlackPearl Management Port on page Using a Separate Computer If you cannot use the console, use a computer or laptop disconnected from ...
Page 154
Chapter 11 — Troubleshooting and Support Resolving a BlackPearl Management Port IP Address Conflict 5. Resolve the security certificate warning for the BlackPearl user interface. The warning displays because the gateway does not have a security certificate. Consult your browser documentation for instructions on Notes: how to resolve the security certificate warning. The absence of the certificate does not affect functionality. 6. Enter the login username and password. The default username and password are both spectra, using all lowercase letters. 7. From the menu bar, select Configuration > Network, or click the Network pane on the Dashboard screen. The Network screen displays information about the network connections of the gateway. 8. In the Network Interfaces pane, select the Management row, and then select Action > Edit. The Edit Management dialog box displays. Figure 123 The Edit Management dialog box.
When you change the IP address of the BlackPearl management port, you lose your connection to the user interface when you save your changes. To re‐establish the connection, enter the new IP address in your browser and log in again. 12. Disconnect the Ethernet cable from the BlackPearl management port. 13. Connect a cable from your network to the management port on the BlackPearl gateway. You are now able to connect to the gateway with the IP address configured in Step 9 on page 154. ETWORK ETUP The BlackPearl management port is separated from the data ports. The management port and data ports have their own default routes. This does not prevent a user from having the management and data ports utilizing the same network, if desired. The basic steps for configuring the management and data ports for access to the network are simple and straight‐forward. However, each network environment is unique and may require some additional troubleshooting in order to properly connect to the BlackPearl gateway and utilize the 10GBase‐T or 10 GigE interfaces correctly. Configuration The first step is to configure the management and data ports using the BlackPearl user interface or the command line interface. Do not attempt to access the system directly and use the root console to modify interfaces. The web and command line interfaces are tightly integrated with the base operating system and configure additional system features based on network changes. Note: The command line interface is not supported in the BlackPearl software version 1.2 release. December 2015 User Guide—Spectra BlackPearl Gateway...
Single gigabit logical connection utilizing one of the 10GBase‐T physical ports and a Category 5e Ethernet cable —OR— Single 10 gigabit logical connection utilizing one of the 10GBase‐T physical ports and a Category 6 Ethernet cable Assign the appropriate IP address to the management and data ports either statically or using DHCP. If you are setting the MTU to something other than 1500, ensure that your switch configuration, as well as all the hosts on the network, support larger MTU settings. The BlackPearl gateway can support jumbo frames (MTU=9000), but all switches and hosts on the network must be configured to support jumbo frames if this is selected, or performance might be degraded. Link Aggregation Notes Switches use different methods of routing traffic from hosts to NAS servers. There are also many different network configurations to move data from hosts to NAS servers. For example, some Cisco switches route traffic based on the MAC address and the IP address. The BlackPearl gateway presents only one MAC address and one IP address when the data ports are aggregated via DHCP; if static link aggregation is chosen, it presents only one MAC address, but can have up to 16 IP addresses aliased to the MAC address. It is up to the switch to rotate data transfers among the physical ports on the BlackPearl gateway in order to achieve the highest throughput possible. Additionally, if link aggregation is configured for the BlackPearl gateway, then switches must also be able to support link aggregation to aggregate or ʺtrunkʺ the data ports together to provide higher bandwidth into the gateway. Switches must support link aggregation using LACP (Link Aggregation Control Protocol), and the switches must hash the destination IP addresses. Manually configure LACP on the switch ports. LACP does not get enabled automatically. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 157
Up to 16 static IP addresses Link aggregation - two 10 GigE ports BlackPearl gateway Figure 124 Connection example utilizing two IP addresses assigned to a single share. Once configured correctly and attached to the network, the status in the user interface indicates the speed of the connection and whether the port is active. The link lights on the network ports should be on and active at both the BlackPearl gateway and the network switch. From your network, use the ʺpingʺ command (see Ping on page 158) to test the assigned IP address for the BlackPearl management port or data port. If this is not successful, follow the troubleshooting tips below to ascertain if the problem is a network setup issue. December 2015 User Guide—Spectra BlackPearl Gateway...
Port Link LED Does Not Light Check the port configuration on the network switch. The BlackPearl gateway only supports auto‐negotiation. Make sure the switch is configured to match speeds on both ends of the connection. Check the cables that connect the port to the other device. Make sure that they are connected. Verify that you are using the correct cable type and connectors. This is especially critical for 10 GigE connections utilizing SFPs. Verify that the switch ports are not administratively disabled. Consult the switch User Guide for more information. Port Link LED is Lit, But I Cannot Ping the BlackPearl gateway Check the LACP settings on the switch. If you are using link aggregation on the BlackPearl gateway, the switch MUST be configured to use LACP on those ports. If you are not using link aggregation, the switch must be configured NOT to use LACP on those ports. Check the VLAN (Virtual Local Area Network) settings on the switch. Ensure that the ports are assigned to the correct VLAN. Tools Ping The ping command is a simple tool, based on a request‐response ...
You can use the traceroute command, if it is available, or something similar, to not only verify connectivity to a remote network node, but to track the responses from intermediate nodes as well. The traceroute command sends a UDP packet to a port that is likely to not be used on a remote node with a TTL of 1. After the packet reaches the intermediate router, the TTL is decremented, and the ICMP time‐exceeded message is sent back to the originating node, which increments the TTL to 2, and the process repeats. After the UDP packet reaches a destination host, an ICMP port‐unreachable message is sent back to the sender. This action provides the sender with information about all intermediate routers on the way to the destination. For example, for a BlackPearl gateway at IP address 192.168.2.10, the output of the command shown below, traceroute 192.168.2.10 shows a numbered list indicating the number of hops encountered when tracing the packet from the switch to the BlackPearl gateway ETECT OPOLOGY RRORS The BlackPearl gateway automatically analyzes the connections between the gateway and the tape library. If any topology errors are detected, an informational message is displayed on the Topology page. To check for any topology errors, from the menu bar, select Support > Tools > Topology. The Topology page displays. Any topology errors are listed on the page. Figure 125 The Topology page. December 2015 User Guide—Spectra BlackPearl Gateway...
Support by Product and Knowledge Base tabs for additional troubleshooting information. Contact Support If the problem persists, open a support ticket (see Opening a Support Ticket on page 161). Determine Gateway Serial Number Before contacting Spectra Logic Technical Support, it is necessary to determine the serial number of the gateway. Use the following steps to display the gateway serial number. 1. From the menu bar, select Support > Contact Information. The Contact Information screen displays. 2. The gateway serial number is listed in the Product Information pane. Figure 126 The gateway serial number. December 2015 User Guide—Spectra BlackPearl Gateway...
Note: See Create an Account on page 141 if you did not previously created an account on the Technical Support portal. b. Select Incidents & Inventory > Open or View Incidents, or on the Home page, click Open a Support Incident. Figure 127 Select Incidents & Inventory > Open or View Incidents to open a support incident. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 162
Chapter 11 — Troubleshooting and Support Spectra Logic Technical Support c. On the Open or View Incidents page, you are given an opportunity to search for existing support content that may help you solve your problem immediately. If the search does not provide an answer, click Open a New Incident. Figure 128 Click Open a New Incident. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 163
Chapter 11 — Troubleshooting and Support Spectra Logic Technical Support d. On the Create Incident page, enter the requested information providing as much detail as possible. When you are finished, click Create Incident. Figure 129 The Create Incident page. If it is within the hours of coverage provided by your support contract, contact Spectra Logic Technical Support by telephone. See Contacting Spectra Logic on page December 2015 User Guide—Spectra BlackPearl Gateway...
& Restore on page 112 for more information. 5. Click Save. After Spectra Logic Technical Support informs you that they no longer require root Important access to the gateway, you should disable Remote Support to prevent any potential unauthorized access. See Disabling Remote Support on page 165 for more information.
Chapter 11 — Troubleshooting and Support Spectra Logic Technical Support Disabling Remote Support Use the instruction in this section to disable Remote Support. 1. From the menu bar, select Configuration > Users. The Users screen displays a list of all users configured on the gateway. 2. Double‐click the Spectra account in the Primary Administrators pane, or select the Spectra account, and then select Action > Edit. The Edit User dialog box appears. Figure 131 The Edit User dialog box. 3. Clear the Enable Remote Support check box. 4. Click Save. December 2015 User Guide—Spectra BlackPearl Gateway...
PPENDIX Specifications This appendix provides detailed specifications for the Spectra BlackPearl Deep Storage Gateways. The specifications listed here pertain to the currently shipping BlackPearl chassis. Note: For specifications that differ for the BlackPearl 1.0 chassis, see Appendix B BlackPearl 1.0 Chassis Overview & Specifications on page page 174. Specification Data Storage Specifications page 167 Drive Specifications page 167 Gateway Specifications page 167 System Specification page 168 Size and Weight page 169 Environmental Specifications page 170 Power Requirements page 170 Input Power Requirements page 170 Power Cords page 171 Interface Specifications...
Note: The BlackPearl 2U gateway does not use solid‐state drives. Parameter Specification Drive type Spinning‐Disk SAS Single drive capacity, native 4 TB a. 1 TB is defined as 1,000,000,000,000 bytes. Gateway Specifications Parameter Specification BlackPearl 4U Gateway capacity 52 TB BlackPearl 2U Gateway capacity 26 TB RAID level Double Parity a. 1 TB is defined as 1,000,000,000,000 bytes. December 2015 User Guide—Spectra BlackPearl Gateway...
10GBase-T ports can negotiate down to 10/100/1000Base-T speeds. BlackPearl 4U Gateway Parameter Specifications Two multi‐core processors System disk drives Two 250 GB SATA disk drives Memory 128 GB (8 x 16 GB DIMMs) Two integrated 10GBase‐T Ethernet ports Interface connections One dual‐port 10 Gigabit Ethernet NIC (Optional) four‐port SAS card (Optional) two‐port SAS card (Optional) two‐port Fibre Channel card a. 10GBase-T ports can negotiate down to 10/100/1000Base-T speeds. December 2015 User Guide—Spectra BlackPearl Gateway...
Drive configuration is two solid-state drives and ten spinning-disk drives. e. Drive configuration is six solid-state drives and twenty spinning-disk drives. f. The base gateway ships with two solid-state drives and ten spinning-disk drives. Additional drives are shipped separately. December 2015 User Guide—Spectra BlackPearl Gateway...
12 hours before opening to prevent serious condensation damage from occurring. b. The BlackPearl gateway is in its original packaging. The packaging is designed to protect the BlackPearl gateway from condensation caused by extreme temperature variations (27° F per hour or 15° C per hour, or more).
North American 220 Volt-AC Power Cord. The criteria for a 220‐volt power cord for use in the United States and Canada are as follows: Parameter Specification Power cordage SJT type, three‐conductor, 14 AWG minimum Male: Connector must be of the proper type, Power input connectors rating, and safety approval. Female: IEC 60320 C13 International 220 Volt-AC Power Cord. The criteria for an international 220‐volt AC power cord are as follows: Parameter Specification Power cordage Flexible, HAR (harmonized) type H05VV‐F, three conductor, cord with minimum conductor size of 1.7 square millimeters (0.0026350 square inches). Male: Connector must be of the proper type, Power input connectors rating, and safety approval for the intended country. Female: IEC 60320 C13 December 2015 User Guide—Spectra BlackPearl Gateway...
Ethernet (10 GigE) Two SFP+ optical modules with a duplex LC connector Four SFF‐8644 sockets per optional SAS card for connection to a BlackPearl expansion node. Two SFF‐8644 sockets per optional SAS card to connect to an ArcticBlue expansion node. Fibre Channel Two SFP+ optical modules with LC connectors per optional Fibre Channel card Network Interface Cables The type of cables required to connect the BlackPearl gateway to the network depend on the type of interface being used. Interface Type Cable Requirements Ethernet (10GBase‐T 10GBase‐T ‐ Shielded Category 6A data‐grade cable or 10/100/1000Base‐T) with a RJ‐45 connector. 10/100/1000Base‐T ‐ Shielded Category 5 data‐grade cable with a RJ‐45 connector Ethernet (10 GigE) Multimode optical cable with duplex LC connectors BlackPearl expansion node: 6Gbps 4 lane cable with SFF‐8644 and SFF‐8088 connectors ArcticBlue expansion node: 12Gbps cable with SFF‐ 8644 connectors Fibre Channel 50 micron—400‐M5‐SN‐I classification December 2015 User Guide—Spectra BlackPearl Gateway...
Appendix A — Specifications Interface Specifications Universal Serial Bus (USB) Support Spectra Logic supports using the USB ports on the gateway for the following: USB mass storage devices (for example, flash drives) Keyboards & pointer devices (for example, a computer mouse) CD or DVD drives with USB interface Spectra Logic does not support using the USB ports for the following: Cameras Multimedia devices (for example, MP3 players) December 2015 User Guide—Spectra BlackPearl Gateway...
Page 174
PPENDIX BlackPearl 1.0 Chassis Overview & Specifications This chapter provides an overview and specifications for the Spectra Logic BlackPearl Deep Storage Gateway 1.0 chassis. Topic Components page 175 Front View page 175 Rear View page 176 Rear Panel page 177 Specifications page 179 System Specification page 179 Interface Specifications page 180...
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Components OMPONENTS The following sections show the locations of and briefly describe the BlackPearl 1.0 chassis major front and rear panel components. Front View Figure 132 and Figure 133 show the components on the front of the BlackPearl gateways with the front bezel removed. Visual Status Beacon Latch Data drive status LEDs control sled Visual Status Beacon Latch Data drive status LEDs control sled Data drives...
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Components Rear View Figure 134 and Figure 135 show the major components on the rear of the BlackPearl gateway. Power supplies Rear panel Power supplies Rear panel Boot drives Data drives Figure 134 The rear view of the BlackPearl 4U Figure 135 The rear view of the BlackPearl 2U gateway.
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Components Rear Panel Figure 136 shows the components on the rear panel of the BlackPearl 4U and 2U gateways. IPMI management port Gigabit Monitor 10 GigE ports (2) Ethernet ports (4) connector Optional SAS ports (4) BlackPearl Serial Expansion port ports (4) management port slots Figure 136 The BlackPearl rear panel components.
Page 178
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Components Component Description Expansion slots The expansion slots accommodate optional interface cards to provide additional connectivity. An installed 10 Gigabit Ethernet network interface card provides high‐speed data connection between hosts and the BlackPearl gateway. An optional SAS or Fibre Channel card provides connectivity between the BlackPearl gateway and tape drives in a Spectra Logic tape library. BlackPearl The BlackPearl management port is used to connect to a browser‐based user management port interface to configure, manage, and monitor the BlackPearl gateway. The BlackPearl management port cannot be used for data transfer. USB ports If necessary, you can use these ports to connect a USB drive, or USB keyboard to the chassis for troubleshooting purposes. Only connect a USB drive or keyboard as directed by Spectra Logic Technical Support. Not currently used. Serial port December 2015 User Guide—Spectra BlackPearl Gateway...
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Specifications PECIFICATIONS The following sections describe the specifications of the BlackPearl 1.0 chassis, where they differ from the current chassis. See Appendix A Specifications on page 166 for specification information not listed here. System Specification The following table provides an overview of the system devices installed in the BlackPearl gateways. BlackPearl 2U Gateway Parameter Specifications One multi‐core processors System disk drives Two 250 GB SATA disk drives Memory 64 GB (4 x 16 GB DIMMs) Four integrated Gigabit Ethernet ports Interface connections One dual‐port 10 Gigabit Ethernet NIC (Optional) four‐port SAS card ...
Appendix B — BlackPearl 1.0 Chassis Overview & Specifications Specifications Interface Specifications This section provides information about the interfaces used to connect a BlackPearl gateway with a BlackPearl 1.0 chassis, to the host systems. Interface Connectors Interface Type Number of Ports and Connector Type Ethernet (GigE) Four RJ‐45 sockets Ethernet (10 GigE) Two SFP+ optical modules with a duplex LC connector Four SFF‐8644 sockets per optional SAS card Fibre Channel Two SFP+ optical modules with LC connectors per optional Fibre Channel card Network Interface Cables The type of cables required to connect the BlackPearl gateway to the network depend on the type of interface being used. Interface Type Cable Requirements Ethernet (GigE)
PPENDIX Regulatory & Safety Standards The Spectra BlackPearl Deep Storage Gateway complies with the safety and regulatory agency standards listed below when installed by a Spectra Logic certified engineer or third‐party provider. EU D ECLARATION OF ONFORMITY Spectra Logic Corporation 6101 Lookout Road Boulder, CO 80301 USA declare under sole responsibility that the Spectra BlackPearl Deep Storage Gateway to which this declaration relates, meets the essential health and safety requirements and is in conformity with the EU Directives listed below using the relevant section of the EU standards and other normative documents listed in the following table. Matt Starr Chief Technical Officer, Spectra Logic Corporations Directive Compliance EU EMC Directive Essential health and safety requirements relating to electromagnetic 89/336/EEC compatibility. EN 55022 Limits and methods of measurements of radio interference characteristics of (CISPER 22) Class A information technology equipment. EN 55024 1998, Information Technology Equipment ‐ Immunity Characteristics Limits and Methods of Measurement. EN 61000‐4‐2 1995 + A1:1998+A2: 2001, Electrostatic Discharge EN 61000‐4‐3...
Certifications Country Certification Covers Canada BlackPearl gateway China Power supply only BlackPearl gateway Taiwan BSMI Power supply only UL, FCC BlackPearl gateway Japan VCCI BlackPearl gateway The BlackPearl gateway complies with all safety‐relevant provisions referring Protection against electrical hazards Protection against hazards such as: Mechanical hazards Fire hazards Noise Vibration The safety issues of this information technology equipment type have been evaluated by a government‐accredited European third‐party organization, such as Nemko. December 2015 User Guide—Spectra BlackPearl Gateway...
AFETY TANDARDS AND OMPLIANCE The Spectra BlackPearl gateway complies with the following domestic and international product safety standards. EN 60950‐1 Second Edition UL 60950‐1 Second Edition CSA‐C22.2 No. 60950‐1‐03 Low Voltage Directive (EU: CE Mark) Waste of Electronic and Electrical Equipment (WEEE) Directive The following symbol on the back of this product indicates that this product meets the European Directive 2000/96/EC on Waste Electrical and Electronic Equipment known as the WEEE directive. This directive, only applicable in European Union countries, indicates that this product should not be disposed of with normal unsorted municipal waste. December 2015 User Guide—Spectra BlackPearl Gateway...
WEEE collection instructions for this product. Restriction of Hazardous Substances in Electrical and Electronic Equipment (RoHS) The RoHS marking indicates that this product is in compliance with European Council Directive 2011/65/2008, on the restriction of the use of certain hazardous substances in electrical and electronic equipment. ONFLICT INERALS OLICY Spectra Logic is committed to complying with the OECD Due Diligence Guidance for Responsible Supply Chains of Minerals from Conflict‐ Affected and High‐Risk Areas, as well as the applicable requirements of Section 1502 of the Dodd‐Frank Act, which aims to prevent the use of minerals that directly or indirectly finance or benefit armed groups in the Democratic Republic of the Congo (DRC) or in adjoining countries (“conflict minerals”). Affected suppliers to Spectra Logic will be required to commit to being or becoming “conflict‐free” (which means that such supplier does not source conflict minerals) and sourcing, where possible, only from conflict‐free smelters. Each affected supplier to Spectra Logic will be required to provide completed EICC‐GeSI declarations evidencing such supplierʹs commitment to becoming conflict‐free and documenting countries of origin for the tin, tantalum, tungsten, and gold that it purchases. For more information on Spectra Logicʹs conflict minerals program contact conflictminerals@spectralogic.com. December 2015 User Guide—Spectra BlackPearl Gateway...
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The views and conclusions contained in the software and documentation are those of the authors and should not be interpreted as representing official policies, either expressed or implied, of the FreeBSD Project. ORACLE AMERICA, INC. (ʺORACLEʺ), FOR AND ON BEHALF OF ITSELF AND ITS SUBSIDIARIES AND AFFILIATES UNDER COMMON CONTROL, IS WILLING TO LICENSE THE SOFTWARE TO YOU ONLY UPON THE CONDITION THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS BINARY CODE LICENSE AGREEMENT AND SUPPLEMENTAL LICENSE TERMS (COLLECTIVELY ʺAGREEMENTʺ). PLEASE READ THE AGREEMENT CAREFULLY. BY SELECTING THE ʺACCEPT LICENSE AGREEMENTʺ (OR THE EQUIVALENT) BUTTON AND/OR BY USING THE SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE READ THE TERMS AND AGREE TO THEM. IF YOU ARE AGREEING TO THESE TERMS ON BEHALF OF A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THE LEGAL ENTITY TO THESE TERMS. IF YOU DO NOT HAVE SUCH AUTHORITY, OR IF YOU DO NOT WISH TO BE BOUND BY THE TERMS, THEN SELECT THE ʺDECLINE LICENSE AGREEMENTʺ (OR THE EQUIVALENT) BUTTON AND YOU MUST NOT USE THE SOFTWARE ON THIS SITE OR ANY OTHER MEDIA ON WHICH THE SOFTWARE IS CONTAINED. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 187
Agreement. ʺGeneral Purpose Desktop Computers and Serversʺ means computers, including desktop and laptop computers, or servers, used for general computing functions under end user control (such as but not specifically limited to email, general purpose Internet browsing, and office suite productivity tools). The use of Software in systems and solutions that provide dedicated functionality (other than as mentioned above) or designed for use in embedded or function‐specific software applications, for example but not limited to: Software embedded in or bundled with industrial control systems, wireless mobile telephones, wireless handheld devices, kiosks, TV/STB, Blu‐ray Disc devices, telematics and network control switching equipment, printers and storage management systems, and other related systems are excluded from this definition and not licensed under this Agreement. ʺProgramsʺ means (a) Java technology applets and applications intended to run on the Java Platform, Standard Edition platform on Java‐enabled General Purpose Desktop Computers and Servers; and (b) JavaFX technology applications intended to run on the JavaFX Runtime on JavaFX‐enabled General Purpose Desktop Computers and Servers. “Commercial Features” means those features identified in Table 1‐1 (Commercial Features In Java SE Product Editions) of the Java SE documentation accessible at http://www.oracle.com/technetwork/java/ javase/documentation/index.html. “README File” means the README file for the Software accessible at http://www.oracle.com/technetwork/java/ javase/documentation/index.html. 2. LICENSE TO USE. Subject to the terms and conditions of this Agreement including, but not limited to, the Java Technology Restrictions of the Supplemental License Terms, Oracle grants you a non‐exclusive, non‐ transferable, limited license without license fees to reproduce and use internally the Software complete and unmodified for the sole purpose of running Programs. THE LICENSE SET FORTH IN THIS SECTION 2 DOES NOT EXTEND TO THE COMMERCIAL FEATURES. YOUR RIGHTS AND OBLIGATIONS RELATED TO THE COMMERCIAL FEATURES ARE AS SET FORTH IN THE SUPPLEMENTAL TERMS ALONG WITH ADDITIONAL LICENSES FOR DEVELOPERS AND PUBLISHERS. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 188
License Terms. 4. DISCLAIMER OF WARRANTY. THE SOFTWARE IS PROVIDED ʺAS ISʺ WITHOUT WARRANTY OF ANY KIND. ORACLE FURTHER DISCLAIMS ALL WARRANTIES, EXPRESS AND IMPLIED, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. 5. LIMITATION OF LIABILITY. IN NO EVENT SHALL ORACLE BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR DATA USE, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, EVEN IF ORACLE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ORACLEʹS ENTIRE LIABILITY FOR DAMAGES HEREUNDER SHALL IN NO EVENT EXCEED ONE THOUSAND DOLLARS (U.S. $1,000). 6. TERMINATION. This Agreement is effective until terminated. You may terminate this Agreement at any time by destroying all copies of Software. This Agreement will terminate immediately without notice from Oracle if you fail to comply with any provision of this Agreement. Either party may terminate this Agreement immediately should any Software become, or in either partyʹs opinion be likely to become, the subject of a claim of infringement of any intellectual property right. Upon termination, you must destroy all copies of Software. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 189
8. TRADEMARKS AND LOGOS. You acknowledge and agree as between you and Oracle that Oracle owns the ORACLE and JAVA trademarks and all ORACLE‐ and JAVA‐related trademarks, service marks, logos and other brand designations (ʺOracle Marksʺ), and you agree to comply with the Third Party Usage Guidelines for Oracle Trademarks currently located at http://www.oracle.com/us/legal/third‐party‐trademarks/index.html . Any use you make of the Oracle Marks inures to Oracleʹs benefit. 9. U.S. GOVERNMENT LICENSE RIGHTS. If Software is being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), then the Governmentʹs rights in Software and accompanying documentation shall be only those set forth in this Agreement. 10. GOVERNING LAW. This agreement is governed by the substantive and procedural laws of California. You and Oracle agree to submit to the exclusive jurisdiction of, and venue in, the courts of San Francisco, or Santa Clara counties in California in any dispute arising out of or relating to this agreement. 11. SEVERABILITY. If any provision of this Agreement is held to be unenforceable, this Agreement will remain in effect with the provision omitted, unless omission would frustrate the intent of the parties, in which case this Agreement will immediately terminate. 12. INTEGRATION. This Agreement is the entire agreement between you and Oracle relating to its subject matter. It supersedes all prior or contemporaneous oral or written communications, proposals, representations and warranties and prevails over any conflicting or additional terms of any quote, order, acknowledgment, or other communication between the parties relating to its subject matter during the term of this Agreement. No modification of this Agreement will be binding, unless in writing and signed by an authorized representative of each party. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 190
Appendix D — Open Source Code Acknowledgements & Package List Java SUPPLEMENTAL LICENSE TERMS These Supplemental License Terms add to or modify the terms of the Binary Code License Agreement. Capitalized terms not defined in these Supplemental Terms shall have the same meanings ascribed to them in the Binary Code License Agreement. These Supplemental Terms shall supersede any inconsistent or conflicting terms in the Binary Code License Agreement, or in any license contained within the Software. A. COMMERCIAL FEATURES. You may not use the Commercial Features for running Programs, Java applets or applications in your internal business operations or for any commercial or production purpose, or for any purpose other than as set forth in Sections B, C, D and E of these Supplemental Terms. If You want to use the Commercial Features for any purpose other than as permitted in this Agreement, You must obtain a separate license from Oracle. B. SOFTWARE INTERNAL USE FOR DEVELOPMENT LICENSE GRANT. Subject to the terms and conditions of this Agreement and restrictions and exceptions set forth in the README File incorporated herein by reference, including, but not limited to the Java Technology Restrictions of these Supplemental Terms, Oracle grants you a non‐exclusive, non‐transferable, limited license without fees to reproduce internally and use internally the Software complete and unmodified for the purpose of designing, developing, and testing your Programs. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 191
Oracleʹs interests consistent with the terms contained in this Agreement and that includes the notice set forth in Section H, and (vi) you agree to defend and indemnify Oracle and its licensors from and against any damages, costs, liabilities, settlement amounts and/or expenses (including attorneysʹ fees) incurred in connection with any claim, lawsuit or action by any third party that arises or results from the use or distribution of any and all Programs and/or Software. The license set forth in this Section C does not extend to the Software identified in Section G. D. LICENSE TO DISTRIBUTE REDISTRIBUTABLES. Subject to the terms and conditions of this Agreement and restrictions and exceptions set forth in the README File, including but not limited to the Java Technology Restrictions and Limitations on Redistribution of these Supplemental Terms, Oracle grants you a non‐exclusive, non‐transferable, limited license without fees to reproduce and distribute those files specifically identified as redistributable in the README File (ʺRedistributablesʺ) provided that: (i) you distribute the Redistributables complete and unmodified, and only bundled as part of Programs, (ii) the Programs add significant and primary functionality to the Redistributables, (iii) you do not distribute additional software intended to supersede any component(s) of the Redistributables (unless otherwise specified in the applicable README File), (iv) you do not remove or alter any proprietary legends or notices contained in or on the Redistributables, (v) you only distribute the Redistributables pursuant to a license agreement that: (a) is a complete, unmodified reproduction of this Agreement; or (b) protects Oracleʹs interests consistent with the terms contained in the Agreement and includes the notice set forth in Section H, (vi) you agree to defend and indemnify Oracle and its licensors from and against any damages, costs, liabilities, settlement amounts and/or expenses (including attorneysʹ fees) incurred in connection with any claim, lawsuit or action by any third party that arises or results from the use or distribution of any and all Programs and/or Software. The license set forth in this Section D does not extend to the Software identified in Section G. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 192
(including with respect to all proprietary notices) and distributed with your Publication subject to a license agreement that is a complete, unmodified reproduction of this Agreement; (v) The Media label shall include the following information: “Copyright [YEAR], Oracle America, Inc. All rights reserved. Use is subject to license terms. ORACLE and JAVA trademarks and all ORACLE‐ and JAVA‐related trademarks, service marks, logos and other brand designations are trademarks or registered trademarks of Oracle in the U.S. and other countries.” [YEAR] is the year of Oracleʹs release of the Software; the year information can typically be found in the Software’s “About” box or screen. This information must be placed on the Media label in such a manner as to only apply to the JDK; (vi) You must clearly identify the JDK as Oracleʹs product on the Media holder or Media label, and you may not state or imply that Oracle is responsible for any third‐party software contained on the Media; (vii) You may not include any third party software on the Media which is intended to be a replacement or substitute for the JDK; (viii) You agree to defend and indemnify Oracle and its licensors from and against any damages, costs, liabilities, settlement amounts and/or expenses (including attorneysʹ fees) incurred in connection with any claim, lawsuit or action by any third party that arises or results from the use or distribution of the JDK and/or the Publication; ; and (ix) You shall provide Oracle with a written notice for each Publication; such notice shall include the following information: (1) title of Publication, (2) author(s), (3) date of Publication, and (4) ISBN or ISSN numbers. Such notice shall be sent to Oracle America, Inc., 500 Oracle Parkway, Redwood Shores, California 94065 U.S.A , Attention: General Counsel. F. JAVA TECHNOLOGY RESTRICTIONS. You may not create, modify, or change the behavior of, or authorize your licensees to create, modify, or change the behavior of, classes, interfaces, or subpackages that are in any way identified as ʺjavaʺ, ʺjavaxʺ, ʺsunʺ, “oracle” or similar convention as specified by Oracle in any naming convention designation. December 2015 User Guide—Spectra BlackPearl Gateway...
Page 193
Oracleʹs Java SE Support program. H. COMMERCIAL FEATURES NOTICE. For purpose of complying with Supplemental Term Section C.(v)(b) and D.(v)(b), your license agreement shall include the following notice, where the notice is displayed in a manner that anyone using the Software will see the notice: Use of the Commercial Features for any commercial or production purpose requires a separate license from Oracle. “Commercial Features” means those features identified Table 1‐1 (Commercial Features In Java SE Product Editions) of the Java SE documentation accessible at http:// www.oracle.com/technetwork/java/javase/documentation/index.html I. SOURCE CODE. Software may contain source code that, unless expressly licensed for other purposes, is provided solely for reference purposes pursuant to the terms of this Agreement. Source code may not be redistributed unless expressly provided for in this Agreement. J. THIRD PARTY CODE. Additional copyright notices and license terms applicable to portions of the Software are set forth in the THIRDPARTYLICENSEREADME file accessible at http:// www.oracle.com/technetwork/java/javase/documentation/index.html. In addition to any terms and conditions of any third party opensource/ freeware license identified in the THIRDPARTYLICENSEREADME file, the disclaimer of warranty and limitation of liability provisions in paragraphs 4 and 5 of the Binary Code License Agreement shall apply to all Software in this distribution. K. TERMINATION FOR INFRINGEMENT. Either party may terminate this Agreement immediately should any Software become, or in either partyʹs opinion be likely to become, the subject of a claim of infringement of any intellectual property right. L. INSTALLATION AND AUTO‐UPDATE. The Softwareʹs installation and auto‐update processes transmit a limited amount of data to Oracle (or its service provider) about those specific processes to help Oracle understand and optimize them. Oracle does not associate the data with personally identifiable information. You can find more information about the data Oracle collects as a result of your Software download at http:// www.oracle.com/technetwork/java/javase/documentation/index.html. December 2015 User Guide—Spectra BlackPearl Gateway...
(LGPL version 2.1). The additional components listed below are covered under separate license agreements: Samba 3.0 Client libraries and tools ‐ GPLv2 Novell DCE‐RPC ‐ BSD libiconv ‐ LGPLv2 For more details and for the full text for each of these licenses, read the LICENSES and COPYING files included with the source packaging of this software. On Debian GNU/Linux systems, the complete text of the GNU General Public License can be found in `/usr/share/common‐licenses/GPLʹ. Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.jp>. You can redistribute it and/or modify it under either the terms of the 2‐clause BSDL (see the file BSDL), or the conditions below: 1. You may make and give away verbatim copies of the source form of the software without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers. 2. You may modify your copy of the software in any way, provided that you do at least ONE of the following: a. place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to Usenet or an equivalent medium, or by allowing the author to include your modifications in the software. b. use the modified software only within your corporation or organization. c. give non‐standard binaries non‐standard names, with instructions on where to get the original software distribution. d. make other distribution arrangements with the author. December 2015 User Guide—Spectra BlackPearl Gateway...
4. You may modify and include the part of the software into any other software (possibly commercial). But some files in the distribution are not written by the author, so that they are not under these terms. For the list of those files and their copying conditions, see the file LEGAL. 5. The scripts and library files supplied as input to or produced as output from the software do not automatically fall under the copyright of the software, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this software. 6. THIS SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. UBY ON AILS Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. December 2015 User Guide—Spectra BlackPearl Gateway...
Appendix D — Open Source Code Acknowledgements & Package List COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL) Version 1.0 NCLUDED ACKAGES alsa‐lib‐1.0.27.2_2 bash‐4.3.18_2 boost‐libs‐1.55.0_3 ca_root_nss‐3.16.1 cdbcmd‐3.19.79 cscope‐15.8a curl‐7.37.0 dejavu‐2.34_3 dmidecode‐2.12 ds3‐0.0.0_1 e2fsprogs‐libuuid‐1.42.10_1 expat‐2.1.0_1 fio‐2.1.9 fixesproto‐5.0 fontconfig‐2.11.0_3,1 freetype2‐2.5.3_2 fusefs‐libs‐2.9.3_2 gettext‐0.18.3.1_1 glib‐2.36.3_3 go‐1.3,1 icu‐53.1 indexinfo‐0.2 inputproto‐2.3 iozone‐3.420 ipmitool‐1.8.14 jakarta‐commons‐daemon‐1.0.15 java‐zoneinfo‐2014.e December 2015 User Guide—Spectra BlackPearl Gateway...
Page 197
December 2015 User Guide—Spectra BlackPearl Gateway...
Page 198
December 2015 User Guide—Spectra BlackPearl Gateway...
Page 199
December 2015 User Guide—Spectra BlackPearl Gateway...
Page 200
December 2015 User Guide—Spectra BlackPearl Gateway...
Page 201
December 2015 User Guide—Spectra BlackPearl Gateway...
Page 202
Appendix D — Open Source Code Acknowledgements & Package List Included Packages vim‐7.4.334 xauth‐1.0.8_1 xextproto‐7.3.0 xproto‐7.0.25 zip‐3.0 zsh‐5.0.5_1 December 2015 User Guide—Spectra BlackPearl Gateway...
Page 203
RoHS network connections autosupport about services configure mail recipient conflict mineral policy icons enter contact information contact information, enter component OK contacting error condition Technical Support information contacting Spectra Logic unknown state corporate headquarters, Spectra BlackPearl warning Logic components to 21, information icon features monitoring overview Deep Storage browser power license, software about serial number connect to gateway size and weight download specifications 168, 179 interface overview...
Page 204
USB, support license software version check current available version specifications Visual Status Beacon, lights data storage environmental power power cords size and weight warning icon system 168, 179 website Spectra Logic Spectra Logic contacting December 2015 User Guide—Spectra BlackPearl Gateway...
Need help?
Do you have a question about the BlackPearl and is the answer not in the manual?
Questions and answers