RSSBus EDI 系统帮助文档 – Upgrading a Previous Version

升级以前的版本
RSSBus连接是几个早期应用程序版本的最新版本，包括以下版本:

* IP*Works! EDI AS2 Connector V7 (/n software)
* AS2 Connector V2 (/n software)
* AS2 Connector V3, FTP Connector V1, OFTP Connector V2, and SFTP Connector V1 (RSSBus)

安装RSSBus连接

Windows用户
RSSBus Connect的Windows安装将针对与该产品早期版本不同的安装路径，并在不同的端口上侦听，以确保两个版本可以并行运行，而不会相互冲突。只需运行setup.exe并按照提示在机器上安装应用程序。

Java用户

与AS2连接器的早期版本(以及连接器系列中的其他版本)一样，该应用程序是作为可分发的rssbus.war文件提供的。如果您使用服务器的内置部署向导将此WAR文件分发到您的Java服务器，这将完全替换您现有的AS2连接器安装，包括贸易伙伴配置文件。

如果您想要执行AS2连接器的就地升级，并且在安装之间仍然保留您的配置文件设置，请在部署新包之前创建以前安装的数据文件夹的副本。该数据文件夹位于现有网络应用程序文件夹下的/WEB-INF/data/文件夹中。将此文件夹复制到新位置后，部署RSSBus Connect代替现有安装。首次启动应用程序时，未配置端口。单击Import Profiles导入配置文件以指定复制数据文件夹以恢复配置文件的位置。

或者，您可以重命名rssbus.war随RSSBus Connect一起提供的，以将此版本的应用程序安装为并行应用程序。例如，将应用程序命名为“rssbusconnect.war”会将应用程序部署到一个名为rssbusconnect的网络应用程序中，该应用程序与现有的rssbusconnect应用程序并行运行。

导入配置文件信息

如果您要从早期版本的AS2连接器、SFTP连接器或其他早期版本升级，有几种方法可以检测和导入您现有的合作伙伴配置文件配置。

自动导入

如果您正在安装应用程序早期版本的计算机上安装视窗版RSSBus Connect，安装程序将尝试检测早期版本的安装，并可以从中导入配置文件设置。如果检测到与RSSBus Connect中已配置的合作伙伴配置文件同名的合作伙伴配置文件，此过程将创建一个重复条目，并在标识字段后附加一个数字，以确保其唯一性。导入重复的配置文件后，您可以安全地删除它们。

使用管理控制台导入

如果要在尚未配置贸易伙伴的地方安装RSSBus连接，请在端口部分从连接器应用程序的旧安装中导入配置文件。在生成的对话框中，选择要从中导入配置文件的旧安装的数据文件夹。

使用导入配置文件应用编程接口导入

如果您已经创建了几个端口，导入配置文件应用编程接口是一个有用的选项。您必须将存储旧配置文件信息的数据文件夹的位置作为数据目录参数提供给应用编程接口。还有一个可选的复制操作参数，您可以通过该参数告诉应用程序在RSSBus Connect中已经配置了该名称的现有配置文件时如何反应。例如，如果连接器的上一次安装在默认安装路径中，并且希望覆盖导入时找到的任何匹配配置文件，则可以在浏览器中输入以下内容:

http://localhost:8001/api.rsc/importProfiles?DataDirectory=C:\\Program Files\\RSSBus\\RSSBus Server\\data&DuplicateAction=Merge&@x-http-method=POST

或者，您可以从代码中调用这个应用程序接口。应用程序的应用编程接口部分提供了JavaScript和cURL示例。本节包括一些扩展RSSBus连接功能的应用程序接口，您可以通过服务调用从应用程序外部访问这些接口。

配置透明升级

在运行RSSBus连接的安装并将应用程序先前安装的合作伙伴配置文件导入RSSBus连接后，新版本在接收旧版本的URLs时具有向后兼容性，有两个主要区别:

1.RSSBus连接使用与应用程序服务器不同的本地端口，应用程序服务器用于承载应用程序的先前安装。这是为了避免与先前版本的AS2连接器的安装发生冲突，以便您可以按照自己的速度维护应用程序的两个版本并将合作伙伴转移到新版本。

2.AS2连接器先前安装的传入、传出和发送文件夹不会自动导入到RSSBus连接中使用的配置文件中。默认情况下，应用程序使用自己的本地文件资源，以免干扰当前运行的应用程序实例。这还确保了如果在以前的配置文件中启用了自动化，应用程序不会立即开始发送等待在AS2连接器的旧版本中发送的文件。

如果要替换AS2连接器的实例:

1.确定是要使用AS2连接器先前安装时的旧文件夹结构，还是要使用RSSBus Connect中提供的新文件夹。
2.确定您希望使用现有网址还是新网址。

保留以前的文件夹
如果您不打算添加贸易伙伴，将RSSBus连接指向应用程序先前安装中使用的相同文件夹可能是最简单的。您可以为新端口配置输入、输出和发送文件夹，以指向应用程序的端口>高级部分中的旧位置。这使您可以使用以前使用的相同资源与本地文件系统集成，但是如果将来添加其他端口，默认情况下，应用程序会在不同的数据文件夹中创建这些端口。

优势

* 将您现有的后端业务逻辑用于现有的贸易伙伴。

劣势

* 默认情况下，其他端口使用不同的数据文件夹。

切换到使用新文件夹

如果您计划添加更多合作伙伴，最好将RSSBus Connect中的新文件夹结构集成到您的后端业务逻辑中，或者使用RSSBus Connect对文档进行业务处理。对于RSSBus连接中配置的每个端口，应用程序通过磁盘上的三个文件夹与底层系统集成，这三个文件夹位于\数据\端口_标识\位置:

* 用于提取传出文件的输入文件夹
* 用于放置传入文件的输出文件夹
* 用于保存已发送传输副本的已发送文件夹
对于用于创建传出文件的进程，请将每个合作伙伴的传出文件夹指向新的输入文件夹位置。如果在以前的版本中启用了自动化，应用程序将自动向这些端口发送传出传输。

对于传入的传输，配置您的业务逻辑以从新的输出文件夹中获取资源。当您将应用程序的新版本配置为接受旧服务器端口上的请求时，应用程序将开始接收新文件夹中的文件。

如果您使用应用程序中的已发送文件夹来跟踪已发送的传输，请配置您的业务逻辑来监控新安装中的已发送文件夹。

优势

* 通过维护一致的文件夹结构，简化其他合作伙伴的业务逻辑。

劣势

* 必须重新配置业务逻辑，以便为现有合作伙伴使用新文件夹。

使用新的URL

与早期版本相比，配备RSSBus Connect的服务器监听不同的端口，并使用不同的URL接收AS2传输。将您的配置文件导入RSSBus Connect后，您必须更新您的贸易伙伴，以便他们发送到您的新接收网址。

默认情况下，带有RSSBus连接的服务器在端口8001上以明文侦听，并在端口8401上使用SSL，您可以通过单击Profile > AS2 Profile找到接收网址。

优势

* 按照自己的速度转变贸易伙伴
* 没有停机时间

劣势

* 贸易伙伴需要在他们的个人资料配置中更改您的网址
* 防火墙上必须打开一个附加端口
* 应用程序的两个版本都得到维护

使用现有URL

要在以前收到的同一网址上接收请求，请停止承载以前版本的服务器，以便将同一端口分配给RSSBus Connect。您还需要将服务器分配到您在以前版本中使用的同一端口。您可以通过右键单击系统托盘中的图标，然后单击服务器选项来配置端口。应用程序会自动识别对以前版本的应用程序所支持的资源的请求(例如，/as2 connector/pub/receivefile . rsb和/Receiver.aspx)，并将其转发到RSSBus Connect中的相应资源。

优势

* 贸易伙伴不需要更改配置文件
* 维护一个系统

劣势

* 停止旧服务器以释放新服务器的端口时停机
* 必须首先导入现有配置文件

注意:如果您配置的端口是启用了SSL的端口，您还需要在该端口上配置与以前版本的AS2连接器使用的相同的SSL证书。如果您以前在RSSBus AppServer中托管过一个SSL端口，那么同一个证书存储区就是RSSBus Connect(本地计算机的个人帐户)中的SSL证书的位置。

将RSSBus连接配置为使用旧版本应用程序中使用的相同端口后，您将开始在上面配置的文件夹中接收传入的传输。