Installation Guide For Neverfail® HybriStor™ v2.3 You can find the most up-to-date technical documentation at Artisan Infrastructure’s Support Resource Center:
https://portal.vpdc.us/aspx/Support_Resource_Center_2_0.
Artisan Infrastructure, LLC has taken all reasonable care to ensure the information in this document is accurate at the date of publication. In relation to any information on third party products or services, Artisan Infrastructure, LLC has relied on the best available information published by such parties. Artisan Infrastructure, LLC is continually developing its products and services, therefore the functionality and technical specifications of Artisan Infrastructure’s products can change at any time. For the latest information on Artisan Infrastructure’s products and services, please contact us by email ( [email protected] or visit our Web site www.artisaninfrastructure.com ).
All third party product names referred to in this document are acknowledged as the trade marks for their respective owner entities.
Copyright © 2016 Artisan Infrastructure, LLC. All rights reserved. Contents
Chapter 1: Introduction...... 4 Product Overview...... 4
Chapter 2: Installation...... 5 Object Storage and Local Storage for Data Storage...... 5 Installation of Neverfail® HybriStor™ as a Virtual Appliance...... 6 Prerequisites...... 6 Installation of the HybriStor™ Appliance...... 6 Installation of Neverfail® HybriStor™ from a DVD/ISO...... 11 Prerequisites...... 11 Install HybriStor™ - Manual Setup...... 11 Install HybriStor™ - Automated Setup - Software RAID 1...... 14 Install HybriStor™ - Automated OS Setup - Hardware...... 16
Chapter 3: Setup Configuration...... 18 Installation Using Object Storage data protection...... 18 Installation with Local Storage Using Software RAID Data Protection...... 23 Installation with Local Storage Using Hardware RAID Data Protection...... 27 Installation Using Other/None Data Protection...... 32
Appendix A: Operating System Configuration...... 36 Recommended Partition Sizes...... 36 Configuring the Operating System with Hardware RAID...... 36 Configuring the Operating System with Software RAID (use for object storage also)...... 39
Appendix B: Installation Tips and Best Practices...... 45 Installation on a Physical Server...... 45 Installation on a Virtual Machine...... 47
Appendix C: Troubleshooting...... 49 Licensing Mismatch...... 49 Cannot Mount NFS Share from an Older Linux Kernel Client...... 49
Artisan Infrastructure iii Chapter 1
Introduction
Topics:
• Product Overview
Product Overview
HybriStor™ provides a deduplicating interface for either locally-attached storage or Swift object storage. The front end of the HybriStor™ server consists of either Network File System (NFS) or Common Internet File System (CIFS) shares. A future version of HybriStor™ will support clustered operations, thereby, allowing several HybriStor™ servers to operate together to allow increased performance, large capacities, and fault tolerance.
Architecture The HybriStor™ product is offered as both a virtual appliance to be deployed in a virtual environment and also as a DVD/ISO to be installed in an existing environment consisting of either physical hardware, virtual machines, or a combination of both. This document addresses the installation of HybriStor™ when deployed in either environment.
Artisan Infrastructure 4 Chapter 2
Installation
Topics:
• Object Storage and Local Storage for Data Storage • Installation of Neverfail® HybriStor™ as a Virtual Appliance • Installation of Neverfail® HybriStor™ from a DVD/ISO
Object Storage and Local Storage for Data Storage
Neverfail® HybriStor™ can be used with an object storage backend for data or with local, file system storage for data. When used with local storage, that local storage can use either software RAID, hardware RAID, or other protection. It is not recommended to use no redundancy at all for a production environment. In addition to the storage for data, HybriStor™ also requires processing storage and index storage.
Note: The processing storage is always local and must be SSD for performance purposes.
Object Storage Currently, HybriStor™ supports the use of the Swift object storage system for data storage.
Note: Other object storage systems are being tested for possible inclusion as supported systems.
Local Storage Using Software RAID The data storage is local on the HybriStor™ server.The operating system provides redundancy though the use of software RAID. When software RAID is used for the data storage, software RAID is also used for the processing and index, and is suggested for the operating system.
Local Storage Using Hardware RAID The data storage is local on the HybriStor™ server. Data redundancy is offered below the operating system level, allowing the operating system to see single volumes. When Hardware RAID is used for the data storage, hardware RAID is also used for the processing and index, and is suggested for the operating system.
Artisan Infrastructure 5 Installation Guide
Note: This option is also appropriate when no redundancy is desired (for example, demo, test, or training).
Installation of Neverfail® HybriStor™ as a Virtual Appliance
Prerequisites
Operating System Requirements • VMware ESXi 5.5 or 6.0
Virtual Appliance with 1-10TB of Repository
Component Description
CPU 6 available cores
RAM Minimum 26 GB
OS Disk Minimum 50 GB using hardware RAID 1. This will be used by the OVA file
Processing Disk (SSD Disk) Minimum 50 GB SSD with minimum 1 DWPD using hardware RAID 1
(Optional) InstaCache™ (SSD Minimum 100 GB SSD with minimum 1 DWPD Disk) Note: You can use a SAS disk for functional testing if performance is not a requirement.
Index Disk (SATA/SAS) Minimum 300 GB using hardware RAID 1
Note: You can use a SAS disk for functional testing if performance is not a requirement.
Data Disk (SATA/SAS) 1-10 TB using hardware RAID 5 or RAID 6
NIC Recommended 1 x 10GbE
Note: 1. All disks should be on their own dedicated spindles for optimal performance. 2. If the Data Disk is greater than 2 TB, it is required that a Web client is used to create these disks. 3. The Processing Disk must be SSD for performance purposes.
Installation of the HybriStor™ Appliance
Procedure
1. Installing the Neverfail® HybriStor™ appliance OVA using VMWare vSphere Web Client. a) Using the VMware vSphere Web Client, navigate to Home and select VM and Templates in the right pane.
6 Artisan Infrastructure Installation
b) Select Datacenter in the left pane, click the Actions drop-down at the top of the right pane and select Deploy OVF template as shown in the image below.
c) When the Deploy OVF Template dialog is displayed, follow the on-screen instructions and browse to the .ova file you previously downloaded and click Next. d) Review the details of the OVA, and click Next. e) Review the End User License Agreement, click Accept, and then click Next. f) Assign a Name for the virtual machine, select a Folder for the virtual machine, and click Next. g) Select a storage resource for the virtual machine and click Next. h) Leave the default Thick Provision Lazy Zeroed for disk provisioning, select a storage capacity of at least 80 GB of free capacity, and then click Next.
Note: For performance reasons, it is recommended that you use Thick Provision Lazy Zeroed for disk provisioning.
i) Setup networking as appropriate and click Next. j) Review your configuration and click Finish to complete importing the virtual machine. 2. Configuring the appliance with VMWare vSphere Web Client. Adding New Disks a) Right-click on the virtual machine that you just deployed/imported and select Edit Settings. b) In the New device field located at the bottom of the Edit Settings dialog, select New Hard Disk and click Add. c) Adjust the size of the hard disk you just added to at least 50 GB for Processing Disk. d) Double-click on New Hard disk, select Store with the virtual machine, and click Browse in the Location field to select the disk that you have pre-configured with SSD. e) If your license includes InstaCache™, repeat steps b, c and d to add a new 400 GB hard disk for InstaCache™. f) Repeat steps b, c and d to add a new hard disk with at least 300 GB in size for Index Disk. g) Repeat steps b, c and d to add a new hard disk with 1-10 TB in size for Data Disk. Network Configuration The HybriStor™ appliance, by default, comes configured with one network adapter (VMXNET 3) using DHCP on the VM Network. If your environment supports VMXNET 3 and DHCP, skip this section and go to step 3. a) Right-click the appliance and select Edit Settings.
Artisan Infrastructure 7 Installation Guide
b) In the Network adapter 1 field, click on VM Network and select an appropriate network for your environment. c) Double-click on Network adapter 1 and ensure Connect at Power On is selected in the Status field. d) Click OK to save the settings. 3. Powering on the VM a) Right-click the HybriStor™ appliance and select Power On. Navigate to the Summary page of your HybriStor™ appliance in VMware vSphere Web Client to launch the console. b) The default user is root and the password is Changeme123$.You are required to change the password as soon as you login. 4. Changing Network Adapter Settings
Note: Skip this step and go to step 5 if your network adapter type is VMXNET 3 and you can use DHCP.
For VMXNET 3 Network Adapter If your network adapter type is not VMXNET 3, go to the next section to configure non-VMXNET 3 network adapter. If your network adapter type is VMXNET 3 and you want to use static IP instead of the default DHCP for the VM, you can edit the following network configuration file with the added/modified contents bolded in the example below. Network configuration file: /etc/sysconfig/network-scripts/ifcfg-ens160 Example: Original Contents: TYPE=Ethernet BOOTPROTO=dhcp DEFROUTE=yes IPV4_FAILURE_FATAL=no IPV6INIT=yes IPV6_AUTOCONF=yes IPV6_DEFROUTE=yes IPV6_FAILURE_FATAL=no NAME=ens160 UUID=c2500d3c-002e-4176-a893-f9bb05d9e3ff DEVICE=ens160 ONBOOT=yes PEERDNS=yes PEERROUTES=yes IPV6_PEERDNS=yes IPV6_PEERROUTES=yes IPV6_PRIVACY=no Modified Contents: TYPE=Ethernet BOOTPROTO=none DEFROUTE=yes IPV4_FAILURE_FATAL=no IPV6INIT=yes IPV6_AUTOCONF=yes IPV6_DEFROUTE=yes IPV6_FAILURE_FATAL=no NAME=ens160
8 Artisan Infrastructure Installation
UUID=c2500d3c-002e-4176-a893-f9bb05d9e3ff DEVICE=ens160 ONBOOT=yes PEERDNS=yes PEERROUTES=yes IPV6_PEERDNS=yes IPV6_PEERROUTES=yes IPV6_PRIVACY=no IPADDR=
b) Make a copy of the original network file by executing the following command. cp /etc/sysconfig/network-scripts/ifcfg-ens160 /root/
c) Rename the original network file name to match the real adapter name by executing the following command. In our example, the file ifcfg-ens160 should be renamed to ifcfg-ens33. mv /etc/sysconfig/network-scripts/ifcfg-ens160 /etc/sysconfig/network-scripts/ifcfg-ens33 d) Edit the new network file (which is ifcfg-ens33 in our example) by executing the following command: vi /etc/sysconfig/network-scripts/ifcfg-ens33 e) If the environment supports DHCP, edit the bolded options and save the file after editing. TYPE=Ethernet BOOTPROTO=dhcp DEFROUTE=yes IPV4_FAILURE_FATAL=no IPV6INIT=yes IPV6_AUTOCONF=yes IPV6_DEFROUTE=yes IPV6_FAILURE_FATAL=no
Artisan Infrastructure 9 Installation Guide
#NAME=ens160 #UUID=c2500d3c-002e-4176-a893-f9bb05d9e3ff #DEVICE=ens160 NAME=ens33 DEVICE=ens33 ONBOOT=yes PEERDNS=yes PEERROUTES=yes IPV6_PEERDNS=yes IPV6_PEERROUTES=yes IPV6_PRIVACY=no
f) If the environment does not support DHCP, edit the highlighted options and save the file after editing. TYPE=Ethernet BOOTPROTO=none DEFROUTE=yes IPV4_FAILURE_FATAL=no IPV6INIT=yes IPV6_AUTOCONF=yes IPV6_DEFROUTE=yes IPV6_FAILURE_FATAL=no #NAME=ens160 #UUID=c2500d3c-002e-4176-a893-f9bb05d9e3ff #DEVICE=ens160 NAME=ens33 DEVICE=ens33 ONBOOT=yes PEERDNS=yes PEERROUTES=yes IPV6_PEERDNS=yes IPV6_PEERROUTES=yes IPV6_PRIVACY=no IPADDR=
g) Execute the following command to restart the network service and make the changes effective: systemctl restart network.service
h) Execute the following command to reboot the virtual machine: shutdown -r now 5. Connect to the Virtual Machine Web Console. a) After the virtual machine is powered on, you should see the following message with your appliance URL displayed.
10 Artisan Infrastructure Installation
6. Navigate to the appliance URL and follow the Neverfail® HybriStor™ Setup Configuration steps found in Chapter 3 to finish the installation.
Installation of Neverfail® HybriStor™ from a DVD/ISO
Prerequisites The following hardware prerequisites must be met to perform a successful installation. The following components are common to all installations:
Component Description
OS disks 2 x 50+GB Nearline SAS or SATA 7200-RPM or greater drives deployed in a RAID1 mirror. 2 x SSD with minimum 1 DWPD deployed in a RAID1 mirror. SSDs (for processing storage)
(Optional) InstaCache™ 1 x SSD with minimum 1 DWPD CPU 2 x 64-bit x86 Intel CPUs, quad-core or greater, with hyper-threading, 2.2 GHz or higher. RAM 32 GB of RAM minimum. Additional memory may be required for larger capacities or for additional performance. See RAM sizing guide for more information. NICs • 1 or 2 port 10 GbE adapter • 1 x 1 GbE adapter for out-of-band management (IPMI/iLO).
Install HybriStor™ - Manual Setup
1. Insert the DVD/ISO and start the server (boot from DVD). Once started, the Neverfail® HybriStor™ Installation Menu is displayed on the console. 2. Select Install HybriStor 2.3 - Manual Setup and press the Enter key.
Artisan Infrastructure 11 Installation Guide
The Linux Installation Summary dialog is displayed.
3. Click Installation Destination and choose the destination location for the installation. All of the drives will be selected; clear all but the first (the OS drive). Follow the instructions in Appendix A for creating the operating system partitions. 4. When the Network and Hostname dialog is displayed, in the right pane, switch Ethernet to on, and add a custom Host name.
Note: Ensure that Automatically connect to this network when it is available is checked.
12 Artisan Infrastructure Installation
5. When the Date & Time dialog is displayed, select your Region, and turn on Network Time.
6. Click Begin Installation and set the root password to proceed.
Artisan Infrastructure 13 Installation Guide
7. After some time, the server will restart.When the server is powered on, you should see the following message with your applicance URL displayed.
Note: Make sure that network ifcfg-* file has ONBOOT set to yes so that the server automatically connects to the network. Edit the ifcfg-* file if necessary and restart the server.
8. Use a web browser to navigate to the appliance URL, and follow the Setup Configuration steps found in Chapter 3 to finish the installation.
Install HybriStor™ - Automated Setup - Software RAID 1
Procedure
1. Insert the DVD/ISO and start the server (boot from the DVD). Once started, the Neverfail® HybriStor™ Installation Menu is displayed on the console.
2. Select Install HybriStor 2.3 - Automated OS Setup - Software RAID 1 and press the Enter key.
14 Artisan Infrastructure Installation
3. Wait for the Neverfail® HybriStor™ Installation process to finish.
4. After some time, the server will restart.When the server is powered on, you should see the following message with your appliance URL displayed.
Artisan Infrastructure 15 Installation Guide
5. Use a web browser to navigate to the appliance URL, and follow the Neverfail® HybriStor™ Setup Configuration steps found in Chapter 3 to finish the installation.
Install HybriStor™ - Automated OS Setup - Hardware
Procedure
1. Insert the DVD/ISO and start the server (boot from the DVD). Once started, the Neverfail® HybriStor™ Installation Menu is displayed on the console.
2. Select Install HybriStor 2.3 - Automated OS Setup - Hardware and press the Enter key.
3. Wait for the Neverfail® HybriStor™ installation process to finish.
16 Artisan Infrastructure Installation
4. After some time, the server will restart. The server URL should appear above the login prompt. Write it down.
5. Use a web browser to navigate to the appliance URL, and follow the Neverfail® HybriStor™ Setup Configuration steps found in Chapter 3 to finish the installation.
Artisan Infrastructure 17 Chapter 3
Setup Configuration
Topics:
• Installation Using Object Storage data protection • Installation with Local Storage Using Software RAID Data Protection • Installation with Local Storage Using Hardware RAID Data Protection • Installation Using Other/None Data Protection
Installation Using Object Storage data protection
Prerequisites
Component Recommended
Common Hardware OS disks, SSDs, CPU, RAM, network controllers. Chassis Standard 1U-2U chassis are generally used. Index Storage 2 x 1TB+ Nearline SAS for software RAID. Or SATA 7200-RPM or greater drives deployed in a hardware RAID 1 mirror. Host Bus Adapters LSI SAS 9207-4i or -8i HBA in initiator target mode (IT Mode).
Note: The Host Bus Adapter (HBA) requirements above have been carefully selected and tested to support TRIM on SSDs. The use of RAID adapters is not recommended due to the lack of support for passing through TRIM commands to SSDs even when configured in "Just a bunch of disks" (or JBOD) mode.
In this configuration, deduplicated data is stored in a local Swift object storage cluster. In a production environment, it is recommended that Swift cluster nodes use 10GbE network adaptors. The cluster should contain a minimum of five storage nodes managing at least 100 nearline SAS or SATA 7200-RPM hard drives. Account and container storage is required to be on SSD drives due to the high IOPS incurred.
Procedure To connect to the HybriStor™ Appliance Web Console and configure the storage: 1. Use Google Chrome or Mozilla Firefox to connect to the HybriStor™ Appliance. 2. Review the End-User License Agreement and click Accept to continue.
Artisan Infrastructure 18 Setup Configuration
3. Enter the License Key, and click Next.
4. Choose Data Protection Mode, and click Next.
Artisan Infrastructure 19 Installation Guide
5. Select Object Storage as Data Protection Mode, and click Next.
Note: It is recommended to use Software RAID Metadata Protection.
6. Select Metadata Protection Mode, and click Next. 7. For Software RAID Metadata Protection: a) Select Software RAID Metadata Protection, and click Next.
b) Enter the authorization for the object storage system that is being used, and click Next. • Name is the name that HybriStor™ displays on the console as the data storage device. • Capacity is the maximum that HybriStor™ will use.
c) Enter an amount on one or more pairs for Index Storage, and click Next.
20 Artisan Infrastructure Setup Configuration
d) Enter an amount on two drives for Processing, and optionally two drives for InstaCache Storage, and click Next.
8. For Hardware RAID Metadata Protection: a) Select Hardware RAID Metadata Protection, and click Next.
b) Enter the authorization for the object storage system that is being used, and click Next. • Name is the name that HybriStor™ displays on the console as the data storage device. • Capacity is the maximum that HybriStor™ will use.
Artisan Infrastructure 21 Installation Guide
c) Enter an amount on one drive for Index Storage, and click Next.
d) Enter an amount on one drive for Processing and optionally one drive for InstaCache Storage, and click Next.
9. Create the initial admin account for this system, and click Next.
22 Artisan Infrastructure Setup Configuration
10. Click Finish and wait for HybriStor™ to complete configuration.
Installation with Local Storage Using Software RAID Data Protection
Prerequisites
Component Recommended
Common Hardware OS disks, SSDs, CPU, RAM, network controllers. Chassis Standard 2U-4U chassis are generally used. Index Storage 2 x 1TB or more Nearline SAS or SATA 7200-RPM or greater drives deployed in a software RAID1 mirror. Data Storage 6 or more Nearline SAS or SATA 7200-RPM or greater drives deployed in a software RAID5 configuration. Controller Cards LSI SAS 9211-4i or -8i HBA in initiator target mode (IT Mode).
Note: The HBA requirements above have been carefully selected and tested to support TRIM on SSDs. The use of RAID Adapters is not recommended due to the lack of support for passing through TRIM commands to SSDs even when configured in JBOD mode.
Important: Before Installation - Review notes for physical servers or virtual environments and using Neverfail® HybriStor™ SKUs for disk storage requirements.
Procedure To connect to the HybriStor™ Appliance Web Console and configure the storage: 1. Use Google Chrome or Mozilla Firefox to connect to the HybriStor™ Appliance.
Artisan Infrastructure 23 Installation Guide
2. Review the End-User License Agreement and click Accept to continue.
3. Enter the License Key, and click Next.
4. Choose Data Protection Mode, and click Next.
24 Artisan Infrastructure Setup Configuration
5. Select Software RAID as Data Protection Mode, and click Next.
6. Select Data Storage RAID Type, and click Next.
a) For RAID 1, select 2 Data Storage drives.
b) For RAID 5, select 3 or more Data Storage drives.
Artisan Infrastructure 25 Installation Guide
c) For RAID 6, select 4 or more Data Storage drives.
7. Enter an amount on one or more pairs for Index Storage, and click Next.
8. Enter an amount on two drives for Processing, and optionally two drives for InstaCache Storage, and click Next.
26 Artisan Infrastructure Setup Configuration
Note: It is recommended to use 2 SSD drive(s) for Processing/InstaCache storage.
9. Create the initial admin account for this system, and click Next.
10. Click Finish and wait for HybriStor™ to complete configuration.
Installation with Local Storage Using Hardware RAID Data Protection
Prerequisites
Component Recommended
Common Hardware OS disks, SSDs, CPU, RAM, network controllers. Chassis Standard 2U-4U chassis are generally used. Index Storage 2 x 2TB or more Nearline SAS or SATA 7200-RPM or greater drives deployed in a software RAID 1 mirror. Data Storage 6 or more 2TB+ Nearline SAS or SATA 7200-RPM or greater drives deployed in a hardware RAID5/6 configuration using 4K (or the smallest) stripe size.
Artisan Infrastructure 27 Installation Guide
Component Recommended
Controller Cards 1 x Hardware RAID controller with battery backup.
Procedure To connect to the HybriStor™ Appliance Web Console and configure the storage: 1. Use Google Chrome or Mozilla Firefox to connect to the HybriStor™ Appliance. 2. Review the End-User License Agreement and click Accept to continue.
3. Enter the License Key, and click Next.
4. Choose Data Protection Mode, and click Next.
28 Artisan Infrastructure Setup Configuration
5. Select Hardware RAID as Data Protection Mode, and click Next.
Note: It is recommended to use Software RAID Metadata Protection.
6. Select Metadata Protection Mode, and click Next. 7. For Software RAID Metadata Protection: a) Select Software RAID Metadata Protection, and click Next.
b) Select one or more drives for Data Storage, and click Next.
Artisan Infrastructure 29 Installation Guide
c) Enter an amount on one or more pairs of drives for Index Storage, and click Next.
d) Enter an amount on two drives for Processing and optionally on two drives for InstaCache Storage, click Next.
Note: It is recommended to use 2 SSD drive(s) for Processing/InstaCache storage.
8. For Hardware RAID Metadata Protection: a) Select Hardware RAID Metadata Protection, and click Next.
30 Artisan Infrastructure Setup Configuration
b) Select one or more drives for Data Storage, and click Next.
c) Enter an amount on one drive for Index Storage, and click Next.
d) Enter an amount on one drive for Processing and optionally one drive for InstaCache Storage, and click Next.
9. Create the initial admin account for this system, and click Next.
10. Click Finish and wait for HybriStor™ to complete configuration.
Artisan Infrastructure 31 Installation Guide
Installation Using Other/None Data Protection
Prerequisites
Component Recommended
Common Hardware OS disks, SSDs, CPU, RAM, network controllers. Chassis Standard 2U-4U chassis are generally used. Index Storage 2 x 2TB or more Nearline SAS or SATA 7200-RPM or greater drives deployed in a software RAID 1 mirror. Data Storage 6 or more 2TB+ Nearline SAS or SATA 7200-RPM or greater drives deployed in a hardware RAID5/6 configuration using 4K (or the smallest) stripe size. Controller Cards 1 x Hardware RAID controller with battery backup.
Procedure To connect to the HybriStor™ Appliance Web Console and configure the storage: 1. Use Google Chrome or Mozilla Firefox to connect to the HybriStor™ Appliance. 2. Review the End-User License Agreement and click Accept to continue.
32 Artisan Infrastructure Setup Configuration
3. Enter the License Key, and click Next.
4. Choose Data Protection Mode, and click Next.
5. Select Other/None as Data Protection Mode, and click Next.
Artisan Infrastructure 33 Installation Guide
6. Select one drive for Data Storage, and click Next.
7. Enter an amount on one drive for Index Storage, and click Next.
8. Enter an amount on one drive for Processing and optionally on one drive for InstaCache Storage, and click Next.
Note: It is recommended to use 1 SSD drive for Processing/InstaCache storage.
9. Create the initial admin account for this system, and click Next.
34 Artisan Infrastructure Setup Configuration
10. Click Finish and wait for HybriStor™ to complete configuration.
Artisan Infrastructure 35 Appendix A
Operating System Configuration
Recommended Partition Sizes
Manual partitioning should be selected and the following Linux partitions (and respective mount points) should be created:
Note: A minimum 50 GB drive is needed to accommodate the operating system partitions.
Partition Recommended Minimum
BIOS boot 2 x 1 MB 1 MB /boot 500 MB 500 MB / 20 GB 15 GB /var 100% of remaining space(at least 28 GB) 28 GB
Configuring the Operating System with Hardware RAID
Procedure
Caution: Not including previously configured bootable disks in the devices used for the operating system may result in older bootable partitions taking precedence over the current install, thereby preventing successful booting. In this case, consider deleting all partitions on older boot drives.
1. Select one device (Neverfail® HybriStor™ recommended minimum is 50 GB) and under partitioning, select I will configure partitioning, and then click Done.
Artisan Infrastructure 36 Operating System Configuration
2. Select Standard Partition on the drop-down menu (you may need to delete old partitions). If there is an Unknown category, expand it and delete each existing partition one-by-one.
3. Add a /boot partition. a) Click the Plus Sign to add /boot partition. b) Select the correct mount point from drop down list, enter the desired capacity of 500 MiB. c) Select the created partition and change Device Type to RAID Level (RAID1) and File System to ext4 from the right pane. d) Click Update Settings. 4. Add a / (root) partition. a) Click the Plus Sign to add / (root) partition. b) Select the correct mount point from drop down list, enter the desired capacity of 20 GiB. c) Select the created partition and change Device Type to RAID Level (RAID1) and File System to ext4 from the right pane. d) Click Update Settings.
Artisan Infrastructure 37 Installation Guide
5. Add a biosboot partition. a) Click the Plus Sign to add a biosboot partition. b) Select the correct mount point from drop down list and then enter the desired capacity of 1 MiB.
c) Select the created partition and click Modify on the right pane. Select only the first disk and then click Update Settings on the right pane.
6. Add a /var partition. a) Click the Plus Sign to add /var partition. b) Select the correct mount point from the drop down list, and enter the desired capacity of 100%. c) Select the created partition and change Device Type to RAID Level (RAID1) and File System to ext4 from the right pane. d) Click Update Settings. 7. Now the drive should have four partitions similar to the image below:
38 Artisan Infrastructure Operating System Configuration
8. When all of the partitions have been created, click Done twice.
Configuring the Operating System with Software RAID (use for object storage also)
Procedure
Note: Not including previously configured bootable disks in the devices used for the operating system may result in older bootable partitions taking precedence over the current install, thereby preventing successful booting. In this case, consider deleting all partitions on older boot drives.
1. Select two devices of the same size (Neverfail® HybriStor™ recommended minimum is 50 GB) and under partitioning, select I will configure partitioning. Click Done.
Artisan Infrastructure 39 Installation Guide
2. Select Standard Partition on the drop-down menu (you may need to delete old partitions). If there is an Unknown category, expand it and delete each existing partition one-by-one.
3. Add a /boot partition. a) Click the Plus Sign to add a /boot partition. b) Select the correct mount point from the drop down list, and enter the desired capacity of 500 MiB. c) Select the created partition and change the Device Type to RAID Level (RAID1) and File System to ext4 from the right pane. d) Click Update Settings. 4. Add a / (root) partition. a) Click the Plus Sign to add a / (root) partition. b) Select the correct mount point from the drop down list, and enter the desired capacity of 20 GiB. c) Select the created partition and change the Device Type to RAID Level (RAID1) and File System to ext4 from the right pane.
40 Artisan Infrastructure Operating System Configuration
d) Click Update Settings. 5. Add a biosboot partition. a) Click the Plus Sign to add a biosboot partition. b) Select the correct mount point from the drop down list and then enter the desired capacity of 1 MiB.
c) Select the created partition and click Modify on the right pane. Select only the first disk, and then click Update Settings on the right pane.
6. Add a new biosboot partition. a) Click the Plus Sign to add a new biosboot partition. b) Select the correct mount point from the drop down list and then enter the desired capacity of 1 MiB.
Artisan Infrastructure 41 Installation Guide
c) Select the created partition and click Modify on the right pane. Select only the second disk, and then click Update Settings on the right pane.
7. Add a /var partition. a) Click the Plus Sign to add a /var partition. b) Select the correct mount point from the drop down list, and enter the desired capacity of 100%. c) Select the created partition and change the Device Type to RAID Level (RAID1) and File System to ext4 from the right pane. d) Click Update Settings.
42 Artisan Infrastructure Operating System Configuration
Note: Only one BIOS Boot partition shows up on the left panel. Verify the summary to make sure changes take effect.
8. When all partitions have been created, click Done twice. 9. On the Summary of Changes Window, verify BIOS Boot disks, and then click Accept Changes.
Artisan Infrastructure 43 Installation Guide
44 Artisan Infrastructure Appendix B
Installation Tips and Best Practices
Installation on a Physical Server
Method 1: Installing from a DVD Burn a CD/DVD from an ISO file. 1. Place the DVD in the server DVD tray. 2. Activate the boot menu and boot from the DVD. 3. Follow this installation guide to finish installing the product.
Method 2: Install from Remote Access Console (Dell iDRAC, HP iLO, IBM IMM, etc) Please refer to your server document on how to mount and boot from an ISO image via a Virtual CD/DVD. Follow this installation guide to finish installing the product.
Method 3: Install from USB Flash Drive 1. Create a bootable USB Flash drive from the ISO image. a. Plug the USB flash drive into the server. Perform a quick format.
Caution: This will erase all your data on the USB drive.
Make sure the file system is FAT32 and the Volume label is HYBRISTOR.
Artisan Infrastructure 45 Installation Guide
b. Download ISO2USB for CentOS/RedHat from this URL: http://iso2usb.sourceforge.net/ c. Extract it. Right click on ISO2USB.exe and select Run as administrator. d. Select Diskimage: ISO and select the ISO image. e. For the Hard Disk Name, use sda. f. For USB Device Name, name it sdz. g. On the USB Drive, select the USB flash drive letter that you just formatted. In this example, the USB flash drive is on D: h. Click on OK to create the bootable USB image. i. Once complete, remove the USB flash drive from your PC.
2. Plug the USB flash drive into your server and power on the server. 3. From the BIOS, enter the boot menu. 4. Select to boot from the USB flash drive. 5. Follow the installation guide to finish installing the product
46 Artisan Infrastructure Installation Tips and Best Practices
Note: Alternatively, use Rufus to create a bootable USB image from the ISO image. Ensure that the Volume label is HYBRISTOR.
Installation on a Virtual Machine
Installing on VMware ESXi 5.5 or 6.0 Using an ISO Image
Note: Artisan Infrastructure recommends using the .ova installation method described in Chapter 2.
1. From vSphere client or vCenter Web Client, right-click on the ESXi server and select New Virtual Machine. 2. Select Typical and then click Next. 3. Label your Virtual Machine and then click Next. 4. Select a Datastore for storage and then click Next. 5. For the operating system, select Oracle Linux (64-bit). 6. Select the NIC to connect, and then click Next. 7. Please refer to the Installation Guide for recommended disk sizes. 8. Ensure the selected memory meets the recommended memory size for the VM. 9. Right click on the VM and select Edit Settings > Options tab > Boot Options and select the Force BIOS Setup check box. 10. Power on the VM and then click on the CD/DVD Drive icon and select Connect to ISO image on the local disk (if you have the ISO file on the local machine). 11. At the VM console, you will see the PhoenixBIOS Setup Utility. Go to the Boot tab and make CD-ROM Drive the first boot (highlight it and use + sign to move it up). 12. Navigate to the Exit menu and select Exit Saving changes.
Artisan Infrastructure 47 Installation Guide
13. Once the server has rebooted, the Neverfail® HybriStor™ Installation is displayed on the console. Select Install HybriStor 2.3 and press the Enter key.
14. Follow the Installation with Local Storage using Hardware RAID section in this guide to complete the setup.
Oracle Virtual Box 4.3.xx 1. On the Oracle VM VirtualBox Manager, click the New icon. 2. On the pop-up dialog, provide a Name. Type: Linux, Version: Oracle (64 bit). Click Next. 3. Memory size: Minimum requirement is 26624 MB. Click Next. 4. Select Create a virtual hard drive now and click Create. 5. Select VDI (VirtualBox Disk Image) and click Next. 6. Depending on your purpose, select either Dynamically Allocated or Fixed size. Click Next. 7. On File location and size dialog, type the name of the new virtual hard drive if you choose to select a different folder to create the file in. 8. Right-click the VM you just created and select Settings. 9. Click on Network and enable the Network Adapters you plan to use. Change Attached to Bridged Adapter. Click OK when done. 10. Click on Storage and then click on the controller on which the first disk is attached. Click on Add Hard Disk. Depending on the type of storage being used (Object Storage, software or hardware RAID) create an appropriate number of disks and size as required. 11. Click on the empty CD/DVD drive. On the right, select the HybriStor™ ISO image and click on Open. Click Ok on the Settings to exit. 12. Click on the Start button to power on the VM and follow the Installation with Local Storage using Hardware RAID section in this guide to finish the setup.
48 Artisan Infrastructure Appendix C
Troubleshooting
Licensing Mismatch
Symptoms The User Interface displays a Daemon status of Postdedupe Daemon offline. The Event Log displays the following entry: [ERROR] ../src/license-core.cpp:104 License Validation Failure: system mismatch.
Cause Product licensing validation includes checking hardware. After adding or changing hardware such as an Ethernet adapter on an appliance, the licensing validation will detect a system mismatch.
Resolution On the left navigation pane of the User Interface, navigate to Configurations > License. On the right pane, click the Refresh button to re-validate the appliance licensing.
Cannot Mount NFS Share from an Older Linux Kernel Client
Symptoms Getting mount.nfs: an incorrect mount option was specified when attempting to mount a HybriStor™ NFS share. [root@jestafed ~]# mount -t nfs -o sync 172.17.1.60:/srv/share/nfs1 /mnt
Cause Kernel requires additional specification for security options when attempting to mount from an older kernel.
Artisan Infrastructure 49 Installation Guide
Resolution Add an extra option sec=sys when mounting a HybriStor™ NFS share. [root@jestafed ~]# mount -t nfs -o sec=sys,sync 172.17.1.60:/srv/share/nfs1 /mnt
50 Artisan Infrastructure