You are here: Setup > Maintenance > Update ECX Using a CD

Update ECX Using a CD

The process of applying software patches is called software update. 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. This may not be possible for some security conscious organizations. In this case, a CD update procedure is provided.

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.
Use Check Updates to verify a valid CD containing updates is available and confirms the version of the update. See To check for available updates and install them:.
Perform a VM snapshot of the virtual machine where ECX is deployed prior to the following update procedure.
This topic describes the update process if you do not have Internet access. If you do have Internet access, see Update ECX Using Internet Access.

If Internet access is not available and you will apply updates from a downloaded ISO image or a CD, follow the below procedure:

To prepare for the CD update:

The default configuration of the deployed virtual machine does not include a virtual CD device. Use the following procedure to prepare for the CD update.

Download the ECX update ISO image from MySupport.
Choose a time when ECX is not running important Catalog operations, then use the Shutdown procedure to halt the virtual machine.
In vSphere, right-click the ECX virtual machine and select Edit Settings. The Virtual Machine Properties window opens.
Adjust the VM settings. Click Add > CD/DVD Drive. Click Next.

Select Use Physical Drive. Click Next.
Select Device Location > Client. Click Next.
Select the default for the Virtual Device Node, this is usually IDE (0:0). Click Next.
Click Finish.

Once the Add Device Wizard is finished, click OK to apply the VM settings.
Power the VM back up. It can take a few minutes for the machine to boot up and initialize all the application interfaces.
Once the virtual machine is booted, use vSphere to attach the ISO image to the VM. The ISO image can either be on the workstation where vSphere is running or copied to a datastore, which is already available to the ESX host. Use the vSphere ISO attachment functions Connect to ISO image on local disk or Connect to ISO image on datastore, respectively.

Tip: Sometimes shutting down or rebooting a VM disconnects it from an attached ISO image. It is a good practice to boot the VM first and then attach the ISO as instructed above.

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.

To enter your update repository credentials:

From a supported browser, enter the following URL:
https://<HOSTNAME>:5480/
where <HOSTNAME> is the IP address of the virtual machine where the application is deployed.
In the login window, enter your user name and password to access the virtual machine management console. The default user name is administrator and the default password is ecxadLG235.
Click the Update tab and then click the Settings tab. Keep Automatic Updates set to No automatic updates. In the Update Repository section, select Use CDROM Updates.
Click Save Settings.

To check for available updates and install them:

Click the Update tab and then click the Status tab.
Click Check Updates to check for updates from the update repository.
If updates are available, click Install Updates. 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.

NEXT STEPS:

If previously cataloged high-level objects, such as those cataloged by a NetApp Catalog Data policy, no longer appear in ECX after the update completes, you must re-run your high-level catalog policies. Policies and their associated schedules created before the update carry over to the updated version of ECX and will run as scheduled. Existing policies 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.
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.
The latest OVA for a 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.
Detach the update ISO and discard it.