Plexxi Control Installation, Upgrade and Administration Guide Releases 2.3.x, 2.4.x, 3.0.x, 3.1.0 702-20002-10 Rev 2.0 March 31, 2017 100 Innovative Way - Suite 3322 Nashua, NH 03062 Tel. +1.888.630.PLEX (7539) www.plexxi.com
Notices The information contained herein is subject to change without notice. Plexxi and the Plexxi logo are trademarks of Plexxi, Inc. in the United States and other countries. Other product or service names 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. 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 03062 Tel: +1.888.630.PLEX (7539) www.plexxi.com Published March 31, 2017 Printed in United States of America. Copyright 2012-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 1040.10 AND 1040.11 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 1040.10 ET 1040.11. Electrotechnical Commission (IEC) 60825-1, 60825-2 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, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Table of Contents Notices... 2 Introduction... 4 Related Documentation... 4 Contacting Plexxi Support... 4 Installation Considerations... 5 VM Requirements... 5 Supported VM Hypervisors... 5 Supported Hosts... 5 Supported Operating System... 5 Host Environment - Network Settings... 5 Security Considerations... 5 Initial Installation - High- Level Overview... 6 Plexxi Control Upgrade - High- Level Overview... 6 Downloading the ISO Installer Files... 6 Quick Start Online Initial Installation... 7 Installing Linux for Plexxi Control Online Quick Start... 7 Installing Plexxi Control Online Quick Start... 8 Installing Linux for Plexxi Control... 9 Installation Options... 9 Downloading the ISO file... 9 Linux Installer Main Menu... 10 Installer Main Menus for an Online Installation... 10 Installer Main Menus for an Offline Installation... 11 Installation Main Menu Information... 12 Automatic Installation (DHCP)... 13 Automatic Installation with Prompt for Static IP... 16 Changing the Linux Root Password... 20 Selecting an Action... 20 Selecting the Time Zone... 21 Completing the Linux Installation... 22 Testing Remote Access to the Linux Installation... 23 Configuring a Device (Optional)... 24 Configuring DNS (Optional)... 25 Installing or Upgrading Plexxi Control Online... 26 Installing or Upgrading Plexxi Control Offline... 28 Administering Plexxi Control... 30 Changing the hostname of your Plexxi Control Server/VM... 30 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 3
Introduction Plexxi Control runs as an application in a Linux environment. In this procedure, you must first install CentOS 6.x Linux for Plexxi Control on the server or VM, then you install Plexxi Control. In this procedure, you will install the following: CentOS 6.x Linux for Plexxi Control Plexxi Control. Ensure that the Plexxi Control version is compatible with Plexxi Switch version. Refer to the Plexxi Compatibility Matrix which is available on the Technical Documentation page on plexxi.com: http://www.plexxi.com/technical-documentation/ Related Documentation The following additional documentation supports this release: Plexxi Compatibility Matrix, Version 5 or greater. The Plexxi Compatibility Matrix contains version-specific software and hardware support information as well as cable and transceiver support information. Plexxi Release Notes, Release 3.1.0 Plexxi Switch Administrator Guide using Linux and Plexxi CLI, Release 3.1.0 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 http://www.plexxi.com. 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 1.888.415.9809 (US/Canada toll-free) +1 603-782-0702 (US/International) www.plexxi.com/support 4 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Installation Considerations Review the following information to prepare for your installation. VM Requirements To support Plexxi Control, you must create a virtual machine that meets the following minimum requirements: 4 CPU cores 8 GB RAM 200 GB disk space Supported VM Hypervisors VMware ESXi IMPORTANT: If you need to install Plexxi Control on a different hypervisor, contact Plexxi Support before attempting the installation. Supported Hosts VMware virtual machines (VMs) Supported Operating System Linux CentOS Host Environment - Network Settings The host IP address can be set either statically or dynamically (DHCP). Plexxi recommends setting a static IP address for the host, However, if you use DHCP, you must take steps (for example, via a reservation on the DHCP server) to ensure that the host IP address does not change. Determine the following network settings: DHCP: The installer supports DHCP configurations with no additional configuration required. However, on the DHCP server, you should add a DHCP reservation and/or DNS hostname entry on your DHCP/DNS server(s). Static IP: If you use static IP, determine your 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. Hostname: You can either pass a specific hostname to the installer as a boot option or ensure that your DNS server has the hostname entry for your DHCP reserved or assigned to a static IP address. Security Considerations The Plexxi Linux for 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: https://access.redhat.com/documentation/en- US/Red_Hat_Enterprise_Linux/6/html/Security_Guide/ Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 5
Initial Installation - High-Level Overview Linux for Plexxi Control needs to be installed during the Initial Installation before you can install Plexxi Control. After installing Linux during the initial installation, you can install and, in the future, upgrade Plexxi Control without re-installing Linux. If you are installing Linux and Plexxi Control for the first time: 1. Download the ISO installer file(s) as described in the section, Downloading the ISO Installer Files. 2. Install Linux for Plexxi Control. (CentOS 6.x) as described in the section, Installing Linux for Plexxi Control. 3. Install Plexxi Control using either Online or Offline, as described in the appropriate section: Installing or Upgrading Plexxi Control Online Installing or Upgrading Plexxi Control Offline Plexxi Control Upgrade - High-Level Overview If Linux for Plexxi Control and Plexxi Control is already installed and you need to upgrade Plexxi Control, proceed as follows: 1. Determine the Plexxi Control version to install. IMPORTANT: You must install the Plexxi Control version that matches the installed Plexxi switch software version. 2. Download the ISO installer file(s) as described in the section, Downloading the ISO Installer Files. 3. Upgrade Plexxi Control using either Online or Offline, as described in the appropriate section: Installing or Upgrading Plexxi Control Online Installing or Upgrading Plexxi Control Offline Downloading the ISO Installer Files Determine if the installation will be online (network-based, Internet access required) or offline (self-contained, no network access required). To perform the installation online, you need: the Plexxi Control Linux ISO installer: plexxicontrol-linux-el6-online-date.iso Download from https://software.plexxi.com in Control > linux_iso > version. To perform the installation offline, you need: the Plexxi Control Linux ISO installer: plexxicontrol-linux-el6-offline-date.iso Download from https://software.plexxi.com in Control > linux_iso > version. the Plexxi Control offline software bundle: plexxicontrol-offline-install-version-date.iso Download from https://software.plexxi.com in Control > releases > version. 6 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Quick Start Online Initial Installation Provided for convenience, the following quick start installation uses defaults in an online environment to install the Linux for Plexxi Control operating system and then install Plexxi Control. IMPORTANT: For detailed instructions, refer to the detailed installation procedures that follow this section. Installing Linux for Plexxi Control Online Quick Start 1. Create a Virtual Machine (VM) on which to install and run Plexxi Control. Adhere to the previously-specified requirements (memory/cpu/disk). Configure the VM to boot from the Linux ISO installer file. 2. Power ON the VM and immediately launch a remote VM console. The Linux installer automatically launches and the installer main menu will appear in the Console, with Automatic Install selected and an automatic boot timer counting down. 3. In the Linux for Plexxi Control Installer screen, press Enter to immediately launch the Automatic installation. 4. In the Accept Oracle License screen, press Tab to select Accept, then press Enter to continue. 5. In the Accept Plexxi End User License screen, press Tab to select Accept, then press Enter to continue. Installation progress messages appear. The installation takes a few minutes. 6. When the Installation Completed Remove Install Media screen opens, eject the installation media. 7. Press Tab to select OK, then press Enter. The system reboots and you are prompted to change the root user password. Note: When the server/vm first boots after the Linux installation, you must change the root password. Until this step is completed, the Plexxi Control server will not be fully functional. 8. Enter a secure password for the host root user. 9. In the Select Action screen, press Tab to select Save&Quit, then press Enter. 10. In the Configure Timezones screen, use the up-arrow and down-arrow to select the time zone, press Tab to select OK, and press Enter to continue. 11. In the Authentication Configuration screen, press Tab to select Next, then press Enter to continue. After this screen the system will complete the boot process and you will receive a login prompt. The Linux installation is complete. You can login to Linux as root user with the new secure password. 12. Install Plexxi Control as described in the next section. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 7
Installing Plexxi Control Online Quick Start With Linux installed, you can now install Plexxi Control. 1. Determine the version of Plexxi Control software to install. IMPORTANT: You must install the Plexxi Control version that matches the installed Plexxi switch software version. 2. Log in either on the console or remotely via SSH as username plexxi with the default password plexxi. 3. Run the installation script. For example, to install 3.1.0: sudo install-plexxi-control 3.1.0 Note: sudo will likely prompt for a password for the plexxi login account. The default password is: plexxi 4. When prompted, type Y and press Enter. The installation runs automatically. 8 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Installing Linux for Plexxi Control Linux for Plexxi Control needs to be installed during the Initial Installation before you can install Plexxi Control. After installing Linux during the initial installation, you can install and, in the future, upgrade Plexxi Control without re-installing Linux. Installation Options You chose from the following options to install Linux for Plexxi Control: Automatic Install Configures DHCP. This is the preferred method. This Automatic installer automates most of the Linux OS installation for you by completing the installations with minimal interaction. You are prompted to accept license agreements. Automatic Install, prompt for static IP Use to configure static IP. This Automatic installer automates most of the Linux OS installation for you by completing the installations with minimal interaction. You are prompted to accept license agreements and enter static IP address information. Install from USB drive requires Plexxi Support assistance. Advanced installation options require Plexxi Support assistance. Advanced and USB Installation Options Contact either Plexxi Support or your Plexxi representative before using the Advanced Installation options or installing from USB drive. Installation Option Offline/Online IMPORTANT Install from USB device Advanced Installation Advanced disk configuration options No hardware checks options Rescue previously installed Linux system Offline only Offline/Online Offline/Online Offline/Online Offline/Online Contact Plexxi Support before using any of these installation options. Refer to Error! Reference source not found. on page Error! Bookmark not defined.. Downloading the ISO file To perform the installation online, before starting the installation, you need: a network connection the Control Linux ISO installer: plexxicontrol-linux-el6-online-date.iso available from https://software.plexxi.com To perform the installation offline, before starting the installation, you need: the Control Linux ISO installer: plexxicontrol-linux-el6-offline-date.iso available from https://software.plexxi.com Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 9
Linux Installer Main Menu The following subsections identify the initial installer menu screen(s) that you will see when you power on your VM to boot from the installer ISO. You will be able to select and start the installation method from the menu. The actual procedures follow this informational section. Installer Main Menus for an Online Installation For an Online installation, the following is a sample main installer screen: Selecting Advanced installation options opens the following: 10 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Installer Main Menus for an Offline Installation For an Offline installation, the following is a sample main installer screen: Selecting Advanced installation opens the following: Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 11
Installation Main Menu Information In the Linux for Plexxi Control Installer screen that opens, the Automatic Install option is selected by default and the boot countdown is active. Note: To use another installation option, before the countdown completes, use the up-arrow and down-arrow to select the option, then press Enter to start the installation. Note: If you select Advanced Installation options and then select Return to the main menu and press Enter, you are returned to the main installer screen. The Automatic Install option will be selected and the boot countdown active. Continue Continue with the appropriate section depending on the installation type: Automatic Installation (DHCP) Automatic Installation with Prompt for Static IP 12 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Automatic Installation (DHCP) Plexxi recommends that you use the Automatic Install option. This option is selected by default when you first access the installer and an installation countdown of 120 seconds begins immediately. IMPORTANT: Automatic installation configures your server to use DHCP. To perform an automatic installation: 1. Create a Virtual Machine (VM) on which to install and run Plexxi Control. Adhere to the previously-specified requirements (memory/cpu/disk). Configure the VM to boot from the Linux ISO installer file. 2. Power ON the VM and immediately launch a remote VM console. The Linux installer automatically launches and the installer main menu will appear in the Console, with Automatic Install selected and an automatic boot timer counting down. Note: To use another installation option, before the countdown completes, use the up-arrow and down-arrow to select the option, then press Enter. For example, for an Online installation: 3. Press Enter to launch the Automatic installation. Progress messages appear as the installation progresses. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 13
4. 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. 5. 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: 14 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
When the installation completes successfully, the Installation completed Remove Install media screen appears. 6. Eject the installation media. 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. 7. Press Tab to select OK, then press Enter. The system reboots. Continue 8. You will be prompted to change the Linux password. Continue with the section, Changing the Linux Root Password. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 15
Automatic Installation with Prompt for Static IP Use this installation option to install Linux and by specify a static IP address for the host. 1. Create your VM, adhering to the previously-specified requirements Create a Virtual Machine (VM) on which to install and run Plexxi Control. Adhere to the previously-specified requirements (memory/cpu/disk). Configure the VM to boot from the Linux ISO installer file. 2. Power ON the VM and immediately launch a remote VM console. The Linux installer automatically launches and the installer main menu will appear in the Console, with Automatic Install selected and an automatic boot timer counting down. Note: To use another installation option, before the countdown completes, use the up-arrow and down-arrow to select the option, then press Enter. For example, for an Online installation: 3. Press Tab to select Automatic Install, prompt for static IP, then press Enter to launch the installation. 16 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
4. In the Configure TCP/IP screen, under Enable IPv4 support, press Tab to highlight Manual configuration, then press the Spacebar to select it. An asterisk appears in the selected item. 5. Press Tab to select OK, then press Enter to continue. 6. In the Manual TCP/IP Configuration screen, enter the following information: Static IPv4 address and network mask in dot-decimal or CIDR notation. Gateway IP address Name server address. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 17
7. Press Tab to select OK and press Enter to continue. The Waiting for NetworkManager to configure eth0 message appears. Progress messages appear as the installation progresses. 8. 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. 9. The Plexxi End User License agreement opens. To accept the agreement, press Tab to select Accept, then press Enter. 18 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
10. Progress messages appear as the installation progresses. The installation will take a few minutes. For example: 11. When the installation completes successfully, the Installation completed Remove Install media screen appears. 12. Eject the installation media (disk or ISO image). 13. Press Tab to select OK, then press Enter. The system reboots. Continue 14. You will be prompted to change the Linux password. Continue with the next section, Changing the Linux Root Password. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 19
Changing the Linux Root Password After installing Linux for Plexxi Control, when the Plexxi Control server/vm first boots, you are prompted to change the root 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. 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: Device configuration - Optional. Used to configure interface devices such as eth0. Continue with the section, Configuring a Device (Optional). DNS configuration Optional. To configure DNS, continue with the section, Configuring DNS (Optional). 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, Selecting the Time Zone. 20 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
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. Continue The Authentication Configuration screen opens. Continue with the next section, Completing the Linux Installation. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 21
Completing the Linux Installation Selecting OK in the Configure Timezones screen opens the following Authentication Configuration screen. IMPORTANT: Do NOT change the settings on this screen; they have no impact on Plexxi Control accounts. For Static IP, you will see a screen similar to: For DHCP, you will see a screen similar to: Continue as follows: 1. Press Tab to select Next, then press Enter to continue. Do NOT make any configuration changes on this screen. The host completes booting and the localhost login prompt appears. The Linux installation is complete. You can login to Linux as either: User: root and the new Linux root password set earlier in this procedure. User: plexxi and the password: plexxi. 22 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Continue 2. Test remote access to Linux as described in the next section, Testing Remote Access to the Linux Installation. 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. Testing Remote Access to the Linux Installation Plexxi recommends that you test remote (SSH) access by doing the following: 1. Run the ifconfig command to determine your server's IP address. The device name is hardware-dependent but it 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. Continue To install Plexxi Control, continue with the appropriate section: Installing or Upgrading Plexxi Control Online Installing or Upgrading Plexxi Control Offline Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 23
Configuring a Device (Optional) 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. 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. In the Select Action screen, continue as described in the section, Selecting an Action. 24 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
Configuring DNS (Optional) 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. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 25
Installing or Upgrading Plexxi Control Online This procedure describes how to perform an online installation or upgrade which automatically downloads the install ISO file and performs the installation. Note: For an Initial Installation, before you can install Plexxi Control, you must first install Linux for Plexxi Control as described earlier in this document. To install or upgrade Plexxi Control while online: 1 Determine the version of Plexxi Control software to install or upgrade to. IMPORTANT: You must install the Plexxi Control version that matches the installed Plexxi switch software version. 2 Log in either on the console or remotely via SSH as username plexxi with the default password plexxi. 3 Run the install script, entering the correct software version with appropriate command arguments for either an initial installation or an upgrade: For an Initial Installation: sudo install-plexxi-control version To upgrade to a newer version: 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 Examples For an Initial Installation, if installing version 3.1.0: sudo install-plexxi-control 3.1.0 For an Upgrade, if upgrading to version 3.1.0: sudo install-plexxi-control - upgrade 3.1.0 4 At the following prompt, Enter Y and press Enter. The installation continues. Do you want to proceed (Y/n) Y The installation 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. 26 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
When the installation successfully completes, you will see the following message: Plexxi Control version #.#.# software was successfully installed. Next, the Tomcat application server starts up. Allow 2-3 minutes for the Plexxi Control application to start. Plexxi Control is now installed. 6 To open the Plexxi Control UI, in a Web browser, enter the URL that was displayed by the Plexxi Control installer. The URL format is: https://<hostname>:8443/plexxiui/ Log into Plexxi Control as administrator using the default credentials: Username: admin Password: plexxi IMPORTANT: In the Plexxi Control UI, change the password to a secure password. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 27
Installing or Upgrading Plexxi Control Offline With Linux in place, you can now install Plexxi Control. This procedure describes how to perform an offline installation. You must download the installer, then the installer automatically performs the installation. IMPORTANT: To install or upgrade Plexxi Control offline, you must download the Plexxi Control installer file from https://software.plexxi.com in Control > releases > version.. Download the file: plexxicontrol-offline-install-version-date.iso. where version is the Plexxi Control version and date is the date that the ISO file was built. To install or upgrade Plexxi Control while offline: 1 Determine the version of Plexxi Control software to install. IMPORTANT: You must install the Plexxi Control version that matches the installed Plexxi switch software version. 2 Download the installer file from software.plexxi.com. The installer file is: plexxicontrol-offline-install-version-date.iso 3 Log in either on the console or remotely via SSH as username plexxi with the default password plexxi. 4 Copy the ISO installer file to the server: scp isofilename plexxi@servername: 5 Run the install script, using the appropriate command arguments for either an initial installation or an upgrade: For an Initial Installation: sudo install-plexxi-control --offline path/filename.iso version For an Upgrade: sudo install-plexxi-control --offline path/filename.iso --upgrade version Examples For an Initial Installation, if installing version 3.1.0: sudo install-plexxi-control --offline plexxicontrol-offline-install- 3.1.0-date.iso 3.1.0 For an Upgrade, if upgrading to version 3.1.0: sudo install-plexxi-control --offline plexxicontrol-offline-install- 3.1.0-date.iso -upgrade 3.1.0 6 At the following prompt, Enter Y and press Enter. The installation continues. Do you want to proceed (Y/n) Y The installation continues. 28 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0
7 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 installation successfully completes, you will see the following message: Plexxi Control version #.#.# software was successfully installed. 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 installed. 8 To open the Plexxi Control UI, in a Web browser, enter the URL that was displayed by the Plexxi Control installer. The URL format is: https://<hostname>:8443/plexxiui/ Log into Plexxi Control as administrator using the default credentials: Username: admin Password: plexxi IMPORTANT: If this was an upgrade to 3.0, in the Plexxi Control UI, you must run a Full Fit. IMPORTANT: If this was an initial installation, in the Plexxi Control UI, change the password to a secure password. Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0 29
Administering Plexxi Control 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 self-signed 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 plexxicontrol-cert-helper" and following the prompts to import your certificate(s) and server key. 30 Plexxi Control Installation, Upgrade and Administration Guide, 2.3.x, 2.4.x, 3.0.x, 3.1.0