On the target server:

1. Install the Vibe 3 software on the target server, as described in Section II, Basic Installation, paying special attention to these important details:

   • Set up the same Linux user to run the Vibe software that has been used to run the Vibe software in the past.

   • Select the same encryption algorithm for the Vibe database.

     IMPORTANT:If the database encryption algorithms do not match between the source and target Vibe systems, you cannot log in to the new Vibe 3 site.

2. Start Vibe on the target server.

3. Verify that the new Vibe site is working as expected.

4. Stop Vibe on the target server.

5. Rename the teaming directory to teaming_backup. This is because in a future step you will copy the teaming directory from the source server to the target server.

   The location of the teaming directory varies by platform:

   Linux:	/var/opt/novell/teaming
   Windows:	c:\novell\teaming

6. (Conditional) If you are migrating a Teaming 2.1 system to a Vibe 3 system, you need to manually change the encryption algorithm in the ssf-ext.properties file:

   1. On the Vibe server that you are migrating from, change to the directory where the ssf-ext.properties file is located.

      The default location of this file varies by platform:

      Linux:	/opt/novell/teaming/apache-tomcat/webapps/                                     ssf/WEB-INF/classes/config
      Windows:	c:\Program Files\Novell\Teaming\apache-tomcat\webapps\                                     ssf\WEB-INF\classes\config

   2. Open the ssf-ext.properties file in a text editor, then locate and copy the appropriate property setting for your encryption algorithm. The encryption algorithm for your Vibe server is represented by one of the following lines:

      user.password.encryption.algorithm=SHA
      

      user.password.encryption.algorithm=SHA-256
      

      user.password.encryption.algorithm=MD5
      

   3. On the Vibe server that you are migrating to, change to the directory where the ssf-ext.properties file is located.

      The default location of this file varies by platform:

      Linux:	/opt/novell/teaming/apache-tomcat/webapps/                                     ssf/WEB-INF/classes/config
      Windows:	c:\Program Files\Novell\Teaming\apache-tomcat\webapps\                                     ssf\WEB-INF\classes\config

   4. Open the ssf-ext.properties file in a text editor, then paste the line that you copied in Step 6.b.

   5. Save and close the ssf-ext.properties file.

7. Continue with Section 21.1.2, Preparing the Source Linux Server.

On the source server:

1. Stop Vibe.

2. Back up your existing database:

   mysqldump -uusername -ppassword sitescape > sitescape.sql
   

   This creates a file named sitescape.sql in the directory where you executed the mysqldump command.

3. Make sure that you have a recent backup of your entire Vibe system.

4. Continue with Section 21.1.3, Transferring Data from the Source Server to the Target Server.

On the source server:

1. Mount the target server to the source server so that data can be copied from one server to the other.

2. In a terminal window on the source server, become the Linux user that runs the Vibe software.

3. Copy the database backup of your existing Vibe database (sitescape.sql file) that you created in Step 2 in Section 21.1.2, Preparing the Source Linux Server to a convenient temporary location on the target server.

4. Copy the entire data area from /var/opt/novell/teaming on the source server to the same location on the target server.

5. Continue with Section 21.1.4, Importing the Vibe Database to the Target Server.

On the target server:

1. Remove the empty Vibe database that was created when you installed the Vibe 3 software:

   mysql>drop database sitescape;
   

2. Change to the directory where you copied the sitescape.sql file in Step 3 in Section 21.1.3, Transferring Data from the Source Server to the Target Server.

3. Create an empty database called sitescape:

   mysql -uusername -ppassword -e "create database sitescape"
   

4. Manually re-create the Vibe database with the data that you copied from the source server:

   mysql -uusername -ppassword sitescape < sitescape.sql
   

5. Continue with Section 21.1.5, Updating the Vibe Database on the Target Server.

This section applies only when you are migrating a Teaming 2.1 server to a Vibe 3 server.

On the target server:

1. Unzip the teaming-3.0.n.zip file, change to the resulting update-2.1.0-3.0.n directory, then run the update script to update the database from Teaming 2.1 to Vibe 3:

   mysql -uusername -ppassword < update-mysql.sql
   

   For more complete database update instructions, refer to Section 20.3.1, Manual Vibe Database Update.

2. Continue with Section 21.1.6, Finalizing Your New Vibe 3 Site.

1. Start Vibe 3, as described in Section 4.1.6, Starting Vibe on Linux.

2. Reindex the Vibe site, as described in Rebuilding the Lucene Index in Site Maintenance in the Novell Vibe OnPrem 3 Administration Guide.

   Your Vibe site should now function just as it did on the original source server.