Professional Documents
Culture Documents
5 Installation Guide
(Updated for Version 1.5.4)
1. 2.
Introduction Getting Started ... 2.1 Downloading the VxDatacenter Installation Package. 2.2 Configuring your Physical Infrastructure ....................... i. Model 1 .......... ii. Model 2 ...... 2.3 Advanced Features: Managed VLAN and Passthrough
2 2 2 3 4 4 5 7 8 8 10 10 11 12 13 13 14 16
3. 4.
5. 6. 7. 8. 9.
VxRouter Installtion Procedure . Configuring VxRouter ...... VxStorage Installation Procedure . Configuring VxStorage ...... Configuring for Optional Storage Network (Model 2 only) ...
10. Compute Node Configuration Steaps ... 11. VxDatacenter Portal Access & Partner Registration .. 12. Setting Up Your Cloud Infrastructure .
1|Page
1. Introduction
Welcome to the VxDatacenter 1.5 Installation Guide. Before continuing with the installation process, please verify that your hardware meets the minimum requirements set forth in the VxDatacenter Hardware Requirements documentation. If the hardware meets the minimum requirements, and it has been configured correctly, you can begin installing the different software components of VxDatacenter. The VxDatacenter software package involves installing the management node software (VxDatacenter), the router software (VxRouter), and an optional storage server software (VxStorage). After sucessful installation, users can access the VxDatacenter portal for the first time, create their primary administrator account, and begin to configure cloud infrastructure from within the portal.
2|Page
3|Page
Model 1
Model 2
4|Page
Starting with version 1.5.4, VxDatacenter has built-in support for Managed Virtual LAN (MVLAN) networks and also allows straight Passthrough communication. The diagrams above show how to setup these networks if desired. Implementing a Managed VLAN or Passthrough network will require one additional switch per network. Managed VLAN allows Virtual Servers in the Cloud to be part of an existing physical VLAN thus allowing secure communication between them using the IEEE 801.2Q standard. Thus MVLANs allow users to connect VxDatacenter with servers on the users existing network without going through the public internet. Inorder to utilize the Managed VLAN feature, the infrastructure owner must connect all the Compute Nodes to an additional switch where physical VLANs can be defined. Without VLAN identification, the Managed VLAN feature will not work. In addition, all ports (on the switch) to which Compute Nodes are connected need to be configured to be in trunk mode. Passthrough network allows for direct communication between Virutal Servers on the Compute Nodes, and physical servers located outside the cloud. However in this model, there is no VLAN tagging. No additional configuration on the switch is required. Due to the wide variety of switches available on the market today, Hexagrid cannot provide instructions on configuring individual switch for Managed VLAN. A sample set of basic instructions has been provided for the Cisco Catalyst 2950 series switch, to serve as a guideline for setting up a general switch for a Managed VLAN network. Please contact Hexagrid support if more guidance is needed.
5|Page
6|Page
5. The installation process will now begin. VxDatacenter will attempt to detect the systems hardware, and then try to identify and configure the internal network. NOTE: If VxDatacenter cannot identify a network (for example if the management node is not connected to a public gateway) it will display the following message: Network auto configuration failed. Ignore this message and continue to the next screen. Then for Network Configuration Method select Do not configure network at this time and press <ENTER>. NOTE: If the system has more than one hard disk, VxDatacenter will ask the user to select a hard drive to be used for installing VxDatacenter. 6. The Installation procedure will take some time to complete. Once installation is complete the system will reboot and automatically eject the DVD. NOTE: Failure to eject the DVD will restart the installation setup process. If this is the case select Load from hard drive and eject the DVD afterwards. 7|Page
4. VxDatacenter will automatically fill the form with default values. Update the form and click submit. Where default entries are correct, skip to the following entry.
Fields
Private IP Public IP Public Network Private Network Public Gateway
Description of Entries
Enter IP address for LAN (eth0) interface of the management node. Do not change the default value unless the IP addresses are reserved. (Default: 10.10.20.254). Enter IP address for WAN (eth1) interface of the management node. (Default 192.168.20.228) Enter the IP address of the WAN network of the management node. (Default 192.168.20.0). Displays the IP address of the private network of the management server. Do not change the default value. (Default 10.10.20.0). Displays the IP address of the Gateway Server. This IP address allows the management node to reach the public network. (Default 192.168.20.1). 8|Page
Fields
Router IP PXE Server IP DHCP Begin DHCP End Name Server: Domain Install site Mail Relay Session Timeout Site Name Site FQDN HTTPS Site Name Admin Email
Description of Entries
Displays the VxRouter IP address. This is also the gateway of the private network of the management server. Do not change the default values. (Default 10.10.20.1). Displays the management server private IP address as PXE Server. Do not change default values. (Default 10.10.20.254). Displays the DHCP beginning IP address. Do not change default value. (Default 10.10.20.2). Displays the DHCP ending IP address. Do not change default value. (Default 10.10.20.245). Enter the IP address of the Primary DNS server. Enter 8.8.8.8 Enter the name of your organizations domain name (ex: demo.com). Specify an organization type. Choose Datacenter (for service providers) or delete text (by pressing <DELETE>) and type Enterprise. (Default Datacenter). To receive information from the cloud, specifies your organizations SMTP relay server (ex: smtp.demo.com). Specify the session time of each users session (Default 30). Specify the name of the organizations website (ex: cloud). Please provide a Fully Qualified Domain Name (FQDN) that is resolved by the domain server (ex: cloud.demo.com). Type the SSL along with the website name (ex: cloud-ssl). Specify email address of cloud owner / administrator (ex: admin@demo.com).
After completing the form, press the <TAB> button, and then press <ENTER> to submit the form. If any information is left blank, VxDatacenter will prompt with a warning message and ask the user to complete the form. Otherwise, the message Successfully done..please select Yes (recommended) to finish, or No to abort will appear. Select YES and press <ENTER> to finish. This completes the VxDatacenter management node configuration process. The system will reboot once configuration is complete.
9|Page
2. Now reboot VxRouter. (Execute command reboot and confirm the reboot warning) 10 | P a g e
Admin
11 | P a g e
3. Now select the Vx64 Storage Package needed to proceed with installation. Select (default: all packages) <ENTER> Select Yes for the directory creation. <ENTER> Select Yes to continue with installation. <ENTER> Once complete, system will notify user that Installation of <vxstorage> was successful. 4. Execute the following command cd /root/vxstorage <ENTER>
5. Type ./install and press <ENTER>. Follow the procedure and provide the password for admin. The system will require the creation of a password for the system user vxadmin. 6. Next type < I > for Enter an existing ZFS filesystem to be shared, I to Ignore: <ENTER>
7. The system will display all available hard disks and ask to create ZFS pools with the hard disks. 1raidz1 pools will be created with all available disks. To continue Press Y, Q to Quit. Type < Y > and press <ENTER>. 8. Another notification will appear, listing all of the ZFS pools the system is about to create. Type < Y > and press <ENTER>. Once completed, the message Successfully created ZFS pool will be displayed. 9. Next the system will prompt the user to restrict ZFS sharing to a specific network. If one switch is being used for both LAN and SAN (Model 1) type < D > for default and press <ENTER>. If separate LAN and SAN switches (Model 2) are being used, type 10.10.21.0 and press <ENTER>. 10. ZFS file system has now successfully been created. 11. Finally execute command: showmount e. The system will display the mount point. It will be the text preceeding the IP address. (Ex: /vxraidz1-vxstorage/prod). Identify all of the different mount points and record the information below. REMOTE MOUNT POINT: __________________________________ 12. Finally execute the command: ifconfig a Record the IP address of the Network Interface Card(s). STORAGE IP ADDRESS: ___________________________________ 12 | P a g e
Installation Steps
1. Turn on Compute Node. 2. Simply go into your systems BIOS and enable Boot from LAN or PXE boot. If there is a Boot Seqence or Boot Device Prioty option, then ensure that your NIC card is set as the first boot device. 3. Save changes and reboot compute node. 4. Compute node will automatically be assigned a Network IP address, and configure itself so that it is ready to be registered in the VxDatacenter Portal. NOTE: A minimum of 3 compute nodes are required for VxDatacenter to work properly. Without 3 compute nodes, users will not be allowed to provision Virtual Servers. 13 | P a g e
4. Once completed, click submit and a message will appear that Registraion has been successfully completed. Check the email address provided above to see a welcome message. 5. Next log in to portal with the primary administrator username (typically the email address provided above) and chosen password to begin setting up your cloud infrastructure.
15 | P a g e
1. Login to VxDatacenter with your Partner Administrator account 2. Register Storage Server
a. Select the Infrastructure tab from the top navigation menu. b. Select the Storage in the left navigation pane. c. Click on Add Storage Server and fill in all required fields. i. For Protocol select NFS. ii. The IP address was assigned during the VxStorage configuration. iii. The Remote Mount Point was also assigned during VxStorage configuration. d. Repeat steps for any additional storage servers.
16 | P a g e
The optional WAN adapter allows for communciation between Virtual Servers and servers outside of the cloud environment including servers on the internet and other public networks. The MVLAN and Passthrough adapters are optional advanced features that allow communication between Virtual Servers and servers outside of the cloud. Utilizing these adapters requires additional physical hardware, including an additional switching network. Refer to Section 2.3 for detail setup instructions. Network Pools specify the IP address range (or in case of MVLAN, a VLAN ID) that is used on each specific adapter. Without Network Pools, Cloud Network Adapters will not contain the information necessary for Virtual Servers communication. After LAN, WAN, and MVLAN adapters are created, each of them must be assigned Network Pools before the adapters can be used. SAN and Passthrough pools are system generated and are not viewable to users. NOTE: To setup your Virtual Network Infrastructure the following steps must be taken: Add Cloud Network Adapters 1. Add LAN Adapter (required). The LAN Adapter is a required component of VxDatacenter. 2. Add SAN Adapter (conditionally required). The SAN Adapter is a required component only if you have setup a Storage Area Network as described in Model 2. 3. Add WAN Adapter (optinal but recommended). The WAN Adapter is required if you would like to allow Virtual Servers access to and from outside the cloud. 4. If the features are required, Add MVLAN and Passthrough Adapter. Assign Network Pools to LAN, WAN, and MVLAN adapters 1. For LAN Pools specify the Private Network, and IP Range. 2. For WAN Pools specify the Public IP Block to be used. 3. For MVLAN Pools specify a unique VLAN ID to be used.
a. Select Infrastructure tab from the navigation menu. b. Select Network in the left navigation page. The Network Adapter and Network Pool sublinks are displayed. 17 | P a g e
c. Next select Network Adapter sublink. d. Click on +Add button and fill in all required form fields i. For Network Adapter Name enter the desired name of the adapter. ii. For Network Type choose the type of Adapter you wish to add. The following choices are available: LAN, WAN, SAN, MVLAN, and Passthrough. iii. For Network Connection Type choose Bridge if the network is connected using bridge connections. iv. For Bond Name enter a name that corresponds to the network adapter. v. For Usage Description enter any additional information for the network adapter. vi. For Default for All Customers choose Yes if you like to make the respective network adapter available for all customers. For LAN and SAN adapters this option is always Yes. vii. Click on the Add button. The system may take some time to complete the registration process e. Repeat the steps for any additional network adapters NOTE: Only one LAN, WAN, and SAN adapters can be created per cloud.
a. b. c. d. e.
Select Infrastructure tab from the top navigation menu. Select Network in the left navigation pane. Select Network Pool sub link to configure a network pool. Select +Add and fill in all form fields . To define an IP pool for a WAN Adapter, do the following: i. For Network Pool Name enter the name of the public IP pool ii. For Network Adapter choose an existing WAN adapter defined in Step 4d. iii. For Network Address enter the first IP address from the WAN IP Block you wrote down on the first page. iv. For Subnet, please select a value that represents the total number of WAN IP address in the block. v. For Gateway enter the WAN (public) IP address of VxRouter. vi. For DNS Server enter the IP address of the DNS server. (For example, 8.8.8.8) f. To define an IP pool for a LAN Adapter, do the following: i. For Network Pool Name enter the name of the private IP pool ii. For Network Adapter choose an existing LAN adapter defined in Step 4d. iii. For Network Address choose whatever IP address you would like to use on your private LAN network. (ex: 172.16.0.X) 18 | P a g e
iv. For Subnet, please select a value that represents the total number of LAN IP address in the block. v. For Gateway enter the LAN IP address of VxRouter. g. To define the VLAN ID for a MVLAN adapter, do the following: i. For Network Pool Name enter the name of the pool for a MVLAN adapter. ii. For Network Adapter choose an existing MVLAN adapter defined in Step 4d. iii. For VLAN ID enter the VLAN identification number of the MVLAN. iv. For VLAN Description enter any other information to descrive the VLAN ID. v. Repeat the steps to define more network pools for the MVLAN adapter(s).
a. Power on compute nodes. It may take some time before they are recognized by portal. b. Click on the Infrastructure tab from the top navigation menu c. Select the Unregistered Servers link in the left navigation window d. Select the server you want to add (by clicking on the MAC address) e. Name your compute node and select the rack in which you like to place the compute node f. Map Network Adapters to the Compute Nodes i. For each NIC of the compute node, assign the appropriate network adapter that accurately reflects your physical setup. g. Click on the Add button to register Compute Node NOTE: The LAN Adapter will be associated to each Compute Node by default. Ensure that your LAN cable is plugged into the corresponding NIC. For each Compute Nodes, physical NICs must be greater than or equal to Cloud Network Adapters. Otherwise Compute Node registration will fail. Each Compute Node must be registered with all existing Cloud Network Adapters. Otherwise registration will fail.
7. Congratulations, the Cloud Infrastructure is now setup. Please review the Partner User Guide to start provisioning Virtual Servers and to learn more about the features of the VxDatacenter portal.
19 | P a g e