Citrix Synchronizer for XenClient v1.0 RC2 Upgrade Guide

COPYRIGHT(c)2010 Citrix All Rights Reserved
Version: Release Candidate 2

Citrix, Inc.
851 West Cypress Creek Road
Fort Lauderdale, FL 33309
United States of America

Disclaimers.
This document is furnished "AS IS." Citrix, Inc. disclaims all warranties
regarding the contents of this document, including, but not limited to, 
implied warranties of merchantability and fitness for any particular 
purpose. This document may contain technical or other inaccuracies or
typographical errors. Citrix, Inc. reserves the right to revise the 
information in this document at any time without notice. This document 
and the software described in this document constitute confidential 
information of Citrix, Inc. and its licensors, and are furnished under a 
license from Citrix, Inc.

Citrix Systems, Inc., the Citrix logo, Citrix XenClient, are trademarks 
of Citrix Systems, Inc. in the United States and other countries. All 
other products or services mentioned in this document are trademarks or 
registered trademarks of their respective companies.

Trademarks. 
Citrix(R)
XenClient(TM)


CONTENTS
========

1. Introduction
2. Upgrade instructions
2.1 Downloading the upgrade package
2.2 Installing the upgrade package


1. INTRODUCTION
===============

This README document lists the steps required for an in place upgrade of
Citrix Synchronizer for XenClient v1.0 RC to Citrix Synchronizer for 
XenClient v1.0 RC2. For information on installation of the Citrix 
Synchronizer for XenClient, please download the Citrix Synchronizer 1.0 
RC2 Administration Guide from the Citrix Knowledge Center at 
http://support.citrix.com/product/xc.

2. UPGRADE INSTRUCTIONS
=======================

A previous installation of Synchronizer v1.0 RC can be upgraded in place 
to preserve an existing configuration and data (including user/group, 
Active Directory, certificate, network settings, and VM image data). The 
process for the upgrade is two steps:

a. Download the upgrade script from citrix.com into the Synchronizer
virtual appliance server
b. Run the upgrade script from the Synchronizer virtual appliance 
server command line

It is important that, if possible, you first take a snapshot of your 
Synchronizer virtual appliance using XenCenter. Please refer to your 
XenServer Administration Guide for instructions on how to do so.

2.1 DOWNLOADING THE UPGRADE PACKAGE
===================================

The upgrade package is a zip file that can be downloaded from 
http://www.citrix.com/xenclient/pkg/upgradesynchronizerv1rc2.  The 
download can either be done directly onto the Synchronizer virtual 
appliance server, or to another location.  If downloaded to another 
location, an administrator will have to manually copy the upgrade zip 
package to the Synchronizer.

Option 1: Download to another location
--------------------------------------

Step 1. Download the Synchronizer RC2 upgrade package to a location 
which has SSH enabled
Step 2. Log into the Synchronizer command prompt using local command
line administrator account (usually root)
Step 3. Run an SCP command to the downloaded location to securely copy 
the upgrade package to the Synchronizer 

scp [[user@]host1:]<path to Synchronizer_v1_0_RC2_upgrade.zip> Synchronizer_v1_0_RC2_upgrade.zip

Option 2: Download directly onto Synchronizer
---------------------------------------------

Step 1. Log into the Synchronizer command prompt using local command line 
administrator account (usually root)
Step 2. Copy and paste the command below onto the command prompt:

python -m urllib http://www.citrix.com/xenclient/pkg/upgradesynchronizerv1rc2 > Synchronizer_v1_0_RC2_upgrade.zip


2.2 INSTALLING THE UPGRADE PACKAGE
==================================

Once the upgrade package has been copied or downloaded to the 
Synchronizer virtual appliance server, the following steps need to be run 
to install the upgrade.

Step 1. Log into the Synchronizer command prompt using local command line 
administrator account (usually root)
Step 2. Unzip the upgrade package

unzip Synchronizer_v1_0_RC2_upgrade.zip

Step 3. If possible, it is important that you take a snapshot of your 
Synchronizer virtual appliance before proceeding further.  Please refer 
to your XenServer Administration Guide for instructions on how to do so.
Step 4. Run the unzipped upgrade.sh script, and follow prompts.

chmod +x upgrade.sh
./upgrade.sh

Step 5. Once completed, run the upgrade patch to allow Dynamic Image mode 
in the Synchronizer.

chmod +x upgrade-patch.sh
./upgrade-patch.sh