LIVEACTION, INC. LIVENX UPGRADE GUIDE 7.0.1 (AIO) 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 iii. Upgrading the All-In-One OVA from v5.3.0 to v7.x 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 previous version 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.0.1 (via WebUI online/offline method) from the following versions, 5.2.0, 5.2.1, 5.3.1, 6.0.0, 6.0.1,6.0.2, 6.1.0,6.1.1,6.1.2,6.2.0,6.2.1,6.2.2,6.2.3 using the full upgrade package URL from the LiveAction Download Page. If you are upgrading from LiveNX 5.3.0 to 7.x, please refer to Upgrading the All-In-One OVA from v5.3.0 to v7.x (Jidoteki AdminUI) section of this guide 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: REQUIRED: 1. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 2. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 1. The Primary DNS must be reachable from the LiveNX Server 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. Figure 1: All-In-One OVA console 1-3 LiveNX Upgrade Guide
Step 2 Click the hamburger icon on the top left and a menu will be displayed. Figure 2: LiveNX Dashboard Step 3 Click on Update and go to Online update: Figure 3: About page on the OVA 1-4 LiveNX Upgrade Guide
Step 4 Place the following URL in the empty field: https://download.liveaction.com/livenx/7_0_1/software_package-livenx-server-7.0.1-full.enc Figure 4: Online update 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 5a: Downloading Figure 5b: Running 1-5 LiveNX Upgrade Guide
Step 6 Figure 5: Success During the process, the All-In-One OVA will reboot automatically. Once the All-In-One OVA boots back up, it should now show LiveNX Version: 7.0.1 in the console. Figure6: After the OVA reboots Step 8 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.0.1. After confirming, the upgrade to LiveNX 7.0.1 has been completed. 1-6 LiveNX Upgrade Guide
1-7 LiveNX Upgrade Guide Figure 7: LiveNX Version in the WebUI
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. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 2. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 1. The Primary DNS must be reachable from the LiveNX Server 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_0_1/software_package-livenx-server-7.0.1-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. Figure 1: All-In-One OVA console 1-8 LiveNX Upgrade Guide
Step 3 Click the hamburger icon on the top left and a menu will be displayed. Step 4 Click on Update and go to Offline update: Figure 2: LiveNX Dashboard Figure 3: Offline Update 1-9 LiveNX Upgrade Guide
Step 5 Click on Choose File and browse to the directory where the software package was downloaded, and click on Open: Figure 4: Selecting the upgrade package 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 1-10 LiveNX Upgrade Guide
Figure 5b: Running Figure 5c: Success Step 7 During the process, the All-In-One OVA will reboot automatically. Once the All-In-One OVA boots back up, it should now show LiveNX Version: 7.0.1 in the console. 1-11 LiveNX Upgrade Guide
Step 8 Figure 7: After the OVA reboots Go to the About page and verify the Server and Web version has been updated to 7.0.1 After confirming, the upgrade to LiveNX 7.0.1 has been completed. Figure 8: LiveNX Version in the WebUI 1-12 LiveNX Upgrade Guide
Upgrading the All-In-One OVA from v5.3.0 to v7.x (Jidoteki AdminUI) This section provides instructions to upgrade the All-In-One OVA to the latest version via the Jidoteki Admin UI CAVEAT: REQUIRED: 1. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 2. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 2. The Primary DNS must be reachable from the LiveNX Server 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_0_1/software_package-livenx-server-7.0.1-full.enc Step 2 Open the Terminal on the 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 : Figure 1: Obtaining the API token 1-13 LiveNX Upgrade Guide
In a browser, type in https://<all-in-one-ova-ip>:8443 o Login with your API token Figure 2: Logging in with API token Step 3 If one does not exist, set the token via API: 1. In a browser, type in https://<all-in-one-ova-ip>:8443 2. Click on API Token Setup Figure 3: Using the API on Web UI to set a token 3. Set up the API Token and click Update Figure 4: Setting up the API Token 1-14 LiveNX Upgrade Guide
a. Status after setting the token i. Status: Changed Figure 5: Status: Changed Step 4 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 1. Figure 6: Click on update 1-15 LiveNX Upgrade Guide
Step 5 After clicking on Update, the upgrade process will begin. When it is completed, Status: success will show and the All-In-One OVA will automatically reboot. Step 6 Figure 7: Upgrade process and status During the process, the All-In-One OVA will reboot automatically. Once the All-In-One OVA boots back up, it should now show LiveNX Version: 7.0.1 in the console. Figure 8: After the OVA reboots 1-16 LiveNX Upgrade Guide
Step 7 Once your Cloud license account is created, you will receive an email from LiveAction with a temporary password to access the LiveAction Cloud Licensing Portal. If not, please contact license@liveaction.com or support@liveaction.com Login to the WebUI, click on Add License and proceed to the next step: Figure 10: License page in the WebUI Step 8 Another window will pop-up to enter your License Key and Secret. In another tab, open the LiveAction Licensing Portal. Figure 11: Licensing portal 1-17 LiveNX Upgrade Guide
Step 9 Once you are logged into the Licensing Portal, you will see your LiveNX 7.x License(s) here. In the Details column, click on the eye icon to obtain your Key and Secret: Figure 12: password portal Figure 13: copying your Key and Secret Step 10 Go back to the webui, enter your Key and Secret, and click Next. Figure 14: Entering your Key and Secret 1-18 LiveNX Upgrade Guide
Click on Yes to activate your license: Step 11 Figure 15: Activating your Cloud License Once your license is activated, the upgrade to LiveNx 7.0.1 has been completed. You will be redirected to the following page showing your license details in the WebUI. Figure 16: License Details in WebUI 1-19 LiveNX Upgrade Guide
Upgrading the Node OVA (Online) This section provides instructions to upgrade the Node OVA to the latest version via the Node Admin UI. This guide is intended for LiveNX 7.0.0 and higher version. CAVEAT: REQUIRED: Step 1 1. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 2. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 2. The Primary DNS must be reachable from the LiveNX Server 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. Figure 1: LiveNX Node console Step 2 Enter username=admin and password=admin, then Click Login Figure 2: Login 1-20 LiveNX Upgrade Guide
Step 3 1. Once Login, click on Update tab 2. Click the Online tab 3. Place the following URL in the empty field: https://download.liveaction.com/livenx/7_0_1/software_package-livenx-node-7.0.1-full.enc 4. Click Start Update 5. Click OK, Once OVA updated successfully. Figure 3: Start Update Figure 4: Updating 1-21 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.0.1 in the console. Node Status should be Running. Figure 5: OVA Updated Successfully 1-22 LiveNX Upgrade Guide
Upgrading the Node OVA (Offline) This section provides instructions to upgrade the Node OVA to the latest version via the Node Admin UI. This guide is intended for LiveNX 7.0.0 and higher version. CAVEAT: REQUIRED: Step 1 3. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 4. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 3. The Primary DNS must be reachable from the LiveNX Server Download the upgrade package. 1. Copy and paste the following URL in a browser to download the package https://download.liveaction.com/livenx/7_0_1/software_package-livenx-node-7.0.1-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. Figure 1: LiveNX Node console Step 3 Enter username=admin and password=admin, then Click Login Figure 2: Login 1-23 LiveNX Upgrade Guide
Step 3 1. Once Login, click on Update tab 2. Click the Offline tab 3. Click Choose File 4. Click Start Update 5. Click OK, Once OVA updated successfully. Figure 3: Start Update Figure 4: Updating 1-24 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.0.1 in the console. Node Status should be Running. Figure 5: OVA Updated Successfully 1-25 LiveNX Upgrade Guide
Upgrading the Node OVA Via Jidoteki Admin UI This section provides instructions to upgrade the Node OVA to the latest version via the Jidoteki Admin UI. This guide is intended for LiveNX 6.2.3 and previous versions. CAVEAT: REQUIRED: Step 1 5. Most of the upgrades require increasing the default 4GB memory to 8GB memory in Custom-flavor (previously named Tiny). 6. Customers with larger deployment such as the Small-flavor (16 GB) and Medium-flavor (32 GB) should not have any issue. See OVA specification for all flavors of OVA Specifications. 4. The Primary DNS must be reachable from the LiveNX Server Download the upgrade package. 2. Copy and paste the following URL in a browser to download the package https://download.liveaction.com/livenx/7_0_1/software_package-livenx-node-7.0.1-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. Figure 1: Obtaining the API token 1-26 LiveNX Upgrade Guide
In a browser, type in https://<node-ova-ip>:8443 Login with your API token 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 1-27 LiveNX Upgrade Guide
d. Status after setting the token a. Status: Changed 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. Step 6 Figure 6: Click on update After clicking on Update, the upgrade process will begin. When it is completed, Status: success will show, and the Node OVA will automatically reboot. 1-28 LiveNX Upgrade Guide
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 Figure 9: LiveNX Node Upgraded Successfully 1-29 LiveNX Upgrade Guide
Step 9 Also, verify the node status on the LiveNX Server Management Console is showing as connected. Figure 10: LiveNX Server Management Console 1-30 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-31 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-32 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-33 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-34 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-35 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 Step 6 When the installer completes, run the Client and login using the same credentials. 1-36 LiveNX Upgrade Guide
1-37 LiveNX Upgrade Guide Figure 6: Client login
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.