Note: If you are
using a standard evaluation license, you cannot upgrade to software versions
that are later than your license.
If you are
upgrading from release 5.6, install a new virtual machine rather than upgrading
the existing virtual machine, because resource requirements changed with
release 6.2.0. Release 6.0 and 6.2 virtual machines can be updated with the
CloudBridge release 7.4 binary.
8500, Repeater 8800, Citrix CloudBridge 600, and Citrix CloudBridge 700
software from My Account.
- Installing the Update
Note: If you are upgrading from a pre-6.0 release (such as release
5.3), you must update to release 6.x first, then to release 7.4. Also, if you
are upgrading from a pre-6.0 release, acceleration will not take place until
you install the new license from Citrix.
the browser based user interface (http://appliance_ip_address), go to the
System Maintenance >
Update Software link on the
Configuration tab. In the
Upgrade System Software table, click
Choose File to select the patch file (the file you
downloaded with FTP), and then click
Upload Patch, as shown in the following screen shot.
Figure 1. Update Software
patch file is then copied to your appliance and tested for integrity. If you
have downloaded a valid file, a Restart Unit? prompt appears. Click
settings from your current release are copied to the new one, so your
configuration is retained in the new release. The process of installing the
patch file continues during the restart, which might take several minutes
longer than usual. The new release is now running on your appliance.
Note: If your appliance still uses the old default password, it is
changed to "password" when you install this upgrade.
CloudBridge 400, CloudBridge 800, CloudBridge 2000, CloudBridge 3000,
CloudBridge 4000, and CloudBridge 5000
CloudBridge 400, 800, 2000, 3000, 4000, and 5000 appliances can
be updated to release 7.4 with the following procedure.
procedure is recommended for all CloudBridge 400 and 800, CloudBridge 2000 and
3000 appliances, and for CloudBridge 4000 and 5000 appliances that have already
been configured. Your existing configuration is retained without modification.
update process involves two basic steps:
- If you are not already
running release 7.1.0 or higher, download the release 7.4.0 management service,
then update the management service to release 7.4.0.
- Download and install the
release 7.4.0 upgrade bundle.
versions of the management service and upgrade bundle corresponding to release
7.4 are listed in the
section. These files can be downloaded from My Account.
the #SESS_CORRUPTED error message appears at any time during these procedures,
Logout, clear your browser cache, close your
browser, and open it again.
update the Management Service:
Follow this procedure only if your appliance has a management service from a
than release 7.1.
In this procedure,
refers to the
Configuration menu of a CloudBridge 4000 or
CloudBridge 5000 appliance and the
menu of a CloudBridge
2000 or CloudBridge 3000 appliance.
- Update the management
service. On the
Upload and select and upload the new management
service from the dialog box.
- On the
Upgrade Management Service. Select the management
service image you just uploaded, and then click
OK. The management service is upgraded. The UI
becomes unresponsive during this process.
- Clear your browser cache.
- Once the new management
service is installed, the UI starts responding again and takes you to the logon
page. Log on. Go to the
page and verify that the
current version of the management service matches the version you intended to
the pages display a
Detected warning message, it just means that you need to install the
upgrade bundle. Ignore the Recommendations in the warning and install the
upgrade bundle, as described below.
update the appliance
- If your appliance is not
yet running Release 7.1.0 or later, upload and install the management service
for the target release before continuing.
- Acquire the update file. If
you log on to citrix.com with your My Account credentials, the CloudBridge
software is available in the Downloads section. The upgrade file has a .upg
extension and is several hundred megabytes long. Download the file to a
convenient system. To minimize transfer time, this system should be in the same
facility as the appliance and have a fast link to it (Gigabit Ethernet rather
than 54 Mbps wireless).
- Log on to the appliance and
navigate to the
- Click the
Update Software link.
- In the text box that
appears, specify the upgrade file, and then click
- When a message announces
that the upload was successful, click
- The appliance performs the
upgrade, which takes about half an hour. It displays a series of status
messages, starting with “Preparing to upgrade” and ending with “Upgrade
OK to display the updated user interface. Clear your
browser cache to ensure successful operation.
- If there is no
Update Software link, you are using an earlier
version of the management service. Update the management service to release
7.4, and then run the update process.
- If the graphical user
interface seems dysfunctional after the update, clear your browser cache. You
might also need to wait for all features to initialize.
- The update process is a
post-provisioning process. It does not function properly on a new system or
after a factory reset if you run it before running the Configuration Wizard.
- The update process can
fail for a variety of reasons, including a corrupted or truncated update file,
an appliance using versions that are not in its supported range, and other
issues. If the update process fails, it displays an error message.
- If you need to run the
update process again, you must upload the update file again.
- Citrix CloudBridge 700 series
upgrade a Citrix CloudBridge 700 appliance, see the
Citrix Branch Repeater
with Windows Server User's Guide, release 3.0, chapter 3.
- Troubleshooting Installation Related Issues
clockface showing the estimated update time is not always 100% accurate. If the
installation ends with an error page displaying some kind of HTTP timeout
error, wait a few minutes, and then attempt to connect normally to the browser
based management interface of the appliance. Doing so usually shows that the
newly installed version is up and running.
Sometimes an update fails if it spans a large number of
releases, such as a jump from release 4.x to 6.0. If this happens, installing
an intermediate release first (for example, release 5.5) and upgrading in two
steps usually works.
Contact Citrix Support with any installation issues.
- Troubleshooting Installation Related Issues for Citrix
CloudBridge VPX for Amazon
information about troubleshooting installation related issues for Citrix
CloudBridge VPX for Amazon, see
WAN Optimization for