LIVEACTION, INC. LiveNX Upgrade Guide from v5.2.0 to v5.2.1 UPGRADE LiveAction, Inc. 3500 Copyright WEST BAYSHORE 2016 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.
Upgrading from v5.2.0 to v5.2.1 The Upgrade Guide from v5.2.0 to v5.2.1 consists of the following: 1. Export Devices (Mandatory) 2. Backup Server Configurations (Mandatory) 3. Upgrading the LiveNX Server (Mandatory) a. Windows b. Linux 4. Upgrading the LiveNX Node (If applicable) The LiveNX Node is an optional LiveAction component. It used to provide additional collection and processing capabilities in networks with large devices. It is available in LiveAction releases 4.0 and higher. a. Windows b. Linux 5. Upgrading the LiveNX Client (Mandatory) a. Windows b. Mac 6. Upgrading the LiveNX Client via the Java WebUI (Optional) 7. Upgrading the LiveNX Platform OVA (If applicable) 8. Verification (Recommended) NOTES: As of the 5.0 release, the LiveAction Software has been renamed to LiveNX Customers upgrading from v5.2.0 to v5.2.1 will NOT require a new license to support the new software 1-1 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Export Devices Step 1 With the Client running, choose File > Export Devices Step 2 Figure 1: Export Devices A window will pop up with a list of all of your devices. Click Export to CSV. Enter the filename and select Export. Step 3 Shutdown the Client by selecting File > Exit. 1-2 LiveNX Upgrade Guide from 5.2.0 to 5.2.1 Figure 2: Name and location for the Exported Devices
Backup Server Configurations Step 1 Open the LiveAction Server Management Console and go to the Properties tab. Find the location of app.datadir. Note this as you will need to provide the same path for the upgrade installation. Also note the IP address of the remoting.server.hostname. Figure 1a: Properties tab of the LiveAction Server Management Console Figure 1b: Properties tab > remoting.server.hostname 1-3 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 2 Now, let s create a backup of your configuration. Click on Manage > Export Configuration to export the current configuration. This export configuration step is for backup purposes only. If you wish to bypass this backup step or if you want to start the Server with the factory defaults, please skip to Step 5: Step 3 Figure 2: Export Configuration During the export process, the Server will be temporarily disabled. Click Yes to continue. 1-4 LiveNX Upgrade Guide from 5.2.0 to 5.2.1 Figure 3: Export Warning
Step 4 The Export Configuration window will pop up. Click Browse to specify a location for your LiveNX configuration file. If you want the configuration file to be password protected, click on Encrypt, then enter a password and then re-enter to confirm. Click Export to export the configuration file. Step 5 Enter the name for the configuration file and click Save Figure 4: Export Configuration Window Figure 5: Name and Location for Configuration File 1-5 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 6 Shut down the Server by clicking on Manage > Shutdown Service. This may take a few minutes. Once the Server is shut down, click on OK and then exit the LiveNX application by clicking on Manage > Exit. Figure 6: Confirmation of Server Shutdown 1-6 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Server for Windows Step 1 Uninstall the Server by using the Start > All Programs > LiveAction Server 5.2> LiveAction Server Uninstaller or by locating the uninstall.exe located in the LiveAction Server 5.2 folder on your hard drive. Default is C:\Program Files\LiveAction Server 5.2 Figure 1: Server Uninstaller via Start Shortcut Step 2 Click on Next to confirm the uninstallation procedure. Figure 2: Server Uninstall Wizard NOTE: The LiveNX Server Data will not be removed by uninstalling the Server. 1-7 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 Install the Server by double clicking on LiveActionServer_windows-x64_5_2_1_setup.exe. Click Next at the Setup Wizard screen. Step 4 Figure 3: Install the Server Choose the Server installation location. The installer defaults to the most recent major release version; use the Browse button to select another location. Click Next. Figure 4: Server Installation Directory 1-8 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 5 If you wish to continue to use your topology and historical data stored from your previous Server installation, then point your data directory at the location you noted in Step 1: Backup Server Configuration. Figure 5: Server Data Directory Location Step 6 Provide your Server s IP Address. Figure 6: Server IP Address 1-9 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 7 Select the desired maximum memory allocation for your Server. The selection is based on the number of devices in your network. Default is 4GB. Figure 7: Server Memory Configuration Step 8 If desired, select and name a Start Menu folder. Then, select either Automatic or Manual service start-up option. Default is Automatic. After clicking Next in the server start-up option, the installation will begin. 1-10 LiveNX Upgrade Guide from 5.2.0 to 5.2.1 Figure 8: Server Installation Complete
Step 9 Click on Finish to automatically start the Server or uncheck the Launch checkbox and click on Finish to start the Server at a later time. The checkbox default is enabled. Figure 9: Completing the Server Setup Wizard 1-11 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 10 Start the Server by clicking on Manage > Start Service. Step 11 Figure 10: Start Service in Management Console When the Server status LED turns green with The server is currently running, then your Server is upgraded to 5.2.1. Figure 11: Server Upgrade Complete 1-12 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Server for Linux The Linux version of the LiveNX Server is packaged as an RPM and is distributed as a self-contained shell script (.sh) file with the RPM package embedded in it. Currently, installation must be handled by the root user or a non-root user that has used the su or sudo command to gain root privileges. The file needs to be copied onto the Linux computer. Step 1 The management console must also be run using root. A warning message will be displayed if the management console is run by a non-root user. The following script will launch the management console: /opt/liveactionserver/5.2/lamanagementconsole Figure 1: Script to launch the Server Management Console Step 2 Open the LiveAction Server Management Console and go to the Properties tab. Find the location of app.datadir. Note this as you will need to provide the same path for the upgrade installation. Figure 2a: Properties tab of the Server Management Console 1-13 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Also note the IP address of the remoting.server.hostname for use in Step 5. Figure 2b: Properties tab > remoting.server.hostname Make sure to stop the service before uninstalling. Click on Manage > Shutdown Service, then go to Manage > Exit Figure 2c: Stop Service on the Server Management Console 1-14 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 Uninstall the previous Server installation by opening a Terminal and logging in as root. To uninstall, type rpm -qa grep LiveAction to return the package name. Then type rpm -e LiveAction_package_name. In this example, rpm e LiveActionServer-5.2-1.i386 Figure 3: Server Uninstaller via Terminal NOTE: The LiveAction Server Data will not be removed by uninstalling the Server. Step 4 Install the LiveNX Server software LiveNXServer-5.2-1-1.x86_64.sh. It is packaged as an RPM and is distributed as a self-contained shell script (.sh) file with the RPM package embedded in it. Currently, installation must be handled by the root user or a non-root user that has used the su or sudo command to gain root privileges. This example assumes that the.sh package is loaded on the desktop. To install, open a Terminal and type chmod +x LiveNXServer-5.2-1-1.x86_64.sh. Figure 4a: Change the Server s permission to execute Then type sudo./ LiveNXServer-5.2-1-1.x86_64.sh Figure 4b: Install the Server 1-15 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 5 Enter your Server s IP Address: Figure 5: Server IP Address Step 6 Enter your Server data directory. This could be found in Step 2: Upgrading the LiveNX Server. Figure 6a: Server Data Directory on the Console This is the directory containing your most recent Server configuration and data. This example assumes that your Server Data Directory is in 5.2. Ensure that you provide the complete path of the directory. The default path is /var/liveaction/data/5.2. Figure 6b: Server Data Directory. 1-16 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 7 Type /opt/liveactionnode/5.2.1/lamanagementconsole to start the Server Management Console: Figure 7: Server Management Console Startup Step 8 Start the Server by clicking on Manage > Start Service. Figure 8: Start Service in Management Console 1-17 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 9 When the server status LED turns green with The server is currently running, then your Server is upgraded to 5.2.1. Figure 9: Server Upgrade Complete 1-18 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Node for Windows Skip this section if you do not have any LiveNX nodes in your configuration. Nodes are used by LiveAction to provide additional collection and processing capabilities in networks with a large number of devices. The nodes run on Linux or Windows O/S and communicate to the central LiveNX Server. Installation of the Windows based Node software is very similar to the Windows based LiveNX Server software installation. Step 1 Open the LiveAction Node Console and go to the Properties tab. Find the location of app.datadir, you will need to provide the same path below for the upgrade installation. Figure 1: Properties tab on Node Console 1-19 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 2 Open the Node and stop the service by clicking on Manage > Stop Service. Click on Yes when asked if you want to shut down the Node service. Step 3 Figure 2: Stop Service on the Node Uninstall the Node by using the Start > All Programs > LiveAction Node 5.2 > LiveAction Node Uninstaller or by locating the uninstall.exe located in the LiveAction Node 5.2 folder on your hard drive. Default is C:\Program Files\LiveAction Node 5.2. Figure 3: Uninstall Node Package 1-20 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 4 Install the Node by double clicking on LiveNXNode_windows-x64_5_2_1_setup.exe. Click Next at the Setup Wizard screen. Step 5 Figure 4: Node Package Installation Choose the Node installation location. The installer defaults to the most recent major release version; use the Browse button to select another location. Click Next. Figure 5: Node Installation Directory 1-21 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 6 Enter your Node data directory. This could be found in Step 1: Upgrading the LiveNX Node. This is the directory containing your most recent LiveNX Node configuration, data and connection file. This example assumes that your Node data directory is in 5.2. Ensure that you provide the complete path of the directory. The default path is C:\LiveAction Node Data\5.2 Since your Node connection file is stored in this directory, you do not need to re-add the Node connection file to the system. Step 7 Enter your Node and Server IP address. Figure 6a: Node Data Directory 1-22 LiveNX Upgrade Guide from 5.2.0 to 5.2.1 Figure 7: Node and Server IP addresses
Step 8 Select the desired maximum memory allocation for your Node. The selection is based on the number of devices in your network. Default is 4GB. Figure 8: Node Memory Allocation 1-23 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 9 If desired, select and name the Start Menu folder. Then, select either Automatic or Manual service start-up option. Default is Automatic. After clicking Next in the server start-up option, the installation will begin. Figure 9a: Creating a Start Menu Folder for the Node Figure 9b: Completing the Node Setup 1-24 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 10 On the Node Console, go to the Manage > Start Service. When complete, a green LED appears in the bottom of the Node Console with Node is currently running. Verify that the Node Name and the Node ID on the LiveNX Node Console matches the Node Name and Node ID in the Nodes tab of the LiveNX Server Management Console. Figure 10a: Start Service in the Node Console Figure 10b: Node status after Start Service 1-25 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 11 Verify that the Node status in the Server Management Console is connected. The Node upgrade is complete. Figure 11: Server Management Console - Nodes Tab 1-26 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Node for Linux Skip this section if you do not have any LiveNX Nodes in your configuration. Nodes are used by LiveAction to provide additional collection and processing capabilities in networks with a large number of devices. The nodes run on Linux or Windows O/S and communicate to the central LiveNX server. Step 1 Open the LiveAction Node Console and go to the Properties tab. Find the location of app.datadir, you will need to provide the same path below for the upgrade installation. Step 2 Figure 1: Properties tab on Node Console Open the Node Console and stop the service by clicking on Manage > Stop Service. Click on Yes when asked if you want to shut down the Node service. Figure 2: Stop Service on the Node 1-27 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 Uninstall the previous Node installation by logging in as root user and opening a Terminal. To uninstall, type rpm qa grep LiveAction to return the package name. Then type rpm e LiveAction_package_name. In this example, rpm e LiveActionNode-5.2-1.i386. Figure 3: Uninstall Node Package Step 4 Install the LiveNX Node software LiveNXNode-5.2-1-1.x86_64.sh. It is packaged as an RPM and is distributed as a self-contained shell script (.sh) file with the RPM package embedded in it. Currently, installation must be handled by the root user or a non-root user that has used the su or sudo command to gain root privileges. This example assumes that the.sh package is loaded on the desktop. To install, type chmod +x LiveNXNode-5.2-1-1.x86_64.sh. Then type./ LiveNXNode-5.2-1-1.x86_64.sh Figure 4: LiveAction Node Package Installation 1-28 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 5 Enter your Node and Server IP address. Figure 5: Node and Server IP Address Specification Step 6 Enter your Node data directory. This could be found in Step 1: Upgrading the LiveNX Node. Figure 6a: Node Console Data Directory This is the directory containing your most recent LiveNX Node configuration, data and node connection file. This example assumes that your Node data directory is in 5.2. Ensure that you provide the complete path of the directory. The default path is /var/liveaction/data/5.2. Since your Node connection file is stored in this directory, you do not need to re-add this Node to the system. 1-29 LiveNX Upgrade Guide from 5.2.0 to 5.2.1 Figure 6b: Node Package Installation Complete
Step 7 Type /opt/liveactionnode/5.2.1/lanodemanagementconsole to start the LiveNX Node Console. Figure 7: Node Management Console Startup Step 8 On the Node Console, go to the Manage > Start Service. When complete, a green LED appears in the bottom of the Node Console with Node is currently running. Verify that the Node Name and the Node ID on the Node Console matches the Node Name and Node ID in the Nodes tab of the Server Management Console. Figure 8: Node Upgrade Complete 1-30 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 9 Verify that the Node status in the Server Management Console is connected. The Node upgrade is complete. Figure 9: Server Management Console - Nodes Tab 1-31 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Client for Windows The Client can be installed by following a similar process as installing the Server or by using a web based installer. Details on the installation procedure using the Client installer can be found in the LiveNX User Guide Chapter 2: Installation. 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 LiveActionClient_windows-x64_5_2_1_setup.exe. The first page of the Wizard is shown below. Select the Next button. Figure 2: Windows Client Install Welcome Page 1-32 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 Proceed to the Destination Directory Page. We recommend that you accept the default file location, unless you will be running 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-33 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
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-34 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the LiveNX Client for Mac 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 Move to Trash. Figure 1: Uninstalling the Client Step 2 Install the LiveNX Client by opening the LiveNXClient_macos_5_2_1_setup.dmg file. Run the Client installer and follow the installation wizard: Figure 2: Installation wizard 1-35 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 Proceed to the Destination Directory Page. We recommend that you accept the default file location unless you will be running 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. Figure 4: Select Additional Tasks Create a desktop icon 1-36 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 5 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. Figure 6: Client login 1-37 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the Client via the Java WebUI (Optional) NOTE: The Client application installation requires admin rights. Step 1 Type http://<liveactionserver IP Address>:<httpserver.port> in your browser. In this example, the Client is being installed on the same machine as the LiveNX Server, so localhost can be used in place of the Server IP address. The httpserver.port is using the default value, 8092. To enable secure web login, click on the httpserver.secure entry in the Properties tab of the Server Management Console, and select True. Type https://<liveaction Server IP Address:<httpserver.port>. Additional details for the httpserver.port and the httpserver.secure configurations are shown in Chapter 2 of the LiveNX User Guide. Click on the Launch Client in the header bar at the top of the web page or click on Launch LiveAction Client text in the body of the web page. Figure 1: Client Web Install 1-38 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 2 Click Run in the Do you want to run this application? dialog box. Step 3 Figure 2: Client Security Warning After upgrading, the Client may fail to start for users who have an older version of Client cached on their computer. To resolve this issue, remove the older client from Java s download cache. On Windows, this can be done as follows. 1. Click on Start, then All Programs. 2. Click on Java, then Configure Java to open the Java Control Panel. 3. On the General tab, under the Temporary Internet Files heading, click the View button. The Java Cache Viewer should appear. 4. In the Show dropdown at the top of the window, select Applications. 5. In the application list, highlight all instances of LiveAction Client and click on the X button to remove these applications from the cache. 6. Dismiss the cache viewer and control panel, and go back to Step 1: to launch the Client again. Figure 3: Java Cache Viewer 1-39 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 4 Enter your credentials to log in to the Client. The Client will use your log in credentials to load your most recent saved Client configuration or choose Username: admin and Password: admin if this is a first time user. Click on OK to start the Client. Your Client upgrade is now complete. Step 5 Figure 4: Client Login (Optional) If you wish to use an existing exported configuration or if the upgrade did not save your previous configuration, go to the Server Management Console and import your saved configuration by clicking on Manage > Import Configurations. Use the Browse button to locate your previously exported configuration file and click on Import. The Server will need to be restarted. Figure 5: Importing Saved Configurations 1-40 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Upgrading the Platform OVA from v5.2.0 to v5.2.1 This guide provides instructions to upgrade the Platform OVA to the latest version via the Web UI. Step 1 Browse to the IP Address https://<platform_ova_ip> of the 5.2.0 Platform OVA. The IP Address may be found by opening the Console view of the Platform OVA in ESXi. Figure 1: Platform OVA console Step 2 Then login and select the gear icon in the upper right corner: Figure 2: LiveNX Dashboard 1-41 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 3 On the About page, click Update Virtual Appliance: Figure 3: About page on the Platform OVA Step 4 Delete the auto-populated URL and replace the existing URL with the following: https://download.liveaction.com/livenx/5_2_1/software_package-v1.6.3.asc Figure 4: Update Virtual Appliance replacing the existing URL 1-42 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Step 5 The Platform OVA will pull down the update and provide a status bar. When the update has completed, please refresh the page and login once more. Then, go back to the About page to verify that the version has updated to 5.2.1. Figure 5: Status of the Platform OVA, after applying the update *The progress bar may appear to hang at 95%. If this behavior is encountered, the page will refresh on its own and return to the login prompt within a few minutes. 1-43 LiveNX Upgrade Guide from 5.2.0 to 5.2.1
Verification (Recommended) Once the Client, the Server and the Node are upgraded, login to the Client and verify that all of 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 2016 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.