インスタンスを起動
- 右上のContinue to Subscribe をクリックしてAmazon マシンイメージ(AMI)をサブスクライブします。次に、利用規約に同意します。サブスクライブすると、 の新しいインスタンスを設定できます。
- 次のようにインスタンスを設定します:
- インスタンスの種類を選択します。詳しくは、 Licensingを参照してください。
- セキュリティグループを設定します。 はデフォルトのHTTPS ポート(443)で動作します。 にアクセスするIP アドレスがこのポートに接続できることを確認してください。
- 新しいキーペアを作成するか、既存のものを選択します。必ずPEM ファイルを保存してください。PEM ファイルは、後にSSH(secure shell)を介してAMI にアクセスする際に使用します。
- Launch をクリックしてEC2 インスタンスを作成し、 を起動します。
へブラウザからアクセス
インスタンスを起動すると、Amazon EC2 管理コンソールにリストされます。ブラウザから以下のURL で にアクセスできます: https://InstancePublicDNS 次のクレデンシャルを使用してログインします:- ユーザー: デフォルトのユーザー名はadmin です。
- パスワード: パスワードは、インスタンスのランダムに生成されたインスタンスId に接頭辞*:* を付けたものです。例えば、インスタンスId がi-1234a の場合、 にアクセスするための初期パスワードは:i-1234a になります。ログイン後、ブラウザの右上からadmin ユーザーのパスワードを変更できます。
AMI の管理
AMI は、追加設定なしで動作します。次のセクションでは、 の管理タスクに関するAMI 固有の情報を提供します。Secure Shell(SSH)からインスタンスに接続する
サービスの高度な設定をする際に、EC2 インスタンスへのSSH 接続が役立ちます。 AMI は標準のUbuntu 22 仮想マシン(VM)上に構築されており、メインユーザーはubuntu です。インスタンス起動時に選択したキーペアを使用して、以下に示すようにSSH を介して接続できます:サービスを制御
は、AMI デプロイメントで(インプロセスで実行されるのではなく)systemd サービスとして実行されます。サービス定義ファイルは次の場所にあります:etc/systemd/system/sync.service
の停止、起動、および再起動には次のsystemd コマンドを使用します:
アプリケーションに変更を加える前に、まずサービスを停止する必要があります。
インストールディレクトリ
すべての の設定とアプリケーションデータは、アプリケーションディレクトリに存在します。デフォルトのアプリケーションディレクトリ(ApplicationDirectory)は次のとおりです:
/opt/sync
アプリケーションディレクトリの設定で説明するように、sync.properties ファイルでアプリケーションディレクトリのパスを設定できます。
db フォルダ
db フォルダは、デフォルトのアプリケーションデータベースのデータベースファイルを含みます。バージョン26.2 以降、 はデフォルトのアプリケーションデータベースとして組み込みH2 データベースを使用します。既存のインストールでは、引き続きレガシーの組み込みDerby データベースを使用します。 は既存のインストールをH2 に自動的に移行しません。
また、Microsoft SQL Server、PostgreSQL、またはMySQL などの外部エンタープライズデータベースを使用するよう を設定することもできます。
libs フォルダ
libs フォルダは、アプリケーションが外部リソースを読み込む場所であり、外部ドライバを必要とするコネクタのドライバーのようなものです。このフォルダにJAR ファイルを配置して を再起動すると、アプリケーションがこれらのリソースを読み込めるようになります。
アプリケーションディレクトリの設定
ApplicationDirectory の場所は、sync.jar ファイルの隣にあるsync.properties ファイルで設定できます。
ApplicationDirectory をデフォルト以外の場所に設定するには:
-
sync.properties ファイル内で次のスニペットを探します:
-
次の例に示すように、アプリケーションディレクトリの新しい場所へのパスを追加します:
アプリケーションデータベース
新規 インストールでは、デフォルトのアプリケーションデータベースとして組み込みH2 データベースを使用します。既存のインストールでは、引き続きレガシーの組み込みDerby データベースを使用します。 は既存のインストールをH2 に自動的に移行しません。 アプリケーションデータベースは、前述のとおり、アプリケーションディレクトリのdb フォルダにあります。
また、Microsoft SQL Server、PostgreSQL、またはMySQL などの外部エンタープライズデータベースを使用するよう を設定することもできます。このセクションでは外部データベースを設定する方法の一つを説明しますが、推奨されるアプローチは移行ドキュメントの手順に従うことです。
アプリケーションデータベースを設定するには:
-
sync.properties ファイル内で次のスニペットを探します:
-
次の例のように、接続文字列を使用したいターゲットデータベースに設定します:
- のサービスを再起動して、以上の手順の変更を有効にします。
ポートとSSL
デフォルトでは、 はポート8443でSSL 接続(HTTPS)をリッスンします。 は、アクセス許可の制限事項によりデフォルトのHTTPS ポート(443)にバインドできません。そのため、iptables のルールによりポート443からポート8443にトラフィックをリダイレクトします。標準的なHTTPS トラフィックであれば、 Web サーバーに到達するためにこれ以上のアクションは必要ありません。 AMI には、SSL サーバーをホスティングする際に使用する自己署名証明書が含まれています。証明機関(CA)によって署名された証明書を使用してSSL サーバーをホストしなければならない場合は、直接CA に連絡して証明書を取得する必要があります。HTTP 接続の有効化
プレーンテキスト / 非SSL ポート(例えば、HTTPS の代わりにHTTP)を追加するには、sync.properties ファイルを編集してプレーンテキストのリスナーを有効化する必要があります。アクセス許可の制限事項により、リスナーはポート80に直接バインドできません。そのためポート8181を確立しますが、次の手順でポート80からポート8181にトラフィックを転送するiptables ルールを確立する必要があります:-
次のコマンドを実行して のサービスを停止します:
-
sync.properties ファイル内でhttp.port スニペットを探します:
- ポートを8181に設定して変更を保存します。
-
ポート80からポート8181にトラフィックを転送するための新しいiptables ルールを作成します:
- のサービスを再起動して、以上の手順の変更を有効にします。
アップグレード
をアップグレードするには、最新の AMI の新しいインスタンスを起動する必要があります。新しいインスタンスを起動する前に、古いインスタンスからデータをコピーして、新しいインスタンスでアプリケーションの設定が保持されるようにする必要があります。 には、設定された接続やジョブをアプリケーション上で簡単にエクスポートおよびインポートできる移行ツールが搭載されています。 移行ツールを使用するには:- 設定画面で移行タブに移動します。
- エクスポートをクリックして、すべての設定(接続、ジョブ、ユーザー、および履歴)をZIP ファイルにエクスポートします。
- 同じ移行タブで、新しいインスタンスに設定をインポートします。
- インポートをクリックします。
- 手順2で作成したZIP ファイルを設定します。
新しいコネクタを追加
接続を追加の手順に従ってUI から新しいコネクタを追加できます。ただし、次の手順に従ってインスタンスのコネクタを手動で更新、または追加しなければならない場合があります:- SSH を使用してAMI に移動します。
-
次のコマンドを実行してJetty のサービスを停止します:
-
新しいコマンドプロンプトを開き、次の
scpコマンドを使用してコネクタをインスタンスにコピーします: -
このコマンドを実行して、コネクタを
libsフォルダにコピーします: -
次のコマンドを実行して のサービスを再起動します: