You are here:

Update ECX Using Internet Access

The process of applying software patches is called software update or the update process. Use the software update process to upgrade your ECX software with the latest features and enhancements. It is strongly recommended that you run the most current release of ECX to take advantage of the latest functionality including operating system and application support. For the latest system requirements, customer notices, product documentation, and access to the Catalogic Knowledge Base, go to MySupport.

The easiest way to apply updates is to allow the virtual machine access to the Internet, where it can query for updates and download them as needed. Log on to the Administrative Console to update the ECX virtual appliance. Updates are delivered through an online repository, which can be accessed through the Manage Updates page on the Administrative Console.

BEFORE YOU BEGIN:

Install ECX by deploying an OVF template. This creates a virtual machine containing the application on a VMware host such as an ESX or ESXi Server. See Install ECX as a Virtual Appliance.
Perform a VM snapshot of the virtual machine where ECX is deployed prior to the following update procedure.
If updating from ECX 2.5, or updating to a newer version of ECX that was previously updated from ECX 2.5, additional steps are required before updating. On the ECX appliance, navigate to /etc/yum.repos.d/. If the erlang_solutions.repo file is in this location, move the file to /tmp on the appliance before updating.

If Internet access is available and you will apply updates from the default repository, follow the below procedures:

Note: After ECX updates, it cannot rollback to a previous version without a virtual machine snapshot. Create a virtual machine snapshot of your environment before updating, then, if necessary, perform a virtual machine snapshot rollback to return to a previous version of ECX.

When updating ECX through the Administrative Console, a Clean Process Failure message displays during the update process. The message indicates that the update has been applied successfully, but the update cleanup process failed. This message appears consistently when performing an update to ECX, regardless of whether the Clean Process failed or was successful. This issue is resolved in the latest update.

To check for available updates and install them:

From a supported browser, enter the following URL:
https://<HOSTNAME>:8090/
where <HOSTNAME> is the IP address of the virtual machine where the application is deployed.
In the login window, select System from the Authentication Type drop-down menu. Enter your password to access the Administrative Console. The default password is ecxadLG235.
Click Manage updates. ECX checks for updates from the update repository
If an update is available, install the update by clicking Run Update. The update process may take some time to complete depending on the size of the update and the speed of the Internet connection.
Once complete, the virtual machine where the application is deployed automatically reboots.
HTML content from previous versions of ECX may be stored in your browser's cache. Clear your browser's cache before logging in to an updated version of ECX to ensure you are viewing the latest content changes.

To manually update your ECX appliance:

From a machine with internet access, download the necessary updates files from MySupport.
If the update is delivered as a .zip file, unzip the file.
From a supported web browser, access the Administrative Console at the following address:
https://<HOSTNAME>:8090/
where <HOSTNAME> is the IP address of the virtual machine where the application is deployed.
In the login window, select System from the Authentication Type drop-down menu. Enter your password to access the Administrative Console. The default password is ecxadLG235.
Click Manage updates. In the Don't want to update ECX to the latest available release? section, select Click here.
Click Choose File, browse for the update file to upload to the appliance, then click Upload Update Image. The update process begins once the update image has been uploaded to the appliance.
After the update completes, navigate to the Perform System Actions page on the Administrative Console to restart the appliance.
HTML content from previous versions of ECX may be stored in your browser's cache. Clear your browser's cache before logging in to an updated version of ECX to ensure you are viewing the latest content changes.

NEXT STEPS:

If previously cataloged high-level objects, such as those cataloged by a NetApp ONTAP Storage Inventory job, no longer appear in ECX after the update completes, you must re-run your high-level catalog jobs. Jobs and their associated schedules created before the update carry over to the updated version of ECX and will run as scheduled. Existing jobs can also be rescheduled to run after the update completes or can be run manually.
After verifying that the update process was successful and the ECX application is running as expected, you can arrange to have the virtual machine snapshot removed.
The latest OVA for fresh install and updates are available on MySupport.
If the update process fails, encounters an error, or there is any interruption in the update process prior to it completing, review the update logs at the following location on the virtual machine - /opt/vmware/var/log/vami/updatecli.log. See Collect Logs For Troubleshooting.
To reapply the update, revert the virtual machine snapshot, which was created before the update procedure, and then attempt another update.