Oracle GoldenGate 23ai 運用ガイド：起動・停止手順と権限設定

26ai

2026.01.28

本ドキュメントは、Oracle GoldenGate 23ai (Microservices Architecture) の標準的な起動・停止手順、および運用に必要なOSユーザー権限の設定についてまとめたものです。従来のClassic Architectureとは異なり、23aiではService Managerを頂点としたサービス階層構造になっているため、正しい順序での操作がデータの整合性確保において重要です。

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

Oracleのスキルは需要が高く、特定の資格や経験を持っていると年収が大幅にアップするケースがあります。まずはIT専門のエージェントで非公開求人をチェックしてみませんか？

1. 事前準備：運用ユーザーの権限設定 (Sudoers)
1. 設定手順
2. ユーザープロファイルへのエイリアス追加（推奨）
2. 起動手順 (Startup)
1. Step 1: Service Manager の起動
2. Step 2: Extract / Replicat プロセスの起動
3. 停止手順 (Shutdown)
1. Step 1: Extract / Replicat プロセスの停止
  1. コマンド構文
  2. 停止実行例
2. Step 2: Service Manager の停止
4. トラブルシューティングTips
5. FAQ (よくある質問)
6. まとめ

1. 事前準備：運用ユーザーの権限設定 (Sudoers)

セキュリティおよび運用ミスの防止観点から、root ユーザーではなく、GoldenGate所有ユーザー（例: oracle）がOSサービスを操作できるように設定します。

設定手順

root ユーザーにて visudo コマンドを実行し、/etc/sudoers に以下の行を追記します。これにより、oracle ユーザーはパスワードなしでGoldenGateサービスの起動・停止のみが可能になります。

# visudo で追記
oracle ALL=(root) NOPASSWD: /usr/bin/systemctl start OracleGoldenGate, /usr/bin/systemctl stop OracleGoldenGate, /usr/bin/systemctl restart OracleGoldenGate, /usr/bin/systemctl status OracleGoldenGate

ユーザープロファイルへのエイリアス追加（推奨）

oracle ユーザーの ~/.bash_profile に以下を追加することで、操作を簡略化できます。

alias oggstart='sudo systemctl start OracleGoldenGate'
alias oggstop='sudo systemctl stop OracleGoldenGate'
alias oggstatus='sudo systemctl status OracleGoldenGate'

2. 起動手順 (Startup)

起動は OSサービス (Service Manager) $\rightarrow$ GGプロセス (Extract/Replicat) の順で行います。

Step 1: Service Manager の起動

OSのサービスとして登録された Service Manager を起動します。これにより、配下の管理サーバー (Admin Server) や配布サーバー (Distribution Server) も自動的に起動します。

[oracle@26ai-gg23ais ~]$ sudo systemctl start OracleGoldenGate

Step 2: Extract / Replicat プロセスの起動

adminclient を使用して各Deploymentに接続し、データ連携プロセスを起動します。

接続コマンド構文 (CONNECT)

CONNECT { url } DEPLOYMENT { deployment_name } AS { user } PASSWORD { password } [ ! ]

補足:
- url: Service ManagerのURL (例: http://localhost:9000 や https://ogghost:9000)
- deployment_name: 接続先のDeployment名
- user: 接続ユーザー名 (通常は oggadmin 等)
- !: SSL証明書検証をスキップする場合などに使用（末尾に付与）

起動コマンド構文 (START)

START { EXTRACT | REPLICAT } { group_name | * }

補足:
- group_name: 起動対象のグループ名を指定します（例: EXT01）。
- * (ワイルドカード): 現在のDeploymentに含まれる該当タイプの全プロセスを一括起動します。

2-1. ソース側 (Source) の起動例

環境: 192.168.56.101 (Source) / Deployment: Deployment23ai

[oracle@26ai-gg23ais ~]$ /opt/oracle/goldengate/23ai/ogg_home/bin/adminclient

# Deploymentへの接続
OGG (not connected) 1> connect http://192.168.56.101:9000 deployment Deployment23ai as oggadmin password Oracle#1234

# ステータス確認 (STOPPEDを確認)
OGG ([http://192.168.56.101:9000](http://192.168.56.101:9000) Deployment23ai) 2> info all
Program     Status      Group       Type             Lag at Chkpt        Time Since Chkpt
ADMINSRVR   RUNNING
DISTSRVR    RUNNING
PMSRVR      RUNNING
RECVSRVR    RUNNING
EXTRACT     STOPPED     EXT01       INTEGRATED            00:00:03        6d:20:57:15

# Extract起動 (ワイルドカード使用可)
OGG ([http://192.168.56.101:9000](http://192.168.56.101:9000) Deployment23ai) 3> start extract *
2026-01-25T14:31:02Z  INFO    OGG-00975  Extract group EXT01 starting.
2026-01-25T14:31:02Z  INFO    OGG-15426  Extract group EXT01 started.

# 起動確認
OGG ([http://192.168.56.101:9000](http://192.168.56.101:9000) Deployment23ai) 4> info all
Program     Status      Group       Type             Lag at Chkpt        Time Since Chkpt
ADMINSRVR   RUNNING
DISTSRVR    RUNNING
PMSRVR      RUNNING
RECVSRVR    RUNNING
EXTRACT     RUNNING     EXT01       INTEGRATED            00:00:03        6d:20:57:33

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

2-2. ターゲット側 (Target) の起動例

環境: 192.168.56.102 (Target) / Deployment: Deployment23ai

[oracle@26ai-gg23ait ~]$ /opt/oracle/goldengate/23ai/ogg_home/bin/adminclient
Oracle GoldenGate Administration Client for Oracle
Version 23.4.1.24.05 OGGCORE_23.4.0.0.0OGGR_LINUX.X64_240529.0500_FBO

Copyright (C) 1995, 2024, Oracle and/or its affiliates. All rights reserved.

Linux, x64, 64bit (optimized) on May 29 2024 09:21:59
Operating system character set identified as UTF-8.

# Deploymentへの接続
OGG (not connected) 1> connect http://192.168.56.102:9000 deployment Deployment23ai as oggadmin password Oracle#1234

# ステータス確認
OGG ([http://192.168.56.102:9000](http://192.168.56.102:9000) Deployment23ai) 2> info all
Program     Status      Group       Type             Lag at Chkpt        Time Since Chkpt

ADMINSRVR   RUNNING
DISTSRVR    RUNNING
PMSRVR      RUNNING
RECVSRVR    RUNNING
REPLICAT    STOPPED     REP01       INTEGRATED            00:00:00           00:00:28

# Replicat起動 (ワイルドカード使用)
OGG ([http://192.168.56.102:9000](http://192.168.56.102:9000) Deployment23ai) 3> start replicat *
2026-01-25T14:35:12Z  INFO    OGG-00975  Replicat group REP01 starting.
2026-01-25T14:35:12Z  INFO    OGG-15445  Replicat group REP01 started.

# 起動確認
OGG ([http://192.168.56.102:9000](http://192.168.56.102:9000) Deployment23ai) 4> info all
Program     Status      Group       Type             Lag at Chkpt        Time Since Chkpt

ADMINSRVR   RUNNING
DISTSRVR    RUNNING
PMSRVR      RUNNING
RECVSRVR    RUNNING
REPLICAT    RUNNING     REP01       INTEGRATED            00:00:00           00:00:00

OGG ([http://192.168.56.102:9000](http://192.168.56.102:9000) Deployment23ai) 5>

3. 停止手順 (Shutdown)

データの整合性を保つため、GGプロセス (Extract/Replicat) $\rightarrow$ OSサービス (Service Manager) の順（起動と逆順）で停止します。

Step 1: Extract / Replicat プロセスの停止

adminclient にて正常停止 (Graceful Stop) を行います。

コマンド構文

STOP { EXTRACT | REPLICAT } { group_name | * } [ ! ]

補足:
- !: 強制停止オプション。プロセスが応答しない場合やハングした場合に使用します（例: stop extract EXT01 !）。
- 注意: ! を使用するとトランザクションがロールバックされる場合があるため、通常運用では使用せず、タイムアウト等が発生した場合のみ使用してください。

停止実行例

# adminclient に接続後

# Extractの個別停止 (Source側)
OGG > stop extract EXT01

# Extractの一括停止 (Source側・ワイルドカード使用)
OGG > stop extract *

# Replicatの個別停止 (Target側)
OGG > stop replicat REP01

# Replicatの一括停止 (Target側・ワイルドカード使用)
OGG > stop replicat *

Step 2: Service Manager の停止

すべてのプロセスが STOPPED になったことを確認後、OSサービスを停止します。

[oracle@26ai-gg23ais ~]$ sudo systemctl stop OracleGoldenGate

4. トラブルシューティングTips

Admin Client接続エラー:
- Service Managerが起動しているか sudo systemctl status OracleGoldenGate で確認してください。
- 23aiではNginx等のリバースプロキシを経由する場合があるため、Nginxのステータスも確認してください。
プロセスが起動しない場合:
- view report <process_name> コマンドで直近のエラーログを確認してください。
- start extract * や start replicat * を使用する際、特定のプロセスがメンテナンス中で停止しておくべきものがないか、事前に info all で確認することを推奨します。

5. FAQ (よくある質問)

Q. OS再起動時にGoldenGateは自動起動しますか？ A. systemctl enable OracleGoldenGate を設定していれば、OS起動時にService Managerが自動起動します。さらに、Deployment内のExtract/Replicatプロセスも、プロパティで Auto Start が有効になっていれば自動的に立ち上がります。

Q. 接続パスワードをスクリプト内にベタ書きしたくありません。 A. Oracle Walletを使用することで、パスワードを隠蔽できます。事前にAliasを作成し、connect https://... deployment ... as <alias> の形式で接続してください。

Q. info all でステータスが ABENDED になりました。 A. 異常終了しています。view report <process_name> で直近のエラーを確認してください。再起動を試みる前に、原因（DB停止、ネットワーク断、証跡ファイル破損など）を取り除く必要があります。

Q. ggsci コマンドは使えませんか？ A. Microservices Architecture (MA) では adminclient が ggsci の後継となるCLIです。ggsci はClassic Architecture用のコマンドのため、23ai環境では原則使用しません（または機能が制限されます）。

6. まとめ

GoldenGate 23ai の運用において最も重要なポイントは以下の3点です。

起動順序を守る: 常に Service Manager (OS層) $\rightarrow$ Deployment (ミドルウェア層) $\rightarrow$ Processes (アプリ層) の順で起動します。停止時はこの逆順です。
適切な権限管理: root 作業を最小限にし、sudoers を活用して oracle ユーザーのみで定常運用が完結する環境を構築します。
adminclientの活用: WebUIだけでなく、adminclient によるCLI操作に慣れることで、作業の記録（ログ）が残りやすく、スクリプト化による自動化も容易になります。

本ガイドの手順を遵守することで、安定したデータ連携基盤の運用が可能となります。

[参考]
Service Managerの起動および停止

💰 【PR】Oracleエンジニアの市場価値、調べてみませんか？

▶ テックゴー｜IT転職エージェントの無料キャリア面談