Version 24.2.9039

• CData Arc 2024 の以前のマイナーバージョンビルドからのアップデート
  • クロスプラットフォーム版
    • Linux
    • Windows
    • Java ユーザー向けの注意
  • .NET 版
• CData Arc 2022 または2023 からのアップグレード
  • クロスプラットフォーム版
    • Linux
    • Windows
    • Java ユーザー向けの注意
  • .NET 版
• ArcESB 2021 からのアップグレード
  • クロスプラットフォーム版
    • Linux
    • Windows
    • Java ユーザー向けの注意
  • .NET 版
• ArcESB 2020 からのアップグレード
  • クロスプラットフォーム版
    • Linux
    • Windows
    • Java ユーザー向けの注意
  • .NET 版
  • ユーザー管理
  • ファイルベースのコネクタ内のサブフォルダ
  • ローカルフォルダの上書き
  • Windows アプリケーションディレクトリ
• RSSBus Connect 2016、2017、2018、2019 からのアップグレード
  • クロスプラットフォーム版
    • Linux
    • Windows
    • Java ユーザー向けの注意
    • .NET 版
  • 手動で設定データを移行
  • アプリケーションデータソースコネクタのアップグレード
    • CData ドライバー
  • 外部コネクタのアップグレード
• AS2 コネクタからのアップグレード
  • CData Arc のインストール
    • .NET 版ユーザー
    • Java ユーザー
  • プロファイル情報のインポート
    • 自動でインポート
    • 管理API を使ったインポート
  • 透過的なアップグレードの設定
    • 以前のフォルダを保持する
    • 新しいフォルダを使うよう変更する
    • 新しいURL を使用する
    • 既存のURL を使用する
• Amazon AMI のアップグレード

CData Arc 2024 は、次を含む先行するいくつかのアプリケーションの最新版です。

• CData Arc 2022 および2023

• ArcESB 2020 および2021

• RSSBus Connect 2016、2017、2018 および2019

• AS2 connector V2 (/n software)

• AS2 connector V3、FTP connector V1、OFTP connector V2、およびSFTP connector V1 (RSSBus)

• IP*Works! EDI AS2 connector V7 (/n software)

Note：新規メジャーバージョンへのアップグレード（例えば、Arc 2023 からArc 2024 にアップグレードする場合）には、アプリケーションをライセンスするための新しいプロダクトキーが必要です。CData のセールスチーム（[email protected]）までお問い合わせください。

CData Arc 2024 の以前のマイナーバージョンビルドからのアップデート

クロスプラットフォーム版

Arc 2024 のJava エディションは、Windows 用はsetup.exe、Linux 用は圧縮されたsetup.tar.gz ファイルとして提供されます。お使いのオペレーティングシステムの手順を実行することで、既存のArc 2024 を新しいビルドにアップグレードできます。

Linux

1. Arc サーバーを停止します。

2. tar.gz アーカイブからarc.war ファイルを解凍し、/opt/arc/webapp/ に配置して古いファイルを上書きします。

3. （オプション）tar.gz アーカイブからarc.jar ファイルを解凍し、/opt/arc/ に配置して古いファイルを上書きします。

4. サーバーを起動します。

Windows

1. Arc サーバーを停止します。

2. setup.exe を実行します。

3. インストーラーでArc がインストールされている場所を指定します。

4. アップグレードが完了したら、サーバーを起動します。

Java ユーザー向けの注意

• Arc のデプロイ方法に関わらず、アプリケーションディレクトリ（ApplicationDirectory）内のファイルおよびフォルダは、アプリケーションを実行しているユーザーによって読み取り / 書き込み可能である必要があります。Java 版に同梱されるservice.sh スクリプトはcdataarc を実行するユーザーとして使用します。

• アプリケーションが以前別のユーザーで実行されていて、cdataarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、コマンドは以下のようになります：

  sudo chown -R cdataarc:cdataarc /opt/arc

.NET 版

サーバーを停止し（組み込みWeb サーバーのUI から、または該当する場合はIIS で）、setup.exe を実行します。セットアップはインストールパスを検出し、以前のビルドを上書きし、すべての設定データをそのまま残します。

CData Arc 2022 または2023 からのアップグレード

クロスプラットフォーム版

Arc 2024 のJava エディションは、Windows 用はsetup.exe、Linux 用は圧縮されたsetup.tar.gz ファイルとして提供されます。お使いのオペレーティングシステムの手順を実行することで、既存のArc 2022 または2023 をArc 2024 にアップグレードできます。

Linux

1. Arc サーバーを停止します。

2. tar.gz アーカイブからarc.war ファイルを解凍し、/opt/arc/webapp/ に配置して古いファイルを上書きします。

3. （オプション）tar.gz アーカイブからarc.jar ファイルを解凍し、/opt/arc/ に配置して古いファイルを上書きします。

4. サーバーを起動します。

Windows

1. Arc サーバーを停止します。

2. setup.exe を実行します。

3. インストーラーでArc がインストールされている場所を指定します。

4. アップグレードが完了したら、サーバーを起動します。

Java ユーザー向けの注意

• Arc のデプロイ方法に関わらず、アプリケーションディレクトリ（ApplicationDirectory）内のファイルおよびフォルダは、アプリケーションを実行しているユーザーによって読み取り / 書き込み可能である必要があります。Java 版に同梱されるservice.sh スクリプトはcdataarc を実行するユーザーとして使用します。

• アプリケーションが以前別のユーザーで実行されていて、cdataarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、コマンドは以下のようになります：

  sudo chown -R cdataarc:cdataarc /opt/arc

.NET 版

Arc 2024 はArc 2022 からそのままアップグレードすることができます。Arc 2024 のWindows インストーラーを実行するだけで、必要なファイルがすべてアップグレードされます。

Arc 2024 のWindows インストーラーはArcESB 2022 の既存のインストールを探し、既存のコネクタ、フロー、設定の保持を試みます。ArcESB 2022 がデフォルトの場所にインストールされていない場合、Arc 2024 のインストーラー上でArcESB 2022 がインストールされているディスク上のフォルダを指定する必要がある場合があります。

ArcESB 2021 からのアップグレード

クロスプラットフォーム版

Arc 2024 のJava エディションは、Windows 用はsetup.exe、Linux 用は圧縮されたsetup.tar.gz ファイルとして提供されます。お使いのオペレーティングシステムの手順を実行することで、既存のArcESB 2021 をArc 2024 にアップグレードできます。

Linux

1. tar.gz ファイルを/opt/arc/ に抽出します。

2. サーバーを停止します（例：sudo systemctl stop arcesb）。

3. 組み込みJetty Server を使用するインストールをアップグレードする場合は、sudo bash /opt/arc/upgrade.sh を実行します。以前のインストールがデフォルトのパス以外の場所にインストールされている場合は、オプションで-InstallDirectory パラメータを指定します。外部のサーブレットコンテナ（例えばApache Tomcat やExternal Jetty）を使用するインストールをアップグレードする場合は、instructions for your servlet container を参照してください。

4. サーバーをサービスとして起動（例えばsudo systemctl start arc）するか、またはプロセス内で起動します（例えばjava -jar arc.jar）。

Windows

1. Arc サーバーを停止します。

2. setup.exe を実行します。

3. インストーラーでArc がインストールされている場所を指定します。

4. アップグレードが完了したら、サーバーを起動します。

Java ユーザー向けの注意

• Arc のデプロイ方法に関わらず、アプリケーションディレクトリ（ApplicationDirectory）内のファイルおよびフォルダは、アプリケーションを実行しているユーザーによって読み取り / 書き込み可能である必要があります。Java 版に同梱されるservice.sh スクリプトはcdataarc を実行するユーザーとして使用します。

• アプリケーションが以前別のユーザーで実行されていて、cdataarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、コマンドは以下のようになります：

  sudo chown -R cdataarc:cdataarc /opt/arc

.NET 版

Arc 2024 はArcESB 2021 からそのままアップグレードすることができます。Arc 2024 のWindows インストーラーを実行するだけで、必要なファイルがすべてアップグレードされます。

Arc 2024 のWindows インストーラーはArcESB 2021 の既存のインストールを探し、既存のコネクタ、フロー、設定の保持を試みます。ArcESB 2021 がデフォルトの場所にインストールされていない場合、Arc 2024 のインストーラー上でArcESB 2021 がインストールされているディスク上のフォルダを指定する必要がある場合があります。

ArcESB 2020 からのアップグレード

アップグレードを開始する前に、現行バージョンのArc にはいくつかArcESB 2020 のインストールとは異なる動作をする場合があることにご留意ください。

• Arc 2024 はサーバー設定ではなくアプリケーション内でユーザーを管理するため、ユーザー設定の中には移行できないものがある場合があります。詳しくは、ユーザー管理を参照してください。

• Arc 2024 はFTP およびSFTP サーバーに存在するサブフォルダの構造を自動では保持しません。詳しくは、ファイルベースのコネクタ内のサブフォルダを参照してください。

• Arc 2023 では、個々のコネクタのローカルフォルダをオーバーライドできません。詳しくは、ローカルフォルダの上書きを参照してください。

• Arc 2024 は、デフォルトでは実行にWindows の管理者権限を必要としないので、一部フォルダの権限の更新が必要になる場合があります。詳しくは、Windows アプリケーションディレクトリを参照してください。

クロスプラットフォーム版

Arc 2024 のJava エディションは、Windows 用はsetup.exe、Linux 用は圧縮されたsetup.tar.gz ファイルとして提供されます。お使いのオペレーティングシステムの手順を実行することで、既存のArcESB 2020 をArc 2024 にアップグレードできます。

Linux

1. tar.gz ファイルを/opt/arc/ に抽出します。

2. サーバーを停止します（例：sudo systemctl stop arcesb）。

3. 組み込みJetty Server を使用するインストールをアップグレードする場合は、sudo bash /opt/arc/upgrade.sh を実行します。以前のインストールがデフォルトのパス以外の場所にインストールされている場合は、オプションで-InstallDirectory パラメータを指定します。外部のサーブレットコンテナ（例えばApache Tomcat やExternal Jetty）を使用するインストールをアップグレードする場合は、instructions for your servlet container を参照してください。

4. サーバーをサービスとして起動（例えばsudo systemctl start arc）するか、またはプロセス内で起動します（例えばjava -jar arc.jar）。

Windows

1. Arc サーバーを停止します。

2. setup.exe を実行します。

3. インストーラーでArc がインストールされている場所を指定します。

4. アップグレードが完了したら、サーバーを起動します。

Java ユーザー向けの注意

• Arc のデプロイ方法に関わらず、アプリケーションディレクトリ（ApplicationDirectory）内のファイルおよびフォルダは、アプリケーションを実行しているユーザーによって読み取り / 書き込み可能である必要があります。Java 版に同梱されるservice.sh スクリプトはcdataarc を実行するユーザーとして使用します。

• アプリケーションが以前別のユーザーで実行されていて、cdataarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、コマンドは以下のようになります：

  sudo chown -R cdataarc:cdataarc /opt/arc

.NET 版

Arc 2024 はArcESB 2020 からそのままアップグレードすることができます。Arc 2024 のインストーラーを実行するだけで、必要なアプリケーションリソースをすべてアップグレードできます。

Arc 2024 のWindows インストーラーはArcESB 2020 の既存のインストールを探し、既存のコネクタ、フロー、設定の保持を試みます。ArcESB 2020 がデフォルトの場所にインストールされていない場合、Arc 2024 のインストーラー上でArcESB 2020 がインストールされているディスク上のフォルダを指定する必要があります。

Arc 2024 は、Arc 2024 のインストーラー上でArcESB 2020 がインストールされたフォルダ以外の場所を指定することで、ArcESB 2020 とは別にインストールすることもできます。異なるフォルダにインストールされている限り、2つのインストールが競合することはありません。

ユーザー管理

ArcESB 2020 以前のバージョンでは、ユーザーをサーバー設定のXML ファイル（例えば、Web.Config やserver.xml）で管理していました。Arc の最近のバージョンでは、設定ページのユーザータブで、アプリケーション自体でユーザー管理を行うことができます。

2021 より前のバージョンで設定されたユーザーは、アップグレード中に保持されないため、必要に応じてユーザータブで再作成する必要があります。詳しくは、ユーザーロールを参照してください。

ファイルベースのコネクタ内のサブフォルダ

Note：このセクションの内容は、リモートファイルシステムのフォルダ構造を保持するファイルベースのコネクタ（File、FTP、SFTP を含む）を利用されているユーザー向けのものです。

Arc の以前のバージョンでは、次の動作を実行していました：

ファイルベースのコネクタが、ファイルのアップロード先またはダウンロード元であるリモートサーバー上の１つのフォルダをターゲットとして指定します。このターゲットフォルダ内のサブフォルダからもファイルをダウンロードする必要がある場合には、同じサブフォルダの構造がローカルのコネクタのOutput ディレクトリに再構築されていました。アップロードについても同様に、コネクタはファイルがInput ディレクトリのサブフォルダ内にある場合は、ファイルが格納されるべきリモートファイルシステム上のサブフォルダ構造を示すものとして扱っていました。「サブフォルダの構造を保持する」とはこのようなサブフォルダ構造の再構築のことを指しています。

Arc 2024 では、リモートシステム上のフォルダ構造を再現するにはFile コネクタの使用が必須となります。こうしたファイルベースのコネクタは、サーバー上のターゲットフォルダのサブフォルダ内にファイルが格納された場合には、ダウンロードされたファイルにsubfolder ヘッダーを追加します。subfolder ヘッダ―は、ファイルがリモートファイルシステムにアップロードされる際に自動でサブフォルダ構造を再構築するために使われます。

ローカルフォルダの上書き

ArcESB 2021 より前のバージョンでは、コネクタの設定を使って各コネクタのSend、Receive、Sent フォルダを上書きできました。ArcESB 2021 からはUI 上でこれらの操作を実行することはできず、コネクタフォルダを直接上書きすることも非推奨です。ローカルファイルシステムの管理にはFile コネクタの使用がベストプラクティスです。

必要であれば、コネクタのSendFolder、ReceiveFolder、SentFolder プロパティは、コネクタの設定内の高度な設定 > その他 > その他の設定から手動で上書きすることができます。以前のリリースでこれらの設定が上書きされていた場合は、その設定が表示されます。

この方法でコネクタのローカルフォルダを上書きする場合は、高度な設定 > 処理の遅延の値を秒単位で1以上（例えば10）の値に設定します。それによって、Arc が外部プロセスによって書き込みが行われているファイルを処理する事態を防ぐことができます。

Windows アプリケーションディレクトリ

Arc 2024 のWindows 版では、フロー、コネクタ、プロファイル設定などのデータを保持するアプリケーションディレクトリを、デフォルトでC:\ProgramData\CData\Arc フォルダに格納します。ArcESB 2021 より前のバージョンでは、アプリケーションディレクトリはC:\Program Files フォルダ内にありました。これにより、Arc 2024 はデフォルトで管理者権限なしで実行することができます。

ArcESB 2020 以前のバージョンからArc 2024 にアップグレードする際は、アプリケーションは以前のインストールのアプリケーションディレクトリを使用しますが、デフォルトでは管理者権限なしで実行を試みます。そのため、C:\Program Files 内のアプリケーションディレクトリでアクセス権限を設定し、低い実行権限でArc を実行できるようにしておく必要があるかもしれません。

アプリケーションディレクトリについての詳細は、アプリケーションディレクトリの設定を参照してください。

RSSBus Connect 2016、2017、2018、2019 からのアップグレード

このセクションでは、以前のバージョンのRSSBus Connect からアップグレードする方法を説明します。

Note：RSSBus Connect 2016 より前のバージョンからのアップグレードについては、AS2 コネクタからのアップグレードを参照してください。

アップグレードを開始する前に、現行バージョンのArc にはいくつかRSSBus Connect のインストールとは異なる動作をする場合があることにご留意ください。

• Arc 2024 はサーバー設定ではなくアプリケーション内でユーザーを管理するため、ユーザー設定の中には移行できないものがある場合があります。詳しくは、ユーザー管理を参照してください。

• Arc 2024 はFTP およびSFTP サーバーに存在するサブフォルダの構造を自動では保持しません。詳しくは、ファイルベースのコネクタ内のサブフォルダを参照してください。

• Arc 2024 では、個々のコネクタのローカルフォルダを上書きできません。詳しくは、ローカルフォルダの上書きを参照してください。

• Arc 2024 は、デフォルトでは実行にWindows の管理者権限を必要としないので、一部フォルダの権限の更新が必要になる場合があります。詳しくは、Windows アプリケーションディレクトリを参照してください。

クロスプラットフォーム版

Arc 2024 のJava エディションは、Windows 用はsetup.exe、Linux 用は圧縮されたsetup.tar.gz ファイルとして提供されます。お使いのオペレーティングシステムの手順を実行することで、既存のRSSBus Connect Java 版をArc 2024 にアップグレードできます。

Linux

1. tar.gz ファイルを/opt/arc/ に抽出します。

2. サーバーを停止します（例：sudo systemctl stop arcesb）。

3. 組み込みJetty Server を使用するインストールをアップグレードする場合は、sudo bash /opt/arc/upgrade.sh を実行します。以前のインストールがデフォルトのパス以外の場所にインストールされている場合は、オプションで-InstallDirectory パラメータを指定します。外部のサーブレットコンテナ（例えばApache Tomcat やExternal Jetty）を使用するインストールをアップグレードする場合は、instructions for your servlet container を参照してください。

4. サーバーをサービスとして起動（例えばsudo systemctl start arc）するか、またはプロセス内で起動します（例えばjava -jar arc.jar）。

Windows

1. Arc サーバーを停止します。

2. setup.exe を実行します。

3. インストーラーでArc がインストールされている場所を指定します。

4. アップグレードが完了したら、サーバーを起動します。

Java ユーザー向けの注意

• Arc のデプロイ方法に関わらず、アプリケーションディレクトリ（ApplicationDirectory）内のファイルおよびフォルダは、アプリケーションを実行しているユーザーによって読み取り / 書き込み可能である必要があります。Java 版に同梱されるservice.sh スクリプトはcdataarc を実行するユーザーとして使用します。

• アプリケーションが以前別のユーザーで実行されていて、cdataarc ユーザーがアプリケーションを実行するために必要な権限を復元したい場合は、コマンドは以下のようになります：

  sudo chown -R cdataarc:cdataarc /opt/arc

.NET 版

RSSBus Connect 2016、2017、2018、2019 からArc 2024 へのアップグレードは、ワンステップでのインプレースアップグレードが可能です。Arc インストーラーを実行すれば、アプリケーションファイル（EXE、DLL、JAR、WAR ファイル）が設定データを壊すことなくアップデートされます。

Arc インストーラーがRSSBus Connect のインストールを検知すると、インストーラーは同一のインストールパスを使って設定データ（プロファイル、コネクタ / ポート、証明書）を格納します。そのため、古いバージョンの設定が新しいArc のインストールでも自動で使用されます。

手動で設定データを移行

インプレースアップグレードができない場合でも、以前のバージョンのRSSBus Connect から設定データを移行できます。

移行方法の1つは、コネクタ（ポート）設定を古いバージョンからエクスポートして、それらのコネクタを新バージョンにインポートすることです。

1. RSSBus Connect では、ウィンドウ右上の設定（歯車アイコン）をクリックしてポート設定をエクスポートを選択することで、ポートタブからコネクタをエクスポートできます。より新しいバージョンのRSSBus Connect（例えばRSSBus Connect 2019など）では、フロータブから、フロー内のコネクタ（ポート）を右クリックしてポート設定をエクスポートを選択することでコネクタをエクスポートできます。

2. Arc では、設定をクリックし、ワークスペースをインポートを選択して、フロータブからコネクタをインポートします。

2番目の方法では、ディスク上のフォルダを管理することにより、すべての設定データを一度に転送します。すべての設定情報はインストールディレクトリのdata フォルダに保存されています。以前のバージョンのdata フォルダを最新バージョンの同じフォルダにコピーすることで、実質的にすべてのアプリケーション設定がコピーされます。

Arc のデフォルトインストールディレクトリは次のとおりです。

• .NET 版：C:\Program Files\CData\CData Arc

• Java：/opt/arc

RSSBus Connect のデフォルトインストールディレクトリは次のとおりです。

• .NET 版：C:\Program Files\RSSBus\RSSBus Connect

• Java：~/rssbus/connect

Linux システムでは、’~’ はJava サーブレットがインストールされているユーザーのホームディレクトリになります。Windows システムでは、’~’ は%ProgramData% として解決されます。

Note：Arc のインストールディレクトリが表示されない場合は、RSSBus Connectのデフォルトインストールディレクトリを確認してください。Arc のインストーラーは、RSSBus Connect のインストールを検出し、RSSBus Connect の既存のフォルダ構造の使用を試みます。

アプリケーションデータソースコネクタのアップグレード

Arc は、従来のデータベースではなくアプリケーション外部データソース（Salesforce、NetSuite、QuickBooks など）に接続するための方法を新しく導入しました。RSSBus Connect では、各外部データソースアプリケーションには、アプリケーションとのインターフェースに専用のコネクタ（ポート）が必要でした。Arc では、CData コネクタと呼ばれる単一のコネクタを使用して各アプリケーションデータソースに接続します。

CData ドライバー

CData コネクタは、CData ドライバーを使用して特定のデータソースに接続します。CData Software は、何百ものクラウドおよびオンプレミスのアプリケーション、データベースなどへの接続を可能にするADO.NET およびJDBC ドライバーを提供します。これらのドライバーは、以前のRSSBus Connect コネクタ（ポート）で内部的に使用されていたため、これらのアプリケーションデータソースのデータにアクセスするためのインターフェースと方法は変更されていません。

このコネクタ（ポート）群をArc にアップグレードするには、適切なCData ドライバーをCData コネクタにインストールし、設定する必要があります。CData ドライバーのインストールについては、CData コネクタ を参照してください。CData ドライバーがインストールされ、CData コネクタの設定内で選択されると、CData コネクタはRSSBus Connect コネクタ（Salesforce コネクタ、HubSpot コネクタなど）で使用されたものと同じ接続設定とクレデンシャルで設定できます。

外部コネクタのアップグレード

以前は外部だった少数のコネクタが、Arc 2024 の組み込みに移行しました。

• SQL Server

• Oracle

• PDF

これらのコネクタは、アプリケーションと一緒に適切にインストールされ、追加のダウンロードは不要です。

AS2 コネクタからのアップグレード

このセクションは、FTP コネクタ、OFTP コネクタ、およびSFTP コネクタからのアップグレードにも適用されます。

CData Arc のインストール

.NET 版ユーザー

Arc のWindows インストールは、以前のバージョンの製品とは異なるインストールパスを対象とし、異なるポートでリッスンします。この変更により、両方のバージョンを互いに競合することなく並行して実行できます。setup.exe を実行し、プロンプトに従ってアプリケーションをマシンにインストールするだけです。

Java ユーザー

AS2 コネクタの以前のバージョン（およびコネクタファミリの他のバージョン）と同様に、Arc は配布可能なarc war ファイルとして提供されます。サーバーの組み込みデプロイメントウィザードを使用してこのWAR ファイルをJava サーバーに配布すると、取引パートナプロファイルを含むAS2 コネクタの既存のインストールがすべて置き換えられます。

AS2 コネクタのインプレースアップグレードを実行し、インストール間でプロファイル設定を保持する場合は、新しいパッケージをデプロイする前に、以前のインストールのdata フォルダのコピーを作成してください。このdata フォルダは、既存のWeb アプリケーションフォルダの下の/WEB-INF/data/ フォルダにあります。このフォルダを新しい場所にコピーしたら、既存のインストールの代わりにArc をデプロイします。初めてアプリケーションを起動する際には、コネクタ（ポート）は未設定です。プロファイルのインポートをクリックして、プロファイルを復元するためにdata フォルダをコピーした場所を指定します。

または、Arc と一緒に提供されるarc war ファイルの名前を変更することで、このバージョンのアプリケーションを既存のバージョンと並行してインストールすることができます。

プロファイル情報のインポート

以前のバージョンのAS2 コネクタ、SFTP コネクタ、またはその他のコネクタの以前のバージョンからアップグレードする場合は、2つの方法を使って、既存のパートナープロファイル設定を検出してインポートできます。

自動でインポート

以前のバージョンのアプリケーションがインストールされたマシンにWindows 版のArc をインストールする場合、インストールプログラムは、以前のバージョンのインストールを検出してそこからプロファイル設定をインポートできるか検証します。Arc ですでに設定されているものと同じ名前のパートナープロファイルが検出された場合、このプロセスが、一意であることを担保するために識別フィールドに番号が追加された重複エントリを作成します。重複したプロファイルは、インポート後安全に削除できます。

管理API を使ったインポート

Arc の管理API には、以前のバージョンから設定をインポートするために使用できる_import_ アクションが含まれています。import アクションには、次の3つのパラメーターが必要です。

• Arcflow—フローデータを含むbase64 でエンコードされた文字列。.arcflow ファイルの内容をすべてbase64 でエンコードすることで、この文字列を生成できます。

• Overwrite—インポートされたプロファイルまたはパートナー設定が現在の設定とコンフリクトを引き起こした場合の、Arc の応答方法。この値がTrue の場合、既存の設定は上書きされます。そうでない場合は、エラーが生成されます。

• WorkspaceId—フローがインポートされるワークスペース。このパラメータが指定されていない場合、アプリケーションはインポートされるフロー内のワークスペースの値に基づいてインポート先のワークスペースを決定し、必要に応じてデフォルトのワークスペースを使用します。

import アクションへのすべてのリクエストは、HTTP POST リクエストとして送信する必要があります。

管理API の詳細については、管理API セクションを参照してください。

透過的なアップグレードの設定

Arc インストーラーを実行して以前のバージョンのアプリケーションからパートナープロファイルをインポートすると、新バージョンは古いバージョンでURL を受信する後方互換性を持ちます。ただし、重要な違いが2つあります。

• Arc は、アプリケーションの以前のインストールをホストするために使用されたアプリケーションサーバーとは異なるローカルポートを使用します。これにより、以前のバージョンのAS2 コネクタのインストールとの競合が回避されるため、アプリケーションの両方のバージョンを維持し、パートナーを新しいバージョンに自分のペースで転送できます。

• AS2 コネクタの前回のインストールからのIncoming、Outgoing、およびSent フォルダは、Arc で使用されるプロファイルに自動ではインポートされません。デフォルトでは、アプリケーションは現在実行中のアプリケーションのインスタンスに干渉しないように、自身のローカルファイルリソースを使用します。これにより、以前のプロファイルで自動化が有効になっている場合、アプリケーションは古いバージョンのAS2 コネクタで送信されるのを待機しているファイルの送信をすぐに開始することはありません。

AS2 コネクタのインスタンスを置き換えるには、次の決定が必要となります。

1. AS2 コネクタの以前のインストールの古いフォルダ構造を使用するか、Arc のデフォルトのフォルダ構造を使用するか。

2. 既存の受信URL を使用するか、新しい受信URL を使用するか。

以前のフォルダを保持する

現行バージョンのArc には、メッセージフローの個別の論理ステップとしてファイルシステム内の外部フォルダと対話を可能にする、File コネクタが含まれています。このプロセスにより、以前に使用したものと同じリソースを使用することでローカルファイルシステムを統合できます。ただし、将来コネクタを追加する場合には、アプリケーションはデフォルトでこれらを別のdata フォルダに作成します。

次の画像は、上記の方法でFile コネクタを使用するフローの例を示します。

この目的のためにFile コネクタを設定する方法については、ローカルファイルシステムとのやり取りを参照してください。

メリット

設定された取引パートナについては、既存のバックエンドビジネスロジックが保持されます。

デメリット

追加するコネクタはデフォルトでは別のdata フォルダを使用します。

新しいフォルダを使うよう変更する

Arc に新たにパートナーやコネクタを追加するつもりであれば、新しいデフォルトのフォルダ構造に切り替えるのが最適でしょう。次にこのプロセスについて説明します。

Arc アプリケーションディレクトリは、すべてのコネクタとプロファイルの設定データを含みます。Arc で設定された各コネクタには、data フォルダ（デフォルトのワークスペースの場合）内に自身のフォルダ、またはworkspaces フォルダ内に適切なワークスペースフォルダがあります。コネクタ固有フォルダには次のフォルダが含まれます。

• Logs —コネクタがコネクタ固有のログを書き込むフォルダ。

• Pending —パートナーの応答を待機するコネクタは、保留中のメッセージをこのフォルダに保存します（特定のコネクタタイプのみが必要とします）。

• Receive —外部ソースからファイルを受信またはダウンロードするコネクタは、ファイルをこのフォルダに配置します。外部ソースから送受信せずにローカルデータを操作するコネクタは、ファイルが処理された後、このフォルダにファイルを配置します。

• Send —このフォルダに配置されたファイルは、コネクタによって処理、送信、またはアップロードされる予定のものです。

• Sent —コネクタは、処理、送信、およびアップロードされたファイルのコピーをこのフォルダに配置します。

AS2 コネクタの場合、外部の取引パートナに送信する必要のあるファイルをコネクタのSend フォルダに配置し、外部の取引パートナから受信したファイルをコネクタのReceive フォルダから取り出します。

メリット

追加の取引パートナを設定する場合、一貫したフォルダ構造が維持されます。

デメリット

新しいフォルダ構造を使うには、ビジネスロジックの再設定が必要になる場合があります。

新しいURL を使用する

Arc で提供されるサーバーは、以前のバージョンとは異なるポートでリッスンし、AS2 通信を受信するために異なるURL を使用します。プロファイルをArc にインポートした後、取引パートナを更新して新しい受信URL に送信するように設定する必要があります。

デフォルトでは、Arc で提供されるサーバーはポート8001 でプレーンテキストでリッスンし、ポート8401 でSSL / TLS を使用します。プロファイル > AS2 をクリックすることで、受信URL を確認できます。

メリット

• 自身のペースで取引パートナーを移行。

• ダウンタイムがない。

デメリット

• 取引パートナーは、相手側のプロファイル設定でURL を変更する必要がある。

• ファイアウォールで追加のポートを開く必要がある。

• アプリケーションの両方のバージョンを維持管理。

既存のURL を使用する

以前のバージョンで使用されているのと同じURL でリクエストを受信するには、以前のバージョンをホストしているサーバーを停止して、同じポートをArc に割り当てることができるようにします。また、以前のバージョンで使用していたポートにサーバーを割り当てる必要があります。ポートを設定するには、システムトレイのアプリケーションアイコンを右クリックし、次にサーバーオプションをクリックします。Arc は、アプリケーションの以前のバージョン（例えば、/as2connector/pub/ReceiveFile.rsb および/Receiver.aspx）でサポートされていたリソースへのリクエストを自動的に認識し、Arc の適切なリソースに転送します。

メリット

• 取引パートナーはプロファイルを変更する必要なし。

• 維持管理するのは1つのシステムのみ。

デメリット

• 新しいサーバー用にポートを解放するために、古いサーバーが停止している間のダウンタイム。

• 既存のプロファイルを最初にインポートする必要がある。

Note：設定するポートでSSL / TLS が有効化されている場合は、このポートで以前のバージョンのAS2 コネクターに使用されたSSL / TLS 証明書を設定する必要があります。以前にArc でSSL / TLS ポートをホストしていた場合、同じ証明書ストア（ローカルマシンの個人アカウント）がArcでのSSL / TLS 証明書の場所になります。

古いバージョンのアプリケーションで使用していたのと同じポートを使用するようにArc を設定すると、上記で設定したフォルダで通信の受信を開始します。

Amazon AMI のアップグレード

Arc 2024 には、Arc を実行する新しいEC2 インスタンスを作成するために使用できる専用のAMI がAWS Marketplace に存在します。すべてのアプリケーションデータを保持するには、ファイルシステムから直接アプリケーションフォルダをコピーする方法について理解するため手動バックアップの手順に従ってください。次の手順に従って、関連するフォルダの永続的なコピーを作成します。

1. SFTP やSCP などの転送プロトコルを介してAmazon VM からローカルマシンにフォルダをコピーします。

2. 同じフォルダを最新のAMI で作成されたEC2 インスタンスに転送します。