20.3 Updating a Single-Server Teaming System from 1.0 to 2.1

When you update a single-server Novell Teaming installation from version 1.0 to version 2.1, the Teaming 2.1 Installation program can perform the entire update in a single process, unless the Teaming system uses an Oracle database.

  1. Stop Teaming.

  2. (Conditional) If your Teaming system uses an Oracle database, update the database as described in Section 20.3.1, Updating an Oracle Database from 1.0 to 2.1 before running the Teaming 2.1 Installation program.

  3. Copy the installer.xml file from the directory where the Teaming 1.0 Installation program is located to the directory where you have extracted the Teaming 2.1 software.

  4. Remove old license file from your Teaming 1.0 system and make sure that you have a license-key.xml file in the same directory with the Teaming 2.1 Installation program.

  5. Start the Teaming 2.1 Installation program.

    If you need assistance with this task, see the detailed installation instructions for the platform where you are updating Teaming:

  6. Accept the License Agreement, then click Next.

    Because you provided your Teaming 1.0 installer.xml file in the directory with the Teaming 2.1 Installation program, the Update software and settings installation option is selected by default.

  7. Click Next to continue.

  8. Click Yes to let the Installation program know that you have stopped Teaming.

  9. Select the check box to let the Installation program know that you have backed up all of your Teaming data, then click Next.

  10. Select Basic or Advanced, depending on the type of Teaming installation you are updating, then click Next.

  11. Continue through the installation process, using the configuration information gathered on the Teaming Installation Summary Sheet.

  12. Click Install when you are ready to perform the update.

    The Installation program might seem to pause at this point. It needs to update tables and indexes in the Teaming database. If you have a large database, this process can be time-consuming.

  13. Click Finish when the update is completed.

  14. Start Teaming 2.1.

    Linux:

    New command: 

    /etc/init.d/teaming start

    For more information, see Section 4.1.5, Starting Teaming on Linux.

    Windows:

    Same command, different directory: 

    c:\Program Files\Novell\Teaming\apache-tomcat-version\
                                                bin\startup.bat

    NOTE:The default locations for Teaming 2.1 are different from 1.0, as listed in Section 3.2.4, Teaming Installation Locations, but the Teaming Installation program does not move the Teaming installation as part of the update process.

    For more information, see Section 4.2.3, Running Teaming as a Windows Service and Section 4.2.4, Running Teaming as a Windows Application.

    When you start Teaming 2.1 for the first time after the update, it takes longer to start than usual because data in the Teaming database must be updated before the Teaming site is ready to use.

20.3.1 Updating an Oracle Database from 1.0 to 2.1

The Novell Teaming Installation program can update MySQL and Microsoft SQL databases as part of the Teaming software update, but it cannot update an Oracle database. Therefore, if you are using Oracle, you must manually run the Teaming 2.1 database update scripts after you have stopped Teaming.

  1. Change to the directory where the Teaming 2.1 Installation program is located.

  2. Unzip the teaming-2.1.n-sql.zip file to create the update-1.0.0-2.0.n directory and the update-2.0.0-2.1.n directory.

    These directories contains an update script for each type of database (MySQL, Microsoft SQL, and Oracle).

  3. Change to the update-1.0.0-2.0.n directory.

  4. Run the update-oracle.sql script to update the database structure from 1.0 to 2.0.

    sqlplus "/ as sysdba"
SQL>spool update-oracle.out;
SQL>@update-oracle;
SQL>quit;

  5. Change to the update-2.0.0-2.1.n directory.

  6. Run the update-oracle.sql script to update the database structure from 2.0 to 2.1.

    sqlplus "/ as sysdba"
SQL>spool update-oracle.out;
SQL>@update-oracle;
SQL>quit;

  7. Return to Section 20.3, Updating a Single-Server Teaming System from 1.0 to 2.1.