The App Layering appliance (aka Enterprise Layer Manager) automatically downloads upgrades, but the upgrades are not automatically installed. Instead, you are notified that an upgrade is available, and you are responsible for running the actual update.
The appliance periodically checks for upgrades, and when one is found, downloads the package, verifies it, and extracts the files. Once the package is extracted, you are alerted that there is an upgrade ready.
If you log into the Management Console as Administrator, you can apply an upgrade either by clicking the Start Upgrade button on the notification, or by selecting System tab > Manage Appliance > Upgrade.
Periodically, the appliance checks to see if an upgrade is available. The following sections walk you through common scenarios.
Nothing happens. Another check will be made at the next scheduled interval.
The user will receive a pop-up (see below) to let them know there is an upgrade available, and that the administrator needs to finish configuring a network file share before it can be downloaded and applied.
The Download Upgrade Media job is started, and it is visible in the task list. This job is responsible for:
Downloading the upgrade to local storage.
Ensuring the checksum of the successfully downloaded upgrade package is correct.
Extracting the downloaded upgrade package to the configured Network File Share. The download is extracted to the appliance's File Share:
If at any time during this process an error is encountered that requires Administrator intervention (out of space on local storage, out of space on the network file share, invalid file found, etc.) the job will fail with an appropriate error.
If a job fails it will be retried at the next check interval regardless of whether the Administrator has resolved the fixed.
The new upgrade will be downloaded (see above) and once successfully completed it will become the Upgrade Available.
The running download will be aborted and a new download (as above) will be started. In this case, all files related to the in-progress download will be deleted.
When logging in every user will receive a notification that an upgrade is available. However, only an Administrator will be able to run the upgrade.
The App Layering upgrade package for VMware vSphere is:
The upgrade package includes the files:
Note: An Agent upgrade is only required if you've installed the agent for your implementation, for example, if you are using PVS, or Connector Scripts.
Take a snapshot or checkpoint of the appliance.
Under normal circumstances you will be notified of available updates, and the update package is automatically downloaded. You can, however, check for updates.
As Administrator, you can select a different Upgrade Disk. You can also run the Upgrade "manually" by going to the System tab and selecting the Upgrade action as before. If an upgrade is available, the Upgrade Disk is displayed.
When a non-Administrator logs in, they will see the following pop-up:
A non-Administrator cannot click the Start Upgrade button nor launch the Upgrade wizard. They will need to report the available upgrade to their Administrator.
When using PVS or Elastic Layers the Agent is required. To upgrade the App Layering Agent:
If you are upgrading from 4.0.x to 4.1.0 or later, you can access the App Layering Management Console via the Citrix Cloud, but you'll need a Citrix Cloud Connector to do so. If you don't yet have a Cloud Connector, you can create one as described here. For known issues when accessing the Management Console via the Cloud, see the list of issues below.
Log in to the Citrix Cloud. A Citrix App Layering tile should be displayed at the bottom of the page.
On the Citrix App Layering tile, click Request Trial, and check your email for a message from Citrix Cloud.
In the message you received, click the Sign In button. This returns you to the Cloud.
Click Manage on the App Layering tile. The Citrix App Layering page is displayed.
Get familiar with the service by reading the Overview. When ready, click the Get Started button to open the Getting Started tab.
Under Step 1, click the Get Cloud Connector button, and for instructions click the Documentation link.
Use the Connector documentation to install a Cloud Connector, then return to the Getting Started tab.
Under Step 4, the Documentation link opens the instructions for logging in. (The link below opens the same article.)
Click the Log into Appliance button. This opens the Manage tab. Follow the instructions to access the appliance.
As an App Layering Labs feature (not intended for use in production), you may encounter a few behaviors that are either not optimal or not yet implemented.