Plexxi HCN Control Software Installation, Upgrade and Administration Guide Release through 3.3.0

Size: px

Start display at page:

Download "Plexxi HCN Control Software Installation, Upgrade and Administration Guide Release through 3.3.0"

Matthew Harrison
5 years ago
Views:

1 Plexxi HCN Control Software Installation, Upgrade and Administration Guide Release through December 8, Innovative Way - Suite 3322 Nashua, NH Tel PLEX (7539)

2 Legal Notices The information contained herein is subject to change without notice. Plexxi, the Plexxi logo, and LightRail are registered trademarks, and Plexxi HCN, Plexxi Control and Plexxi Connect are trademarks of Plexxi, Inc. in the United States and other countries. Other product or service name may be trademarks or service marks of others. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) without written permission from Plexxi, Inc. Plexxi, Inc. reserves all rights of copyright in this documentation. PLEXXI, INC. PROVIDES THIS DOCUMENTATION AS IS, WITHOUT WARRANTY, TERM, OR CONDITION OF ANY KIND, EITHER IMPLIED OR EXPRESSED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES, TERMS, OR CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT AND FITNESS FOR A PARTICULAR PURPOSE. Plexxi, Inc. reserves the right to make changes to equipment design or program components described in this documentation, as progress in engineering, manufacturing methods, or other circumstances may warrant. No responsibility is assumed for the use of Plexxi, Inc. software or hardware, all rights, obligations and remedies related to which are as set forth in the applicable sales and license agreements. Plexxi, Inc. 100 Innovative Way - Suite 3322 Nashua, NH Tel: PLEX (7539) Published December 8, 2017 Printed in United States of America. Copyright 2017 Plexxi, Inc. All rights reserved. The Plexxi Switch system is classified as a class 1 telecommunications laser product employing embedded class 1 lasers and complies with the following: THIS PRODUCT COMPLIES WITH FDA RULE 21 CFR SUBCHAPTER J IN EFFECT AT DATE OF MANUFACTURE. PRODUCT COMPLIES WITH 21 CFR AND PRODUIT CONFORME SELON LE SOUS CHAPITRE J DU DOCUMENT FDA RÈGLE 21 CFR EN VIGUEUR LORS DE LA DATE DE FABRICATION. PRODUIT CONFORME SELON 21CFR ET Electrotechnical Commission (IEC) , This product is classified as a: CLASS 1 LASER PRODUCT APPAREIL À LASER DE CLASSE 1 This unit is intended to be installed in a Restricted Access Location only with access only by trained personnel. Warning: The primary hazards of exposure to invisible laser radiation from an optical fiber communications system are: ï Damage to the eye by viewing an unterminated optical fiber or fiber optic connector. ï Damage to the eye from invisible laser radiation from viewing a cut fiber or a broken fiber. Never attempt to view optical connectors that may be emitting laser energy and always avoid possible exposure to invisible optical laser radiation. Using optical fiber scopes or magnifying lenses may increase the possibility for an eye hazard. It is recommended that you use an optical power meter to determine if there is optical laser radiation present or use a remote video display inspection tool to inspect connectors. 2 Plexxi Control Installation, Upgrade and Administration Guide, 3.2.2

3 Table of Contents Legal Notices... 2 Introduction... 4 Related Documentation... 4 Contacting Plexxi Support Installation Considerations... 5 VM Requirements... 5 Supported VM Hypervisors... 5 Operating System... 5 Host Environment - Network Settings... 5 Security Considerations... 6 Secure Passwords OVA Deployment vs ISO Installation... 7 OVA Deployment of a Plexxi Control VM... 7 ISO Installation/Upgrade Deploying a Plexxi Control VM using OVA... 8 Downloading the OVA File... 8 Deploying the Plexxi Control VM Installing Linux and Plexxi Control - ISO Downloading the ISO Installer File Installation Changing the Linux Root User Password Selecting an Action Selecting the Time Zone Completing the Installation Testing Remote Access to the Linux Host Optional Configurations Configuring Network Settings for a Device Configuring DNS Troubleshooting Menu Upgrading Plexxi Control Online vs Offline Upgrade Upgrading Plexxi Control Online Upgrading Plexxi Control Offline Administering Plexxi Control Changing Default Linux Passwords on a New VM Changing the Plexxi Control Password Changing the hostname of your Plexxi Control Server/VM Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

4 Introduction Plexxi Control is deployed using either of the following options, depending on your environment and preferences: deploy Plexxi Control as a Virtual Appliance (OVA) deploy Plexxi Control through an ISO install procedure This document describes both options. Plexxi Control runs as an application in a Linux environment. Related Documentation The following additional documentation supports this release: Plexxi Compatibility Matrix, Version 9 or greater. The Plexxi Compatibility Matrix contains versionspecific software and hardware support information as well as cable and transceiver support information. Plexxi Release Notes for applicable release Plexxi Switch Administrator Guide using Linux and Plexxi CLI for applicable release Plexxi Control Online Help is available while logged into the Plexxi Control UI Except for the online help, this documentation is available on the Resources > Technical Publications page of Contacting Plexxi Support Plexxi Support services are available to answer questions and to make sure your software and hardware operate properly. Contact Plexxi Support at: support@plexxi.com (US/Canada toll-free) (US/International) 4 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

5 1 Installation Considerations VM Requirements To support Plexxi Control, the Plexxi Control virtual machine (VM) must meet the following minimum requirements: 4 CPU cores 8 GB RAM 200 GB disk space Supported VM Hypervisors VMware ESXi Nutanix AHV IMPORTANT: If you need to install Plexxi Control on a different hypervisor, contact Plexxi Support before attempting the installation. Operating System The installation deploys a Linux (CentOS) VM. Host Environment - Network Settings Determine the following network settings: IP Addressing Type: The host IP address can be either a Static IP (default) or DHCP: o o Static IP: This is the default option and is recommended by Plexxi. You will need to determine a static IP address, netmask, default gateway, and DNS server information. You can either enter these settings when prompted by the installer, or supply them as boot options to the installer. DHCP: The installer supports DHCP. If you use DHCP, you must take steps to ensure that the host IP address does not change. For example, on the DHCP server, you should add a DHCP reservation and/or DNS hostname entry on your DHCP/DNS server(s). Hostname: You need a hostname for your Plexxi Control VM. You can either pass a hostname to the installer as a boot option or the installer will prompt you to provide a hostname. Domain name: You will provide a valid DNS domain name for the domain in which the Plexxi Control VM resides. If the network/deployment environment does not have a domain, you can use "localdomain" as the domain name. NTP Server(s): If your network environment includes NTP servers, Plexxi recommends configuring your Plexxi Control VM to use these server(s) to ensure accurate time synchronization between Plexxi Control and Plexxi switches. When using a static IP address for Plexxi Control, you must specify the NTP server(s) to use. If you use DHCP, NTP servers will be automatically used, provided that your DHCP server is configured with NTP server (DHCP option 42). If you do not have a local NTP server, but your network can access the Internet, you can alternatively use the NTP "pool" servers, for example "pool.ntp.org". 5 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

6 Security Considerations The Plexxi Control installation disables SELinux and SSH access to the root account and prompts you to enter a new root password on the first boot. You should also take additional measures as needed to secure the installation. See the Red Hat Enterprise Linux 6 Security Guide for more information: Secure Passwords A secure Linux Administrator password to be configured after installing Plexxi Control. A secure Plexxi Connect Administrator password to be configured after installing Plexxi Control. 6 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

7 2 OVA Deployment vs ISO Installation You can install Plexxi Control using either: OVA installation/deployment using VMware vcenter, or by creating a VM and installing Plexxi Control on the VM using an ISO file. OVA Deployment of a Plexxi Control VM There are several ways to deploy virtual appliances using the OVA format, this guide covers the use of the VMware vsphere Web client. ISO Installation/Upgrade Plexxi Control ISO installations and upgrades can be performed either online with direct Internet access to the Plexxi install servers or offline with no or limited Internet access. The ISO file contains all software packages needed for installation or upgrade. 7 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

8 3 Deploying a Plexxi Control VM using OVA Plexxi Control can be installed from an OVA file designed for deployment on virtual hosts. In this section, you will use OVA from a VMware vsphere Web Client to deploy a new VMware VM to host the Plexxi Control software. Downloading the OVA File 1. Determine the version of Plexxi Control software to install. IMPORTANT: Refer to the Plexxi Compatibility Matrix for information on compatibility between Plexxi Control and Plexxi Switch software. 2. Login to and navigate to the download directory for the version of Plexxi Control software. 3. Download the OVA installer file, plexxicontrol-version-date.ova. Deploying the Plexxi Control VM Deploy the Plexxi Control VM using OVA as follows: IMPORTANT: The screens and content in this procedure represent screens you should see. Your installation will contain different servers and values, etc. 1. Save the downloaded OVA file in a location for the OVA deployment. 2. Open the VMware vsphere Web Client. 3. If you are logging into vsphere 6.0 or older, you may be prompted to install the Client Integration Plug-in in your web browser. If prompted, you must install the Client Integration Plug-in to enable OVA deployment from your web browser. 4. Select a VCenter server or a specific hypervisor. 5. Select Deploy OVF Template from the Actions menu or by right-clicking the hypervisor and selecting Deploy OVF Template. 8 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

9 6. In Select source, browse for the plexxicontrol- version-date.ova file either locally or remotely as saved above. Click Next. 7. Verify the Plexxi Control OVF template details. Click Next. 9 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

Enter a name and select a folder for the Plexxi Control VM.

10 8. Read the end user license agreement and click Accept to accept the license agreement. Click Next. 9. Enter a name and select a folder for the Plexxi Control VM. Click Next. 10 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

In Setup Networks, select the source network (vswitch or port group).

11 10. In Select storage, select the virtual disk format, VM Storage Policy (Datastore Default) and select the datastore for the VM. Click Next. 11. In Setup Networks, select the source network (vswitch or port group). Click Next. 11 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

12. In Customize template, enter a VM hostname and set up either static IP or DHCP. In A) Network General Settings, configure: The Hostname for the Plexxi Control VM host; for example, plexxi-control.

12 12. In Customize template, enter a VM hostname and set up either static IP or DHCP. In A) Network General Settings, configure: The Hostname for the Plexxi Control VM host; for example, plexxi-control. The Domain Name on the Plexxi Control VM resides. This should be a valid DNS domain name, or if the network/deployment environment does not have a domain, you can use "localdomain" as the domain name. Time Servers (NTP): IP addresses or hostnames of the primary and secondary Network Time Servers (NTP) that Plexxi Control will use to synchronize its internal clock. It is STRONGLY recommended to use NTP servers to ensure that all elements of the Plexxi system have the most accurate time & date settings. Note that when using DHCP, the NTP server information will not need to be provided. You should confirm that your DHCP server is properly configured to provide NTP server(s) when fulfilling DHCP requests. In B) Network Static IP Settings, configure: For static IP, enter the IP Address, Network Mask, and Default Gateway as needed for your environment. DNS Servers: For static IP, provide the IP address of the primary and secondary DNS servers that Plexxi Control will use to resolve hostnames. When using DHCP, DNS server information is not needed. 12 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

For DHCP, select the DHCP check box and leave the IP address as 0.

In C) Network DHCP Settings, configure: Use DHCP: Check this option if DHCP is used. 13. When finished, click Next. 14.

13 For DHCP, select the DHCP check box and leave the IP address as IMPORTANT: If you use DHCP, you must reserve an IP address on the DHCP server. In C) Network DHCP Settings, configure: Use DHCP: Check this option if DHCP is used. 13. When finished, click Next. 14. In Ready to complete, verify the entered configuration settings. Click Finish. 15. You can monitor the OVA Install progress in the Recent Tasks window: 16. When finished, in vsphere, locate and Power On the new VM. 13 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

14 17. Verify the installation. In a Web browser, enter the Plexxi Control URL. The URL format is: IMPORTANT: When connecting to Plexxi Control on port 8443, you must use the server's FQDN (Fully Qualified Domain Name). Log into Plexxi Control as administrator using the default credentials: Username: admin Password: plexxi Verify that the Plexxi Control UI opens successfully. 18. Plexxi recommends that, while logged into the Plexxi Control UI as administrator, you change the Plexxi Control password to a secure password. Refer to the section Changing the Plexxi Control Password on page Plexxi recommends that you connect to the new VM and change the default Linux passwords for the root and plexxi user accounts. Refer to the section Changing Default Linux Passwords on a New VM on page The Plexxi Control installation is complete. Disregard all other install chapters. 14 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

15 4 Installing Linux and Plexxi Control - ISO Downloading the ISO Installer File 1. Determine the version of Plexxi Control software to install. IMPORTANT: Refer to the Plexxi Compatibility Matrix for information on compatibility between Plexxi Control and Plexxi Switch software. 2. Login to and navigate to the download directory for the version of Plexxi Control software. 3. Download the ISO installer file, PlexxiControl-version-date.iso. Installation To install Plexxi Control: 1. Create a Virtual Machine (VM) on which to install and run Plexxi Control. Adhere to the previouslyspecified requirements for memory, CPU, and disk. 2. Configure the VM to boot from the Plexxi Control ISO installer file. 3. Power ON the VM. 4. Immediately launch a remote VM console. The Linux installer automatically launches and the installer main menu opens in the Console. IMPORTANT: A timer counts down and the Static IP installation will begin automatically at the timeout. To select either the DHCP installation or the Troubleshooting menu, before the countdown completes, use the down-arrow and up-arrow keys to select the option, then press Enter. The following is a sample main installer screen: Install Plexxi Control (Static IP): Static IP is the Default and recommended option. Use this option to install Plexxi Control using a statically assigned IP address. You will provide a Hostname, Domain name, IP Address, Netmask, Gateway, Name Servers (DNS), and optionally a VLAN ID and NTP server(s). Install Plexxi Control (DHCP): Use this installation option to install Plexxi Control and use DHCP to assign the Hostname, Domain name, and optionally NTP server(s). Troubleshooting: Open the Troubleshooting menu. 15 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

5. Either press Enter to immediately launch the installation using Static IP, or select DHCP installation and press Enter. Progress messages appear as the installation progresses. 6.

16 5. Either press Enter to immediately launch the installation using Static IP, or select DHCP installation and press Enter. Progress messages appear as the installation progresses. 6. Complete the following network information, then when finished, select OK and press Enter. For Static IP Complete the fields as follows: Hostname: Enter the host name for the VM. Domain name: Enter the domain name for the domain in which the host resides. Enter the domain name only, not a fully qualified domain name. If the network/deployment environment does not have a domain, you can specify something like "localdomain" as the domain name. NTP Servers: Optional: Enter NTP server names or IP addresses. IP Address: Enter a valid IP address for this Plexxi Control host. Netmask: Enter the network mask using either dot-decimal or CIDR (omit the slash) notation. Gateway: Enter a valid gateway address. VLAN ID: Enter a VLAN ID (1-4095) or 0 (default) if not using a VLAN. WARNING: The VLAN ID field should only be used when: o o software is being installed on 'bare metal' (non-hypervisor) servers. management traffic must be sent over a tagged VLAN.' If you're deployment does not meet these criteria, do not change the default value (0). Name Servers: Enter the IP addresses for DNS name servers, separated by spaces. 16 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

For DHCP Complete the fields as follows: Hostname: Enter the host name for the VM. Domain name: Enter the domain name for the domain in which the host resides.

NTP Servers: Optional: Enter NTP server names or IP addresses.

17 For DHCP Complete the fields as follows: Hostname: Enter the host name for the VM. Domain name: Enter the domain name for the domain in which the host resides. Enter the domain name only, not a fully qualified domain name. If the network/deployment environment does not have a domain, you can specify something like "localdomain" as the domain name. NTP Servers: Optional: Enter NTP server names or IP addresses. Error Notifications If you enter an invalid value in a parameter, when you click OK and Enter to continue, you will be notified with an error message in Red text. Examples include: ERROR: Gateway is not on the same network. ERROR: Nameserver sample.company.com is not a valid IP address. ERROR: Invalid hostname vm1_company.com. In this case, the hostname contains an invalid character (underscore). 7. You will be prompted to accept the Oracle End User License agreement. To accept the agreement, press Tab to select the Accept button, then press Enter. 17 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

8. The Plexxi End User License agreement opens. To accept the agreement, press Tab to select the Accept button, then press Enter.

For example: When the installation completes successfully, the Installation completed Remove Install media screen appears. 9.

IMPORTANT: If you do not eject the installation media and/or set the startup device to another drive, the host (VM) could boot back into

18 8. The Plexxi End User License agreement opens. To accept the agreement, press Tab to select the Accept button, then press Enter. Progress messages appear as the installation progresses. The installation will take a few minutes. For example: When the installation completes successfully, the Installation completed Remove Install media screen appears. 9. Eject the installation media (disk or ISO image). IMPORTANT: If you do not eject the installation media and/or set the startup device to another drive, the host (VM) could boot back into the installer menu again. 10. Press Tab to select OK, then press Enter. The system reboots. Continue You will be prompted to change the Linux root user password. Continue with the next section. 18 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

Changing the Linux Root User Password After installing Linux for Plexxi Control, when the Plexxi Control server/vm first boots, you are prompted to change the root user password.

Continue The Select Action screen opens. Continue with the next section. Selecting an Action After entering a new Linux root user password, the following Select Action screen opens.

19 Changing the Linux Root User Password After installing Linux for Plexxi Control, when the Plexxi Control server/vm first boots, you are prompted to change the root user password. Until this step is completed, the Plexxi Control server will not be fully functional. Enter a new Linux root user password, then as prompted to confirm, re-enter the password. Continue The Select Action screen opens. Continue with the next section. Selecting an Action After entering a new Linux root user password, the following Select Action screen opens. Continue In this screen, select the next action to continue: IMPORTANT: Unless you need to change the network settings that you previously entered, this screen can be skipped by selecting Quit. Device configuration - Optional. Used to configure interface devices such as eth0. Continue with the section, Configuring Network Settings for a Device on page 23. DNS configuration Optional. To configure DNS, continue with the section, Configuring DNS on page 24. Save&Quit or Quit - Save&Quit saves configuration information and completes the installation. Quit completes the installation without saving configuration changes made since the last reboot. For both Save&Quit or Quit, continue with the next section to select the time zone. 19 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

Selecting the Time Zone Selecting Save and Quit at the Select Action screen opens the Configure Timezones screen: In this screen, use the

Continue The Authentication Configuration screen opens. Continue with the next section to complete the installation.

Press Tab to select Next, then press Enter to continue. Do NOT make any configuration changes on this screen.

20 Selecting the Time Zone Selecting Save and Quit at the Select Action screen opens the Configure Timezones screen: In this screen, use the up-arrow and down-arrow to select the time zone, click Tab to select OK, and press Enter. Plexxi recommends using the UTC time zone. Continue The Authentication Configuration screen opens. Continue with the next section to complete the installation. Completing the Installation Selecting OK in the Configure Timezones screen opens the following Authentication Configuration screen. 1. Press Tab to select Next, then press Enter to continue. Do NOT make any configuration changes on this screen. The installation progress displays: The host completes booting and the localhost login prompt appears. The installation is complete. 20 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

21 The message contains the URL of the new Plexxi Control UI. For example: 2. When finished, verify the Plexxi Control installation. In a Web browser, enter the Plexxi Control URL that was displayed by the Plexxi Control installer. The URL format is: IMPORTANT: When connecting to Plexxi Control on port 8443, you must use the server's FQDN (Fully Qualified Domain Name). Log into Plexxi Control as administrator using the default credentials: Username: admin Password: plexxi Verify that the Plexxi Control UI opens successfully. 3. Also, you can log into Linux on the Plexxi Control VM as either: User: root and the new Linux root password set earlier in this procedure. User plexxi with the default password plexxi.: 4. You can test remote access to Linux as described in the next section. 5. Plexxi recommends that, while logged into the Plexxi Control UI as administrator, you change the Plexxi Control password to a secure password. Refer to the section Changing the Plexxi Control Password on page Plexxi recommends that you connect to the new VM and change the default Linux passwords for the root and plexxi user accounts. Refer to the section Changing Default Linux Passwords on a New VM on page The Plexxi Control installation is complete. Disregard all other installation chapters. To configure authentication to the Plexxi switches, refer to the Plexxi Switch Administrator Guide using Linux and Plexxi CLI. To configure advanced authentication for the Control VM system (i.e. UNIX logins to the machine, using LDAP, NIS, or directory service for account/password management, etc.) refer to the RedHat Enterprise Linux documentation. 21 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

22 Testing Remote Access to the Linux Host Plexxi recommends that you test remote (SSH) access to the Linux host by doing the following: 1. Run the ifconfig command to determine the IP address of the Linux host. The device name is hardware-dependent. If you are using a VM, it will be eth0, however on a bare-metal server it may be different (though is usually either eth0 or em1). 2. From another system, attempt an SSH connection to your server's IP address. Note: root logins via SSH are disabled by default, you will need to login using the plexxi user account, using the password plexxi. 22 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

Optional Configurations The following device and DNS configuration sections are optional. These settings were previously entered during the installation.

Configuring Network Settings for a Device IMPORTANT: The settings in this selection were previously entered during the installation.

23 Optional Configurations The following device and DNS configuration sections are optional. These settings were previously entered during the installation. You can use these optional screens if you want to change the network settings that you previously entered. Otherwise, skip these sections. Configuring Network Settings for a Device IMPORTANT: The settings in this selection were previously entered during the installation. You can use these optional screens if you want to change network settings that you previously entered. Otherwise, skip this section. In the Select Action screen, if you select Device configuration, the Select a Device screen opens. From this screen, you can select network devices on the Plexxi Control server/vm to configure. In this example eth0 is being configured: 1. Press tab to select a device, then press Enter. The Network Configuration screen opens to configure the selected device. 2. Edit the device configuration as needed. 3. Press Tab to select OK, then press Enter. (Or select Cancel to cancel the changes.) You are returned to Select a Device. 23 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

4. In Select a Device: To save changes and return to the Select Action screen, press Tab to select Save, then press Enter. To cancel and return to the Select Action screen.

24 4. In Select a Device: To save changes and return to the Select Action screen, press Tab to select Save, then press Enter. To cancel and return to the Select Action screen. press Tab to select Cancel, then press Enter. 5. Refer to Selecting an Action on page 19. Configuring DNS IMPORTANT: The settings in this selection were previously entered during the installation. You can use this optional screen if you want to change DNS network settings that you previously entered. Otherwise, skip this section. 1. In the Select Action screen, press the Down arrow to select DNS configuration and press Enter. The DNS configuration screen appears. 2. Make the edits you want and press Tab to select OK. (Or Cancel to cancel the operation.) 3. Press Spacebar. You are returned to the Select Action screen. 4. Select Quit to exit or Save&Quit to exit. The Authentication Configuration screen appears. See Authentication Configuration for details. 24 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

25 Troubleshooting Menu Selecting Troubleshooting from the main menu opens the following Troubleshooting menu: Rescue an existing system: Rescue a previously installed Linux system. Run a memory test: Use this utility to test the system memory and verify that it is working correctly. Boot from local drive: Attempt to boot the system from the local drive, using the boot order as defined in the system BIOS. Return to main menu: Return to the main installer menu.. 25 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

26 5 Upgrading Plexxi Control Online vs Offline Upgrade Plexxi Control upgrades can be performed either online with direct Internet access to the Plexxi public yum servers) or offline with no or limited Internet access. If you perform an offline installation or upgrade, you must manually download the.iso file from the Plexxi repository. The iso file contains all software packages needed for the installation or upgrade. Online Online means that the Control server/host is connected to the Internet, enabling you to perform the installation or upgrade directly from the Plexxi software distribution servers without first needing to download software to the controller. The online mode is the default and preferred installation mode because software packages are automatically downloaded by the installer. This eliminates the need to download and copy software bundles. Offline Offline is for customers who have Control servers on an internal network that does not have direct Internet access. In this case, you must download an offline software bundle (iso file) from the Plexxi software distribution servers and copy the iso file to your Control server/vm before upgrading Plexxi Control. 26 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

27 Upgrading Plexxi Control Online This procedure describes how to run the upgrade script which automatically downloads the software package and performs the upgrade. To upgrade Plexxi Control while online: 1. Determine the Plexxi Control upgrade version. IMPORTANT: Refer to the Plexxi Compatibility Matrix for information on compatibility between Plexxi Control and Plexxi Switch software. 2. Log into Linux on the Plexxi Control VM through either a console or SSH with the following credentials: Username: plexxi Password: plexxi 3. Run the upgrade script, entering the correct software version with appropriate command arguments for an upgrade: sudo install-plexxi-control --upgrade version Note: If needed, you can use the following command to view available versions of Plexxi Control: install-plexxi-control --list Note: sudo will likely prompt for a password for the plexxi login account. The default password is: plexxi Example For example, to upgrade to version 3.3.0: sudo install-plexxi-control - upgrade At the following prompt, Enter Y and press Enter. Do you want to proceed (Y/n) Y The upgrade continues. 5. If the installed Java version needs to be updated, you will be prompted to accept the Oracle End User License agreement. To accept the agreement, press Tab to select the Accept button, then press Enter. 27 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

28 When the upgrade successfully completes, you will see the following message: Plexxi Control software was successfully upgraded to version #.#.#! Next, the Tomcat application server starts up. Allow 2-3 minutes for the Plexxi Control application to start. Plexxi Control is now upgraded. 6. When finished, verify the upgrade. In a Web browser, log into the Plexxi Control UI as administrator using your Plexxi Control administrator account login and password. The URL format is: IMPORTANT: When connecting to Plexxi Control on port 8443, you must use the server's FQDN (Fully Qualified Domain Name). 7. Verify the Plexxi Control UI version and that the UI opens successfully. IMPORTANT: If this was an upgrade to or greater from a pre-3.0 release, in the Plexxi Control UI, you must run a Full Fit operation as described in the Plexxi Control Help, refer to Fit > Configure and Perform a Fit. Network fitting is the process of dynamically optimizing the network. 28 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

29 Upgrading Plexxi Control Offline This procedure describes how to perform an offline upgrade. You must download the offline upgrade software bundle (.iso file) and copy this file to your controller. The Plexxi Control installer will use the.iso file to install the software upgrade. Downloading the ISO Upgrade File 1. Determine the Plexxi Control upgrade version. IMPORTANT: Refer to the Plexxi Compatibility Matrix for information on compatibility between Plexxi Control and Plexxi Switch software. 2. Login to and navigate to the download directory for the version of Plexxi Control software. 3. Download the ISO upgrade file, PlexxiControl_Upgrade-version-date.iso where version is the Plexxi Control version and date is the date that the ISO file was built. Upgrade To upgrade Plexxi Control: 1. Log into Linux on the Plexxi Control VM through either a console or SSH with the following credentials: Username: plexxi Password: plexxi 2. Copy the ISO installer file to the server: scp isofilename plexxi@servername: 3. Run the upgrade script, using the appropriate command arguments for an upgrade: sudo install-plexxi-control --offline path/filename.iso --upgrade version Note: sudo will likely prompt for a password for the plexxi login account. The default password is: plexxi For example, if upgrading to version 3.3.0: sudo install-plexxi-control --offline PlexxiControl-Upgrade date.iso -upgrade At the following prompt, Enter Y and press Enter. Do you want to proceed (Y/n) Y The upgrade continues. 29 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

30 5. If the installed Java version needs to be updated, you will be prompted to accept the Oracle End User License agreement. To accept the agreement, press Tab to select the Accept button, then press Enter. When the upgrade successfully completes, you will see the following message: Plexxi Control software was successfully upgraded to version #.#.#! Next, the Tomcat server shuts down and restarts. Allow 1-2 minutes for the Tomcat server to start up Plexxi Control. Plexxi Control is now upgraded. 6. When finished, verify the upgrade. In a Web browser, log into the Plexxi Control UI as administrator using your Plexxi Control administrator account login and password. The URL format is: IMPORTANT: When connecting to Plexxi Control on port 8443, you must use the server's FQDN (Fully Qualified Domain Name). 7. Verify the Plexxi Control UI version and that the UI opens successfully. IMPORTANT: If this was an upgrade to or greater from a pre-3.0 release, in the Plexxi Control UI, you must run a Full Fit operation as described in the Plexxi Control Help, refer to Fit > Configure and Perform a Fit. Network fitting is the process of dynamically optimizing the network. 30 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

31 6 Administering Plexxi Control Changing Default Linux Passwords on a New VM Plexxi recommends that, soon after deploying a new Plexxi Control VM, you connect to the new VM and change the default Linux passwords for the root and plexxi user accounts. Important: Please ensure that you record these passwords in case they are required for future Controller server access. Plexxi Support will be unable to assist with access to your Controller if you change the default passwords and do not know the new passwords. To change the default Linux passwords for the root and plexxi user accounts: 1. Login to Linux (SSH, console) as user plexxi using the default password: plexxi 2. To change the plexxi user password, enter the passwd command and enter the new password, twice as prompted $ passwd 3. Access the root user account. When prompted for a password by the "sudo" command, enter the plexxi" account password that you just set above. $ sudo su 4. To change the root user password, enter the following command and enter the new passwords as prompted: # passwd 5. Exit the root user: # exit $ Changing the Plexxi Control Password Note: To change the administrator password or the password of any user other than yourself, you must have Administrator privileges. Any user can change their own password once logged into Plexxi Control. To change the password for any Plexxi Control user: 1. Open the Plexxi Control UI. In a Web browser, enter the Plexxi Control URL. The URL format is: IMPORTANT: When connecting to Plexxi Control on port 8443, you must use the server's FQDN (Fully Qualified Domain Name). 2. Log into Plexxi Control as administrator. If you are logging into Plexxi Control for the first time, the default credentials are: Username: admin Password: plexxi 31 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

3. In the Plexxi Control header, select the Operations icon > Configure > Users. The Manage Users window opens. For example: 4. Select the user and click Edit. The Edit User window opens. 5.

32 3. In the Plexxi Control header, select the Operations icon > Configure > Users. The Manage Users window opens. For example: 4. Select the user and click Edit. The Edit User window opens. 5. In the Password and Confirm Password fields, enter and re-enter the new password. For example: 6. Click OK. The new password will be in effect. 7. Clock Close to exit the Manage Users window 32 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

33 Changing the hostname of your Plexxi Control Server/VM If you change the hostname of your Plexxi Control server, you will either need to regenerate the selfsigned SSL certificate to match the new hostname or obtain and import a new signed SSL certificate that uses the new hostname. To regenerate the self-signed SSL certificate after changing the hostname, run the command "sudo regenerate-plexxicontrol-cert" and follow the prompts to generate and install the certificate and restart your Plexxi Control/tomcat application server. If you are using an officially signed SSL certificate, follow your process for obtaining a new signed certificate from your certificate vendor, then use the Plexxi Control certificate import helper script to install your new SSL certificate. Run the import helper script using the command "sudo plexxicontrolcert-helper" and following the prompts to import your certificate(s) and server key. Example $ sudo regenerate-plexxicontrol-cert [sudo] password for plexxi: ******** This helper script will assist you in regenerating the self-signed SSL certificate for your Plexxi Control (tomcat) application server. You normally only need to do this when the previous certificate has expired or you have changed your Plexxi Control server's hostname. WARNING: This will REPLACE any previously installed SSL certificate for Plexxi Control (tomcat)! If you are attempting to install an officially signed SSL certificate for your server, you should use the 'plexxicontrol-cert-helper' script instead of this one. If you are unsure or need assistance, please contact Plexxi Care: support@plexxi.com web: phone: Are you ready to regenerate your Plexxi Control self-signed SSL certificate? (y/n): y Plexxi Control tomcat application server is running, do you want to stop it? (y/n): y INFO: Stopping tomcat application server...this may take a minute. Regenerating self-signed SSL certificate for Plexxi Control/tomcat... A new self-signed SSL certificate for Plexxi Control/tomcat was successfully installed. Restarting Plexxi Control tomcat application server Finished! 33 Plexxi Control Installation, Upgrade and Administration Guide, through 3.3.0

Plexxi Control Installation, Upgrade and Administration Guide Release 3.2.0

Plexxi Control Installation, Upgrade and Administration Guide Release 3.2.0 702-20002-10 Rev 3.0 June 27, 2017 100 Innovative Way - Suite 3322 Nashua, NH 03062 Tel. +1.888.630.PLEX (7539) www.plexxi.com