LIVEACTION, INC. LIVENX UPGRADE GUIDE 7.2.0 UPGRADE LiveAction, Inc. 3500 Copyright WEST BAYSHORE 2017 LiveAction, ROAD Inc. All rights reserved. LiveAction, LiveNX, LiveUX, the LiveAction Logo and PALO LiveAction ALTO, CA Software 94303 are trademarks of LiveAction, Inc. Information subject to change without notice.
The Upgrade Guide consists of the following steps: Step 1. Backup LiveNX Configurations. Note: DO NOT PROCEED to Step 2 without taking a LiveNX Backup. Step 2. Upgrading the Open Virtualization Appliance (OVA) based LiveNX a. All-In-One OVA (Mandatory, if you are already using the All-In-One OVA) i. LiveNX Online Upgrade ii. LiveNX Offline Upgrade b. Node OVA (If applicable) i. LiveNX Node Online Upgrade(For LiveNX 7.x) ii. LiveNX Node Offline Upgrade (For LiveNX 7.x) iii. Upgrading the Node OVA from 6.x to 7.x Step 3. Upgrading the LiveNX Client (Mandatory) c. Windows d. Mac Step 4. Verification (Recommended) 1-1 LiveNX Upgrade Guide
NOTES: For customers with Cloud License: Your 7.x License Key has been activated. Customers who are currently using LiveNX 6.x and have a Traditional license key activated, will require a new license to support the new software. However, if you are using the All-In-One OVA with internet connectivity, please contact support@liveaction.com to convert your Traditional key to a Cloud license. You may upgrade directly to LiveNX 7.2.0 (via WebUI online/offline method) from the following versions, 6.0.x, 6.1.x,6.2.x,7.x,7.1.x using the full upgrade package URL from the LiveAction Download Page. In a virtual environment, take a snapshot of your current LiveAction VM(s) before proceeding with the upgrade Once the upgrade has been successfully completed, power off the VM and delete the snapshot. VMs with snapshots run slower in general and will impact the performance. Do not use a single snapshot for more than 24-72 hours. 1-2 LiveNX Upgrade Guide
Upgrading the All-In-One OVA (Online) This section provides instructions to upgrade the All-In-One OVA to the latest version via the WebUI Online method. CAVEAT: 1. It will take 5-10 minutes to upgrade from v6.x to v7.1.x REQUIRED: 1. The Primary DNS must be reachable from the LiveNX Server 2. 8 GB RAM requirements. Step 1 Browse to the IP Address https://<all-in-one OVA_IP> of the LiveNX Server All-In-One OVA. The IP Address may be found by opening the console view of the All-In-One OVA in ESXi. Step 2 Click the hamburger icon on the top left and a menu will be displayed. Figure 1: LiveNX Dashboard 1-3 LiveNX Upgrade Guide
Step 3 Click on Update and go to Online update: Step 4 Figure 2: About page on the OVA Place the following URL in the empty field: https://download.liveaction.com/livenx/7_2_0/software_package-livenx-server-7.2.0-full.enc Figure 3: Online update 1-4 LiveNX Upgrade Guide
Step 5 After you apply the URL and click on Start Update, you will see a status bar going from Downloading > Running > Success and will be logged out from the Web UI. In ESXi, you will also see the All-In-One OVA reboot automatically. Figure 4a: Downloading Figure 4b: Running Figure 4c: Success 1-5 LiveNX Upgrade Guide
Step 6 On the top right corner of the page select the question mark icon. Go to the About page and verify the Server and Web version has been updated to 7.2.0. After confirming, the upgrade to LiveNX 7.2.0 has been completed. Figure 5: LiveNX Version in the WebUI 1-6 LiveNX Upgrade Guide
Upgrading the All-In-One OVA (Offline) This section provides instructions to upgrade the All-In-One OVA to the latest version via the WebUI Offline method. CAVEAT: REQUIRED: 1. It takes 5-10 minutes to upgrade from v6.x to v7.1.x 1. The Primary DNS must be reachable from the LiveNX Server 2. 8 GB RAM requirements. Step 1 Download the upgrade package. 1. Copy and paste the following URL in a browser to download the upgrade package: https://download.liveaction.com/livenx/7_2_0/software_package-livenx-server-7.2.0-full.enc Step 2 Browse to the IP Address https://<all-in-one OVA_IP> of the LiveNX Server All-In-One OVA. The IP Address may be found by opening the console view of the All-In-One OVA in ESXi. Step 3 Click the hamburger icon on the top left and a menu will be displayed. 1-7 LiveNX Upgrade Guide
Figure 1: LiveNX Dashboard Step 4 Click on Update and go to Offline update: Figure 2: Offline Update Step 5 Click on Choose File and browse to the directory where the software package was downloaded, and click on Open: Figure 3: Selecting the upgrade package 1-8 LiveNX Upgrade Guide
Step 6 After selecting the software package, click on Start Update. You will see a status bar going from Uploading > Running > Success and will be logged out from the WebUI. In ESXi, you will also see the All-In-One OVA reboot automatically. Figure 5a: Uploading Figure 5b: Running Figure 5c: Success 1-9 LiveNX Upgrade Guide
Step 7 Go to the About page and verify the Server and Web version has been updated to 7.2.0 After confirming, the upgrade to LiveNX 7.2.0 has been completed. Figure 8: LiveNX Version in the WebUI 1-10 LiveNX Upgrade Guide
Upgrading the Node OVA (Online) This section provides instructions to upgrade the Node OVA v7.x to the latest version via the Node Admin UI. CAVEAT: REQUIRED: Step 1 1. It takes 5-10 minutes to upgrade from v6.x to v7.1.x 1. The Primary DNS must be reachable from the LiveNX Server 2. 8 GB RAM requirements. Browse to the IP Address https://<all-in-one OVA_IP:8092> of the LiveNX Node OVA. The IP Address may be found by opening the console view of the LiveNX Node Appliance in ESXi. Step 2 Enter username=admin and password=admin, then Click Login Step 3 Click Update Figure 1: Login Figure 2: Update 1-11 LiveNX Upgrade Guide
Step 4 Click Online then place the following URL in the empty field: https://download.liveaction.com/livenx/7_2_0/software_package-livenx-server-7.2.0-full.enc Click Start Update Figure 3: Start Update Step 4 Figure 4: OVA will be rebooted During the process, the LiveNX Node OVA will reboot automatically. Once the Node OVA boots back up, it should now show LiveNX Version: 7.2.0 in the console. Node Status should be Running. Figure 5: OVA Updated Successfully 1-12 LiveNX Upgrade Guide
Upgrading the Node OVA (Offline) This section provides instructions to upgrade the Node OVA v7.x to the latest version via the Node Admin UI. CAVEAT: REQUIRED: Step 1 1. It takes 5-10 minutes to upgrade from v6.x to v7.1.x 1. The Primary DNS must be reachable from the LiveNX Server 2. 8 GB RAM requirements. Download the upgrade package. 1. Copy and paste the following URL in a browser to download the package https://download.liveaction.com/livenx/7_2_0/software_package-livenx-node-7.2.0-full.enc Step 2 Browse to the IP Address https://<all-in-one OVA_IP:8092> of the LiveNX Node OVA. The IP Address may be found by opening the console view of the LiveNX Node Appliance in ESXi. Step 3 Enter username=admin and password=admin, then Click Login Figure 1: Login 1-13 LiveNX Upgrade Guide
Step 4 Click Update Step 5 Figure 2: Update Click Offline then click Choose File to select update file then click Start Update Figure 3: Offline Update Figure 4: Start Updating 1-14 LiveNX Upgrade Guide
Figure 4: OVA will be rebooted Step 4 During the process, the LiveNX Node OVA will reboot automatically. Once the Node OVA boots back up, it should now show LiveNX Version: 7.2.0 in the console. Node Status should be Running. Figure 5: OVA Updated Successfully 1-15 LiveNX Upgrade Guide
Upgrading the Node OVA Via Jidoteki Admin UI This section provides instructions to upgrade the Node OVA v6.x to the latest version via the Jidoteki Admin UI. CAVEAT: REQUIRED: Step 1 1. It takes 5-10 minutes to upgrade from v6.x to v7.1.x 1. The Primary DNS must be reachable from the LiveNX Server 2. 8 GB RAM requirements. Download the upgrade package. 2. Copy and paste the following URL in a browser to download the package https://download.liveaction.com/livenx/7_2_0/software_package-livenx-node-7.2.0-full.enc Step 3 Open the Terminal on the Node OVA to obtain the API token. If an API token already exists, type cat /opt/jidoteki/tinyadmin/etc/api.token and copy the output. In this example, your API token is YourNewToken. In a browser, type in https://<node-ova-ip>:8443 Login with your API token Figure 1: Obtaining the API token 1-16 LiveNX Upgrade Guide
Step 4 Figure 2: Logging in with API token If one does not exist, set the token via API: a. In a browser, type in https://<all-in-one-ova-ip>:8443 b. Click on API Token Setup c. Set up the API Token and click Update Figure 3: Using the API to set a token Figure 4: Setting up the API Token d. Status after setting the token a. Status: Changed 1-17 LiveNX Upgrade Guide
Step 5 Figure 5: Status: Changed Once you are logged in, click the Update menu option, then click on Choose File and browse to the Upgrade Package you downloaded in Step 2. Figure 6: Click on update 1-18 LiveNX Upgrade Guide
Step 6 After clicking on Update, the upgrade process will begin. When it is completed, Status: success will show, and the Node OVA will automatically reboot. Step 7 Figure 7: Upgrade process and status Verify the Node Management Console has been upgraded. Node Status should be Running. (a) In a browser, type in https://<all-in-one-ova-ip>:8092, Enter username and password (admin/admin) Figure 8: Node Login Page 1-19 LiveNX Upgrade Guide
Step 9 Figure 9: LiveNX Node Upgraded Successfully Also, verify the node status on the LiveNX Server Management Console is showing as connected. Figure 10: LiveNX Server Management Console 1-20 LiveNX Upgrade Guide
Upgrading the LiveNX Client for Windows Details on the installation procedure using the Client installer can be found in the LiveNX User Guide Chapter 2: Installation. The LiveNX Client installation process remained the same. Step 1 Uninstall the Client. Click on Next to confirm the uninstallation procedure. Step 2 Figure 1: Client Uninstaller via Start shortcut Run the executable file LiveNXClient_windows-x64_<version>_setup.exe. The first page of the Wizard is shown below. Select the Next button. Figure 2: Windows Client Install Welcome Page 1-21 LiveNX Upgrade Guide
Step 3 Proceed to the Destination Directory Page. We recommend that you accept the default file location, unless you decide to run the Client from a different directory. Then select Next. Figure 3: Windows Client Installation Destination Directory Step 4 Setup the Start Menu folder. We recommend you accept the default name for this folder in order to reduce any confusion with previous or subsequent versions of the Client. Step 4: Windows Client Installation Start Menu Folder 1-22 LiveNX Upgrade Guide
Step 5 Click Next on the Client setup, Select Additional Tasks window to accept the creation of a desktop icon. Figure 5: Select Additional Tasks on the Client Step 6 The Client setup will begin its load procedure. When it is complete, you will see this: Figure 6: Windows Client Installation Completion 1-23 LiveNX Upgrade Guide
Upgrading the LiveNX Client for Mac Details on the installation procedure using the Client installer can be found in the LiveNX User Guide Chapter 2: Installation. The LiveNX Client installation process remained the same. Step 1 Uninstall the Client by going into Finder. Navigate to the Applications directory (this is the default directory), bring up the menu option by right-clicking on the LiveNX Client, and selecting Move to Trash. Figure 1: Uninstalling the Client Step 2 Install the LiveNX Client by opening the LiveNXClient_macos_<version>_setup.dmg file. Run the Client installer and follow the installation wizard: 1-24 LiveNX Upgrade Guide
Step 3 Figure 2: Installation wizard Proceed to the Destination Directory Page. We recommend that you accept the default file location unless you decide to run the Client from a different directory. Then select Next. Figure 3: Mac Client destination directory Step 4 Click Next on the Client setup, Select Additional Tasks page to accept the creation of a desktop icon. 1-25 LiveNX Upgrade Guide
Step 5 Figure 4: Select Additional Tasks Create a desktop icon The Client setup will begin its load procedure. Click on Finish. Figure 5: Completing the install wizard 1-26 LiveNX Upgrade Guide
Step 6 When the installer completes, run the Client and login using the same credentials. Figure 6: Client login 1-27 LiveNX Upgrade Guide
Verification (Recommended) Once the Client, the Server and the Node are upgraded, login to the Client and verify that all your devices are loaded into the Client. If any devices are greyed out, perform a REFRESH for that specific device or select HOME and Refresh all devices. After this effort completes, all of the devices should be green. If any issues arise during the upgrade process, contact LiveAction Technical Support at the phone number or email address shown on our website. Copyright 2017 LiveAction, Inc. All rights reserved. LiveAction, LiveNX, LiveUX, the LiveAction Logo and LiveAction Software are trademarks of LiveAction, Inc. Information subject to change without notice.