2.2 GoldenGate Stream Analyticsのインストール

前述のソフトウェア前提条件を確認した後、次のステップに従ってGoldenGate Stream Analytics 26.1.0.0.*をインストールしてください:
  1. OSA-26.1.xxxxxxx.zipを解凍します。
  2. パスをOSA-26.1.0.0.0/osa-base/に変更します。
  3. 「セキュア・パスワードの生成」のステップに従って、セキュアなパスワードを生成します。
  4. GGSAアプリケーションを構成します
    環境変数を設定します。 
    export JAVA_HOME=/to/java/path
export PATH=$JAVA_HOME/bin:$PATH
export SPARK_HOME=/to/spark/path
 
## for the GG change data you need these as well
export KAFKA_HOME=/to/kafka/path
export GGBD_HOME=/to/GGBD/path

    ノート:

    また、OSA-26.1.0.0.0/osa-base/etc/osa/osa-env.shファイルからJAVA_HOMEおよびSPARK_HOMEを編集することもできます。
    1. osa-datasource.xmlの次のフィールドを変更します:
      1. URL (DBのJDBC URL)
      2. ユーザー(metaDBストアとして使用するユーザー)
      3. パスワード(DBユーザーのパスワード)。ここでは、Step 3で生成されたセキュアなパスワードを使用できます。 
        vi OSA-26.1.0.0.0/osa-base/etc/osa-datasource.xml
      Oracle Databaseの例:
      <?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_3.dtd">
 
<!-- =============================================================== -->
<!-- Configure jdbc/OSADataSource data source                        -->
<!-- =============================================================== -->
<Configure id="Server" class="org.eclipse.jetty.server.Server">
    <New id="osads" class="org.eclipse.jetty.plus.jndi.Resource">
        <Arg>
            <Ref refid="wac"/>
        </Arg>
        <Arg>jdbc/OSADataSource</Arg>
        <Arg>
            <New class="oracle.jdbc.pool.OracleDataSource">
                <Set name="DataSourceName">jdbc</Set>
                <Set name="URL">jdbc:oracle:thin:@localhost:1521/XEPDB1</Set>
                <Set name="User">DbUSER</Set>
                <Set name="Password">didi0avGVif0wuGjbXcYVwUiihWU02JPbmVw8cThGrUoLs8A</Set>
                <Set name="connectionCachingEnabled">true</Set>
                <Set name="connectionCacheProperties">
                    <New class="java.util.Properties">
                        <Call name="setProperty">
                            <Arg>MinLimit</Arg>
                            <Arg>1</Arg>
                        </Call>
                        <Call name="setProperty">
                            <Arg>MaxLimit</Arg>
                            <Arg>15</Arg>
                        </Call>
                        <Call name="setProperty">
                            <Arg>InitialLimit</Arg>
                            <Arg>1</Arg>
                        </Call>
                    </New>
                </Set>
            </New>
        </Arg>
    </New>
</Configure>

      ノート:

      ADW/ATPの場合は、DataSourceName を<Set name="DataSourceName">adw</Set>で更新します
      MysqlDBの例:
      <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_3.dtd">
 
<!-- =============================================================== -->
<!-- Configure jdbc/OSADataSource data source            -->
<!-- =============================================================== -->
<Configure id="Server" class="org.eclipse.jetty.server.Server">
        <!--
             -->
  <New id="osads" class="org.eclipse.jetty.plus.jndi.Resource">
    <Arg>
      <Ref refid="wac"/>
    </Arg>
    <Arg>jdbc/OSADataSource</Arg>
    <Arg>
      <New class="com.mysql.cj.jdbc.MysqlConnectionPoolDataSource">
        <Set name="URL">jdbc:mysql://<host>:<port>/<db></Set>
        <Set name="User"></Set>
        <Set name="Password"></Set>
      </New>
    </Arg>
  </New>
 
</Configure>
    2. HTTPS対応APIのSSL証明書を構成します
      1. NEED_SSL: SSLの有効化または無効化
      2. OSA_SERVER_CRT_P12: 既知の認証局による署名付き証明書のパス
      3. OSA_SERVER_CRT_PWD: 暗号化された証明書パスフレーズ。ユーザーはツール./osa-secure-tool.shでこの暗号化されたパスフレーズを生成できます
      4. OSA_SERVER_CRT_GENERATED_BY: 証明書がアプリケーションによって生成されるか、ユーザーによって生成されるかを指定します。
      5. OSA_SERVER_CRT_FAIL_ON_VALIDATIONS: このフラグを設定すると、証明書の検証中に問題が見つかった場合、アプリケーションの起動が失敗します。
    SSL/TLSでのHelidonサーバーの実行の詳細は、「SSL/TLSでのHelidonサーバーの実行」を参照してください。
    vi OSA-26.1.0.0.0/osa-base/etc/osa-ssl/ssl.conf


    HTTPS対応APIのSSL証明書

  5. アプリケーションを起動/停止します
    1. 初めてOSAを起動する場合
      ./start-osa.sh dbroot="SYS AS SYSDBA" dbroot_password="oracle" --proxy=http://www-proxy-hqdc.us.oracle.com:80

      ノート:

      プロキシはオプションです。オンプレミスではない一部のサービス(たとえば、S3)を使用している場合は、パブリック・ネットワークへの接続が必要になることがあります。

      OSA管理のユーザー名とパスワードを指定する必要があります。非常に一般的なパスワードを使用すると、警告が表示されます。(パスワードは、後でOSA UIを使用して変更する必要があります)。

      アプリケーションが起動し、次のURLでOSAアプリケーションにアクセスできます: https://<ip address>:9443/osa/index.html

      ノート:

      ビッグ・データ・ターゲットの場合は、apache-mavenでプロキシを設定する必要があります。 
      vi OSA-26.1.0.0.0/osa-base/apache-maven-3.9.9/conf/setting.xml
      このsetting.xmlファイルに、次の形式でプロキシを追加します:
      <proxy>
      <id>optional</id>
      <active>true</active>
      <protocol>http</protocol>
      <username>proxyuser</username>
      <password>proxypass</password>
      <host>proxy.host.net</host>
      <port>80</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
</proxy>
    2. 停止するには
      ./stop-osa.sh
    3. 再起動するには

      プロキシなし

      ./start-osa.sh

      プロキシあり

      ./start-osa.sh --proxy=http://<proxy-host>:<proxy-port>

2.2.1 セキュア・パスワードの生成

GGSA 26.1では、OSAセキュア・ツールを使用してパスワードを保護します。

パスワードを暗号化するには:

osa-baseの下のbinディレクトリにあるosa-secure-tool.shを使用します。

スクリプトを実行する前に次のコマンドを実行し、JAVA_HOMEを設定してパスに追加してください:
export JAVA_HOME=/to/your/java/location
export PATH=$JAVA_HOME/bin:$PATH
java -version ## Just to verify the java is set properly or not
パスワードを生成するには:
cd OSA-26.1.0.0.0/osa-base/bin
 ./osa-secure-tool.sh <YOUR_PASSWORD>

このツールを初めて使用する場合は、キーの生成に使用するパスワードを設定するよう求められます。キーを生成するためのパスワードの設定

ノート:

OSAセキュア・ツールで保護されたパスワードは、毎回異なります。