Upgrading a Sybase WorkSpace Version

Use the installer to upgrade from Sybase WorkSpace 2.0.

Prerequisites

Upgrade of WorkSpace 2.0 to 2.1 has an intermittent problem when installed from the 2.1 installation CDs. During execution, the installer needs to re-load data from the first disk after switching to the second, which leads to errors in the installation. To work around this issue, copy the contents of the CDs to a local hard drive and execute the installation from there.
1. Copy the contents of WorkSpace Disk 1 to a directory on the PC's hard drive.
2. Copy the contents of WorkSpace Disk 2 to the same directory. If prompted, overwrite all files and directories.
3. Execute setup.exe from the hard drive directory.
4. During installation, you will be prompted to Insert CD #2. Click Next on that panel (all CD2 data is already available in the directory).
If you are writing Java and want your project layout in the WorkSpace Navigator to appear similar to the way it did in earlier versions of WorkSpace, you must create a source folder for your source code, typically named src.

Determine the components that you want to install for the current release. See Identify Installation Components.
Obtain the necessary license. See Preinstallation Tasks for SySAM.
Shut down all Sybase products.
Start the Sybase WorkSpace installer as described in Installing Sybase WorkSpace. The installer welcome page appears.
Click Next.
Select the geographic location for your installation of the software. The license agreement appears in the main section of the page. Scroll down to read the text.
Accept the terms of the license, and click Next. The installer detects your previous installation.
Specify to install the upgrade in a new location or to overwrite an existing installation. Overwrite an existing installation is required if you are upgrading from WorkSpace 2.0. New Location – This option is available only if an existing installation for WorkSpace 1.x is detected. You can have multiple Sybase WorkSpace versions, such as 1.7and 2.1 installed on the same machine, but each must be in its own distinct location:
1. Click Next, and select an installation directory.
  - The default directory is C:\Sybase\WorkSpace. Sybase recommends that you use the default directory.
    Note:
    - Use English characters for all directory names.
    - Use single-byte characters for the installation directory path.
    - Use the underscore character instead of hyphens or spaces in the installation directory name.
    - Do not install Sybase WorkSpace in the same directory as Adaptive Server Enterprise 15.0. Specifying the same directory results in errors when deploying services.
  - To specify a directory other than the default, click Browse.
2. Select whether or not to reuse an existing Eclipse or JDK installation. This option is recommended only for advanced users. Click Browse to specify an Eclipse directory or JDK directory other than the default.
  Note: To guarantee compatibility with Eclipse and the JDK, Sybase recommends that you use the versions that installs with Sybase WorkSpace.
3. Click Next. Overwrite Existing – select this option to install over your existing installation: If the specified Sybase WorkSpace installation directory does not exist, you are prompted to confirm creation of this directory before continuing.
4. Click Next. The installer displays the path of the current installation directory.
Click Next, and select a license type.
A dedicated license file is required for unserved and served licenses. If you have not yet generated and downloaded the appropriate license file from the Sybase Product Download Center (SPDC), review the instructions in Preinstallation Tasks for SySAM.
- Trial – allows you to evaluate Sybase WorkSpace for a limited period of time. No license file is required for this license type.
- Unserved (local) License – dedicated standalone seat license managed locally on your machine. Verify that the license file is available on your local machine before proceeding.
- Served (remote) License – dedicated standalone seat license managed from a license server. You must know your license manager host name and license manager TCP port (if other than the default) before proceeding.

Click Next, and provide any requested license information.

Selected license type	Required license information
Trial	No license information is required.
Unserved license	Click Browse to specify the location of the unserved license on your local machine. Click Next.
Served license	Enter the computer on which your license server resides. If your license server uses a port number different from the default number of 27000, enter that port number. Click Next.

Select the features to install for Sybase WorkSpace, and click Next. You identified these features in Identify Installation Components and generated licenses for these features in Preinstallation Tasks for SySAM. If you are rerunning the installer, previously installed features are indicated as installed.
Note: If you choose to install a feature for which you do not have a license, the installation defaults to a trial license for that feature. The installation defaults to a trial license when the license is invalid or cannot be found. After the trial period, these features will no longer function.
Read the summary information for the features you are installing, and click Install. A status bar and checklist report the progress of the installation. Old components are uninstalled before new components are installed.
Select any of the following, and click Next:
- Review the Release Bulletin on the Sybase Product Manuals Web site
- Start Sybase WorkSpace 2.1
- Create Sybase WorkSpace 2.1 shortcut on desktop
When a message appears indicating that Sybase WorkSpace 2.1 has been installed successfully, click Finish.

Next

After performing the upgrade, you must perform these manual steps:

Manually update your user name, password, and port in the Service Container Server Connection Properties.