编辑“Kablink Team/升级”

{{Kablink Team top}}
== Kablink Teaming 2.0升级到2.1 ==
=== 升级后的相关更新 ===
Kablink Teaming从2.0升级到2.1后，Teaming系统的以下一个方面将得到改进：
*Teaming软件的版本信息从2.0更新为2.1；
*Teaming的[[数据库]]在升级后会拥有一个全新的结构，用来支持Teaming2.1系统的新增功能；
*已经存在的Teaming安装信息的备份文件将会新建在下面目录下：/opt/[[novell]]/teaming/teaming-backup；
=== 单一服务器环境下的升级 ===
即Teaming系统的所有组件均安装在同一个服务器[[主机]]上，如果Teaming系统使用的是除Oracle之外的数据库[[软件]]的话，那么只需要进行一次升级过程即可：
#首先确保你已经将现存的Teaming2.0系统的数据备份完全；
#停止运行Teaming系统；
#如果teaming系统使用的是[[Oracle]]数据库，请先升级数据库，次升级过程将在下文描述，如果使用的不是Oracle，则可跳过此步；
#将Teaming2.0安装目录下的installer.[[xml]]和license-key.xml文件复制到Teaming 2.1下载解压所在的目录下（installer.xml文件会在你运行Teaming2.1安装程序时提供默认信息，可以修改，license文件可以完全不经修改地运用于Teaming 2.1）；
#启动Teaming 2.1安装程序；
#接受许可证协议后，点击Next；
#因为Teaming 2.0的文件已经存在于 Teaming 2.1的安装目录下，所以此时默认的选项不是“New installation”而是“Update software and settings（更新软件和设置）”，点击Next，继续；
#点击“Yes”，让安装程序知道你已经关闭了Teaming 2.0系统；
#选中“复选框 ”，让安装程序知道你已经备份了Teaming系统的所有数据，然后点击Next；
#选择“Basic”或者是“Advance”，点击Next；
#根据Teaming 2.1系统的需求，来更改相关配置信息；
#配置信息更新完成后，点击“Install”，进行升级更新（此安装过程花费的时间较长，因为需要修改Teaming数据库中的表以及索引）；
#升级完成后，点击“Finish”按钮；
#启动Teaming 2.1，启动的方法与Teaming 2.0相同；
=== Oracle数据库的升级 ===
Kablink Teaming 2.1的安装程序在升级Teaming软件的同时升级[[MySQL]]和Microsoft [[SQL]]，但是不能同时升级Oracle，所以，如果Teaming系统使用是Oracle数据库的话，我们需要人工运行Teaming 2.1数据库升级脚本，升级前需要关闭Teaming系统：
#切换到Teaming 2.1安装程序的所在目录；
#将teaming -2.1.n-sql.zip文件解压到update-2.0.0-2.1.n目录下，该目录下包含了每一个类型数据库的升级脚本，包括Oracle的；
#运行update-oracle.sql脚本，更新数据库的结构，更新完成后，即可回到“单一服务器环境下的升级”中的步骤中去；
  sqlplus "/ as sysdba"
  SQL>spool update-oracle.out;
  SQL>@update-oracle;
  SQL>quit;
=== 多服务器环境下的升级 ===
如果Kablink Teaming 2.0系统分布在多个服务器上，Teaming 2.1安装程序可以升级更新Teaming服务器上的Teaming组件，而其他远程服务器上的Teaming组件则需要我们手动升级。
*'''手动升级Teaming数据库:'''
*#停止运行Teaming；
*#切换到Teaming 2.1安装程序的所在目录；
*#将teaming -2.1.n-sql.zip文件解压到update-2.0.0-2.1.n目录下，该目录下包含了每一个类型数据库的升级脚本；
*#复制当前使用的数据库的升级脚本到Teaming数据库所在的服务器中；
*#使用数据库的[[客户端]]工具，运行脚本：
 '''MySQL: '''          mysql -uusername -ppassword < /path/update-mysql.sql
 '''Microsoft SQL:'''   osql -Uusername -Ppassword -i update-sqlserver.sql 
 '''Oracle: '''         sqlplus "/ as sysdba"
                        SQL>spool update-oracle.out;
                        SQL>@update-oracle
                        SQL>quit;
*'''手动升级Lucene Index Server:'''
*#停止运行Teaming；
*#停止运行Lucene Index Server；
*#将Teaming 2.1安装程序所在目录下的Teaming 2.1 Remote Lucene Server安装程序复制到lucene Index Server所在服务器的某一方便的目录下，Remote Lucene Server安装程序的名字随着所在系统平台的不同而不同：[[Linux]] 称lucene-installer.linux，[[windows]]称lucene-installer.exe
*#启动Teaming 2.1 Remote Lucene Server安装程序；
*#接受许可证信息，点击Next（服务器上存在的Teaming 2.0的license-key.xml文件同样适用于Teaming 2.1);
*#选择“Update software and settings（更新软件和设置）”，点击Next；
*#点击Next，接受默认的安装地址，以及[[Java]] [[JDK]]的地址；
*#在“Host”字段中输入当前服务器的主机名；
*#根据需要更改Lucene的配置信息，然后点击Next；
*#点击“Install”，进行升级；
*#升级完成后，点击“Finish”；
*#启动Lucene Index Server；
*#在所有远程服务器上的组件全部升级完成后，可以进行Teaming服务器上的Teaming核心升级；
== Kablink Teaming 1.0升级到2.1 ==
=== 升级相关信息 ===
Kablink Teaming 由1.0升级到2.1后，主要发生的变化是Teaming系统不再使用[[Liferay]] Portal。Teaming 2.1安装程序将会备份你的Teaming数据，并且使其与Liferay分离开来，不造成任何数据的丢失。升级后，系统的下面几方面将得到改进：
*Teaming软件的版本信息由1.0更新到2.1,；
*Teaming数据库会拥有一个新的数据库结构，用来支持Teaming 2.1中的新增功能；
*Lucene Index Server的功能也将会得到改善；
*Teaming系统不再需要使用外部的e-mail系统来接收入站邮件，因为Teaming 2.1自带了内部的[[SMTP]]邮件主机。
*Liferay将在升级后被系统去除，处于不可用状态，如果想继续使用的话，需要独立安装该软件；
*关于已经存在的Teaming系统的安装信息备份保存在下面目录：/opt/icecore/teaming-backup
=== 升级前的准备 ===
*'''升级安装环境：'''[[Red Hat]] Enterprise Linux 3 and 4，Oracle 9g，[[Microsoft]] SQL Server 2000，这些配置支持Teaming 1.0但是不支持Teaming 2.1的安装，所以在升级前需要先检查一下安装环境，看是否需要进行安装环境的升级；
*'''备份Teaming 1.0的数据：'''
*#备份Teaming File Repository中的数据，Linux下这些数据所在位置：/home/icecoredata，Windows下这些数据所在位置：c:\teaming。Teaming 2.1的相关默认安装目录与Teaming 1.0会有所不同，但Teaming 2.1的安装程序在升级过程中并不会自动移动这些之前的安装数据，所以，请先检查installer.xml文件，保证所有类型的Teaming数据都已备份；
*#备份Teaming数据库中的数据，Teaming 1.0和Teaming 2.1的数据库所在位置相同，然而，如果数据库管理员在其他地方创建的数据库需要你自己寻找备份，需要的话可以查看installer.xml文件；
*#备份Teaming 和[[Tomcat]]的日志文件，升级过程将会伤处所有的Teaming和Tomcat的日志文件，如果想保留这些日志文件，需要将它们复制到Teaming软件所在目录之外的目录中，日志文件所在位置：
 The Teaming 1.0 log file (ssf.log) is located here:
 Linux:    /opt/icecore/liferay-portal-tomcat-version-jdk5-version/webapps/ssf/[[WEB]]-INF/logs
 Windows:  c:\icecore\liferay-portal-tomcat-version-jdk5-version\webapps\ssf\WEB-INF\logs
 The Tomcat log file (catalina.out on Linux and stdout_*.log on Windows) is located here:
 Linux:    /opt/icecore/liferay-portal-tomcat-version-jdk5-version/logs
 Windows:  c:\icecore\liferay-portal-tomcat-version-jdk5-version\logs
*'''Teaming 2.1站点文件导入的条目类型更新：'''
在Teaming1.0中，如果使用Add Files to Folder（添加文件至文件夹）功能，也就是将存储有文件的目录拖放至Teaming文件夹中的话，这些文件将自动被定义为Discussion条目类型，尽管Teaming文件夹并不是该类型。除此之外，如果目录中还有子目录的话，子目录将被创建为Teaming Discussion文件夹。如果想改变Teaming2.1中条目类型和文件夹类型，使其与Teaming文件夹类型一致的话，我们可以在高级Teaming文件夹设置默认设置页面中启用Recursive Apply 功能，即修改ssf-ext.properties文件：

1.  登录到Teaming服务器，切换到ssf-ext.properties文件所在目录，默认地址为：/opt/novell/teaming/apache-tomcat-version/webapps/
ssf/WEB-INF/classes/config（Linux），c:\Program Files\Novell\Teaming\apache-tomcat-version\webapps\ssf\WEB-INF\classes\config（Windows）；

2.  备份ssf-ext.properties文件；

3.  用文本编辑器打开ssf-ext.properties文件，然后在文件底部添加：ssf.allowFolderDefinitionFixups=true；

4.  保存ssf-ext.properties文件，退出文本编辑器；

5.  重新启动Teaming，使更改有效；
=== 单一服务器环境下的升级 ===
#停止运行Teaming系统；
#如果teaming系统使用的是[[Oracle]]数据库，请先升级数据库，次升级过程将在下文描述，如果使用的不是Oracle，则可跳过此步；
#将Teaming1.0安装目录下的installer.[[xml]]和license-key.xml文件复制到Teaming 2.1下载解压所在的目录下（installer.xml文件会在你运行Teaming2.1安装程序时提供默认信息，可以修改，license文件可以完全不经修改地运用于Teaming 2.1）；
#启动Teaming 2.1安装程序；
#接受许可证协议后，点击Next；
#因为Teaming 1.0的文件已经存在于 Teaming 2.1的安装目录下，所以此时默认的选项不是“New installation”而是“Update software and settings（更新软件和设置）”，点击Next，继续；
#点击“Yes”，让安装程序知道你已经关闭了Teaming 1.0系统；
#选中“复选框 ”，让安装程序知道你已经备份了Teaming系统的所有数据，然后点击Next；
#选择“Basic”或者是“Advance”，点击Next；
#根据Teaming 2.1系统的需求，来更改相关配置信息；
#配置信息更新完成后，点击“Install”，进行升级更新（此安装过程花费的时间较长，因为需要修改Teaming数据库中的表以及索引）；
#升级完成后，点击“Finish”按钮；
#启动Teaming 2.1，启动的方法与Teaming 2.0相同；
=== oracle数据库升级 ===
1.  切换到Teaming 2.1安装程序的所在目录；

2.  将teaming -2.1.n-sql.zip文件解压为update-2.0.0-2.1.n和update-1.0.0-2.0目录，目录下包含了每一个类型数据库的升级脚本，包括Oracle的；

3.  切换到update-1.0.0-2.0.n目录下；

4.  运行update-oracle.sql脚本，是数据库结构从1.0更新到2.0：
  sqlplus "/ as sysdba"
  SQL>spool update-oracle.out;
  SQL>@update-oracle;
  SQL>quit;
5.  切换到update-2.0.0-2.1.n

6.  运行update-oracle.sql脚本，是数据库结构从2.0更新到2.1：
  sqlplus "/ as sysdba"
  SQL>spool update-oracle.out;
  SQL>@update-oracle;
  SQL>quit;
7. 返回到“单一服务器环境下的升级”步骤中去；
=== 多服务器环境下的升级 ===
*'''手动升级Teaming数据库:'''
1.  停止运行Teaming；

2.  切换到Teaming 2.1安装程序的所在目录；

3.  将teaming -2.1.n-sql.zip文件解压为update-1.0.0-2.0.n和update-2.0.0-2.1.n目录，该目录下包含了每一个类型数据库的升级脚本；

4.  切换到update-1.0.0-2.0.n目录下；

5.  复制当前使用的数据库的升级脚本到Teaming数据库所在的服务器中；

6.  使用数据库的[[客户端]]工具，运行脚本：
 '''MySQL: '''          mysql -uusername -ppassword < /path/update-mysql.sql
 '''Microsoft SQL:'''   osql -Uusername -Ppassword -i update-sqlserver.sql 
 '''Oracle: '''         sqlplus "/ as sysdba"
                        SQL>spool update-oracle.out;
                        SQL>@update-oracle
                        SQL>quit;
7.  切换到update-2.0.0-2.1.n文件夹下；

8.  复制当前使用的数据库的2.0至2.1的升级脚本到Teaming数据库所在的服务器中（因为2.0到2.1的升级脚本与1.0到2.0的升级脚本命名相同，所以在复制时需要覆盖掉原来的脚本）；

9.  使用数据库的客户端工具，运行脚本；
*'''手动升级Lucene Index Server:'''
Lucene Index Server软件的默认安装路径在1.0和2.1中是不同的，但是在升级时可以使用之前的安装路径也可以使用Teaming2.1的默认安装路径：
 Linux:    Teaming 1.0: /opt/icecore/luceneserver
           Teaming 2.1: /opt/novell/teaming/luceneserver
 Windows:  Teaming 1.0: c:\icecore\luceneserver
           Teaming 2.1: c:\Program Files\Novell\Teaming\luceneserver
Lucene Index的默认路径也发生更改，但是升级后需要为Teaming站点重建索引，所以Teaming2.1Lucene Index将被新建到新的默认路径中：
 Linux:    Teaming 1.0: /home/icecoredata/lucene
           Teaming 2.1: /var/opt/novell/teaming/lucene
 Windows:  Teaming 1.0: c:\home\icecoredata\lucene
           Teaming 2.1: c:\Novell\Teaming\lucene
1.    停止运行Teaming；

2.    停止运行Lucene Index Server，Linux: ./indexserver-stop.sh  Windows: indexserver-stop.bat；

3.    将Teaming 2.1安装程序所在目录下的Teaming 2.1 Remote Lucene Server安装程序复制到lucene Index Server所在服务器的某一方便的目录下，Remote Lucene Server安装程序的名字随着所在系统平台的不同而不同：[[Linux]] 称lucene-installer.linux，[[windows]]称lucene-installer.exe

4.    启动Teaming 2.1 Remote Lucene Server安装程序；

5.    接受许可证信息，点击Next（服务器上存在的Teaming 2.0的license-key.xml文件同样适用于Teaming 2.1);

6.    选择“Update software and settings（更新软件和设置）”，安装到当前Teaming1.0的安装路径中，或者选择“New Install”安装到新的路径中去，然后点击Next；

7.    点击Next，接受默认的安装地址，以及[[Java]] [[JDK]]的地址；

8.    在“Host”字段中输入当前服务器的主机名；

9.    根据需要更改Lucene的配置信息，然后点击Next；

10.  点击“Install”，进行升级；

11.  升级完成后，点击“Finish”；

12.  启动Lucene Index Server，Linux: ./indexserver-startup.sh ，Windows: indexserver-startup.bat；

13.  在所有远程服务器上的组件全部升级完成后，可以进行Teaming服务器上的Teaming核心升级；
== 参考来源 ==
http://www.novell.com/documentation/kablinkteaming21/

{{Kablink Team}}

[[category:Kablink Team]]