从发行版 5.0.5 和较早发行版升级到发行版 6 的过程已经发生了很大变化。对于发行版 5.1.3 和以前的发行版,执行就地安装。现在,您要将 Java CAPS 6 安装到新目录中,并导出 5.1.3 和以前的项目和环境,然后使用 NetBeans IDE 将它们导入发行版 6。导出旧的项目和环境并创建外部文件的方式有两种:
使用 Enterprise Designer 的导出功能
使用命令行脚本
本主题提供了有关如何成功升级到发行版 6 的说明。
在开始从 Java CAPS 5.1.0–5.1.3 或 ICAN Suite 5.0.5 以前的发行版导出项目和环境的过程之前,建议您先熟悉相应的《eGate Integrator 用户指南》中完成此任务的步骤。
安装 Java CAPS 6。
有关如何完成安装的说明,请参见以下主题之一:
开始安装之前,请确保已熟悉 Java CAPS 安装规划的内容。
使用 Enterprise Designer,将项目或环境从发行版 5.0.5 至 5.1.3 中导出,并创建外部文件以导入发行版 6。
导出项目和环境之前,请记录它们的设置。重置属性时需要此信息。
也可以使用命令行脚本创建外部文件。有关如何使用命令行执行此任务的说明,请参见通过使用命令行导出项目和环境的方式升级。
导出项目时,请注意:
导出的项目可能含有对其他项目中的元素的引用。导出过程中会生成此类引用的列表。
项目部署对象不会导出,因为它们含有对项目级别上不需要的项目和环境元素的引用。
也可以使用命令行导出项目或环境。有关如何执行此任务的说明,请参见通过使用命令行导出项目和环境的方式升级。
在“系统信息库”或“项目”上下文菜单中选择“导出项目”以显示“导出管理器”对话框。
如果您的系统信息库中没有任何现有环境,则“环境”窗格是空的。
在显示的列表中,高亮显示所需的项目和/或环境。
单击相应的箭头按钮,将高亮显示的项移至“选定的项目”或“已选择环境”窗格。
在本例中,我们仅选择了一个项目,因此在剩余步骤中将不会提到环境。
所需的项目列在“选定的项目”窗格以后,单击“浏览”以显示“另存为”对话框。
已通过向项目名称添加 ZIP 扩展名创建了文件名。
可更改导出文件名。
要输入文件名,请单击“另存为”。
“导出管理器”对话框会再次出现。
选择导出目的地,然后单击“导出”以导出项目文件。
此过程可能需要花费几分钟时间。文件成功导出后,将显示“导出状态”消息框。
要关闭消息框,请单击“确定”。
将基于非 JBI 的项目或环境导入 NetBeans IDE 中。
启动 NetBeans IDE。
在菜单栏上,依次选择“工具”、“CAPS 系统信息库”、“导入项目”。
当“导入项目”警告提示您保存尚未保存或签入的更改时,如果需要执行此操作,请单击“否”;否则,请单击“是”继续此过程。
此时将显示“导入管理器”对话框。
要选择您创建的导出 ZIP 文件,请在“从 ZIP 文件”字段中浏览到 ZIP 文件的位置并选择该文件。
如果您希望该项目在 NetBeans IDE 的“项目”窗格中显示为顶级,请在“目的地项目”字段下拉列表中选择“作为顶级”。
在“导入管理器”对话框中完成所有选择后,单击“导入”。
显示“导入状态”消息时,单击“确定”。
等待系统信息库完成刷新,然后关闭“导入管理器”对话框。
该项目显示在左窗格中的“项目”下。
可以使用命令行脚本导出项目、环境,或者项目及环境。在开始从 Java CAPS 5.1.0–5.1.3 或 ICAN Suite 5.0.5 以前的发行版导出项目和环境的过程之前,建议您先熟悉相应的《eGate Integrator 用户指南》中完成此任务的步骤。
脚本文件的位置
JavaCAPS_install_dir\repository\util\exportProject.bat
或
JavaCAPS_install_dir/repository/util/exportProject.sh
命令语法
exportProject username password branch_name export_file project_name environment_name |
其中:
branch_name 是包含您要导出的项目和/或环境的系统信息库分支的名称。
export_file 是包含您要导出的项目和/或环境的归档文件的名称和路径。
project_name 是您要导出的项目的名称。可以导出多个项目,方法是:将它们依次列出,并以加号 (+) 分隔。如果不导出项目,请将此参数保留为空字符串 ("")。
environment_name 是您要导出的环境的名称。可以导出多个环境,方法是:将它们依次列出,并以加号 (+) 分隔。如果不导出环境,请将此参数保留为空字符串 ("")。
project_name 和 environment_name 变量假定对象驻留在与您使用的脚本文件相同的系统信息库目录中。
项目名称不应包含特殊字符,例如逗号 (,)、单引号 (') 或双引号 (")。如果使用了这些字符中的任何字符,则在使用 exportProject 命令行工具时必须对这些字符进行转义。
安装 Java CAPS 6。
有关如何完成安装的说明,请参见以下主题之一:
开始安装之前,请确保已熟悉 Java CAPS 安装规划的内容。
使用导出脚本导出项目。
将基于非 JBI 的项目或环境导入 NetBeans IDE 中。
启动 NetBeans IDE。
在菜单栏上,依次选择“工具”、“CAPS 系统信息库”、“导入项目”。
当“导入项目”警告提示您保存尚未保存或签入的更改时,如果需要执行此操作,请单击“否”;否则,请单击“是”继续此过程。
此时将显示“导入管理器”对话框。
要选择您创建的导出 ZIP 文件,请在“从 ZIP 文件”字段中浏览到 ZIP 文件的位置并选择该文件。
如果您希望该项目在 NetBeans IDE 的“项目”窗格中显示为顶级,请在“目的地项目”字段下拉列表中选择“作为顶级”。
在“导入管理器”对话框中完成所有选择后,单击“导入”。
显示“导入状态”消息时,单击“确定”。
等待系统信息库完成刷新,然后关闭“导入管理器”对话框。
该项目显示在左窗格中的“项目”下。