GoldenGate Studio Freeの使用を始める

必要事項

Oracle GoldenGate Studio Freeを使用するには、次のものが必要です:

次のいずれかが実行されているシステム:
- Docker、または互換性のあるコンテナ・ランタイム(Podmanなど)
- Linux
コンテナ・レジストリまたはOracle Technology Network (OTN)にアクセスするためのインターネット接続
有効なOracle.comログイン

GoldenGate Studio Freeの入手

GoldenGate Studio Freeは、Oracle Container Registry (OCR)またはOracle Technology Network (OTN)から入手できます。GoldenGate Studio Freeにアクセスするには、該当する手順に従います。

Oracle Container Registryから

次の手順に従って、Oracle Container Registry (OCR)からGoldenGate Studio Freeにアクセスします。

Oracle Container RegistryからGoldenGate Studio FreeのDockerイメージをプルする前に、Oracleアカウントにサインインし、ライセンス契約に同意する必要があります。

GoldenGate Studio FreeのDockerイメージにアクセスするには:

ライセンス契約に同意します。
Dockerクライアントで、次のコマンドを入力してOracle Container Registryにログインします:
```
docker login container-registry.oracle.com
```
プロンプトが表示されたら、Oracleアカウントのユーザー名とパスワードを入力します。
docker pullコマンドをコピーして最新のGoldenGate Studio Freeイメージをプルし、それをDockerクライアントで実行します:
```
docker pull container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```

Oracle Technology Networkから

次の手順に従って、Oracle Technology Network (OTN)からGoldenGate Studio Freeにアクセスします。

Oracle Technology NetworkからGoldenGate Studio Free構成アシスタントをダウンロードする前に、Oracleアカウントにサインインし、ライセンス契約に同意する必要があります。

GoldenGate Studio Free構成アシスタントをダウンロードするには:

ブラウザでOracle Technology Networkを開きます。
ソフトウェア・ダウンロードページで、下にスクロールしてからミドルウェアを選択します。
「ミドルウェア」で、GoldenGate Studio Freeを選択します。
Oracle GoldenGate Studio Freeダウンロードのページで、入手可能なインストーラ・パッケージを選択します。
ライセンス契約に同意します。
プロンプトが表示されたら、インストーラ・パッケージをローカル・マシンに保存し、その場所をメモします。

GoldenGate Studio FreeのDockerイメージの起動と実行

Oracle Container RegistryからDockerイメージをプルした後にGoldenGate Studio Freeを起動して実行する方法について説明します。

GoldenGate Studio Freeを起動して実行するには:

Dockerクライアントで、デフォルト設定を使用してrunコマンドを入力するか、パラメータ値を指定してrunコマンドを入力します:
- デフォルト設定でGoldenGate Studio Freeを実行するには:
```
docker run -p 80:80 -p 443:443 container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```
  コンテナは次のデフォルト・オプションを使用してインスタンス化されます:
  - コンテナ名は自動生成されます
  - HTTPサーバー用に80ポート
  - HTTPSサーバー用に443ポート
  - 管理アカウントの名前はoggadminです
  - 管理アカウントのパスワードは自動生成されます
  - デプロイメントの名前はLocalです
  - /u02および/u03ボリューム用にコンテナ・ストレージが使用されます
  - 自己署名証明書は自動生成されます
- 変更した設定でGoldenGate Studio Freeを実行するには:
```
docker run \
    --name <container-name> \
    -p <host port>:80 \
    -p <host port>:443 \
    -e OGG_ADMIN=<admin user name> \
    -e OGG_ADMIN_PWD=<admin password> \
    -e OGG_DEPLOYMENT=<deployment name> \
    -e OGG_DOMAIN=<domain name> \
    -v [<host mount point>:]/u02 \
    -v [<host mount point>:]/u03 \
    -v [<host mount point>:]/etc/nginx/cert \
    container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```
  パラメータの説明:
  - <container-name>: コンテナの名前。デフォルトでは自動生成されます。
  - -p <host-port>:80: Oracle GoldenGate HTTPサーバーをマップするホスト・ポート。デフォルトでは、マッピングはありません。
  - -p <host-port>:443: Oracle GoldenGate HTTPSサーバーをマップするホスト・ポート。デフォルトでは、マッピングはありません。
  - -e OGG_ADMIN: 作成する管理アカウントの名前。デフォルトではoggadminです。
  - -e OGG_ADMIN_PWD: 管理アカウントのパスワード。デフォルトでは自動生成されます。
    ヒント:
    パスワードが次の要件を満たしていることを確認してください:
    - 1つ以上の小文字[a...z]
    - 1つ以上の大文字[a...z]
    - 1つ以上の数字[0...9]
    - 1つ以上の特殊文字[- ! @ % & * . #]
    - 長さは8文字から30文字の間
  - -e OGG_DEPLOYMENT: デプロイメントの名前。デフォルトでは、Localです。
  - -e OGG_DOMAIN=<domain name>: 自己署名証明書に使用するドメイン名(デフォルト: コンテナのホスト名)。独自のSSL証明書を使用する場合は不要です。
  - -v /u02: 永続GoldenGateデータ用に使用するボリューム。デフォルトではコンテナ・ストレージが使用されます。
  - -v /u03: 一時GoldenGateデータ用に使用するボリューム。デフォルトではコンテナ・ストレージが使用されます。
  - -v /etc/nginx/cert: HTTPSサーバーのSSL証明書を格納するために使用するボリューム。デフォルトでは自己署名証明書が作成されます。
  データ・ストレージ・ボリューム
  - /u01: GoldenGateシステム用のボリューム
  - /u02: 永続GoldenGateデータ用のボリューム
  - /u03: 一時GoldenGateデータ用のボリューム
  管理アカウントのパスワード
  
  OGG_ADMIN_PWDにパスワードが指定されていない場合は、コンテナの初回起動時に、Oracle GoldenGate用のランダムなパスワードが生成されます。このパスワードは、コンテナ・ログの先頭にあります:
```
docker logs <container-name> | head -3
```
数分後、「次の場所でサーバーが起動しました: http://localhost:8080」が表示されます。これで、GoldenGate Studio Freeを使用する準備ができました。
Webブラウザを起動し、http://localhost:8080にアクセスします。
GoldenGate Studio Freeログイン画面で、docker runコマンドに渡したユーザー名とパスワードを入力してから、「ログイン」をクリックします。

正常にログインすると、GoldenGate Studio Freeのホームページが表示されます。

次のステップ

これで、GoldenGate Studio Freeにログインしました。次にできること: