Amazon RDS for OracleでのAPEX環境作成

Copyright © 2018, Oracle and/or its affiliates. All rights reserved.
| Amazon RDS for OracleでのAPEX環境作成 AWSのアカウントだけ作成した状態から、できるだけ簡単にAPEX環境を作る Oracle APEX 19.1 – ORDS 19.2 対応版中越祐治 APEX User Group@東京日本オラクル株式会社 2019年8月26日

| アジェンダ Amazon RDS for Oracleの構成必要なファイルのダウンロード APEXとORDSの構成 1 2 3

| アジェンダ Amazon RDS for Oracleの構成必要なファイルのダウンロード APEXとORDSの追加構成 1 2 3

| 構成図と作業手順 Elastic IP address Amazon EC2 Amazon VPC* Internet gateway Oracle DB instance route table 9. キーペアの作成 11. Elastic IPの割り当て 1. VPCの作成 2. サブネットの作成 x 3 oracleapex-vpc(10.0.0.0/16) ap-subnet(10.0.0.0/24) db-subnet1(10.0.1.0/24) db-subnet2(10.0.2.0/24) Multi-AZ構成はとらないがサブネットグループを作成するために必要 3. インターネットゲートウェイの作成 4. ルートテーブルの作成 5. セキュリティグループの事前作成 x 2 6. DBサブネットグループの作成 oracleapexdbnet 7. オプショングループの作成 8. DBインスタンスの作成 10. EC2インスタンスの作成

| VPCダッシュボード 1. VPCの作成 2. サブネットの作成（全３つ） 3. インターネットゲートウェイの作成 4. ルートテーブルの作成 5. セキュリティグループの事前作成 11. Elastic IPの割り当て以下の作業はVPCダッシュボードから行う

| VPCの作成名前タグ: oracleapex-vpc IPv4 CIDRブロック: 10.0.0.0/16

| サブネットの作成名前タグ: ap-subnet VPC: 前に作成したVPCを選ぶアベイラビリティ・ゾーン: どれかを選ぶ IPv4 CIDRブロック: 10.0.0.0/24 名前タグ: db-subnet1 VPC: 前に作成したVPCを選ぶアベイラビリティ・ゾーン: ap-subnetと同じゾーンを選ぶ IPv4 CIDRブロック: 10.0.1.0/24 名前タグ: db-subnet2 VPC: 前に作成したVPCを選ぶアベイラビリティ・ゾーン: ap-subnet, db- subnet1と異なるゾーンを選ぶ IPv4 CIDRブロック: 10.0.2.0/24

| インターネットゲートウェイの作成 Nameタグ: oracleapex-igw “アクション”から”VPCにアタッチ”を選ぶ。作成済みのVPCにアタッチする。

| ルートテーブルの作成 Nameタグ: oracleapex-rtbl VPCは前に作成したものを指定する “ルートの編集”をクリックし、送信先 0.0.0.0/0、ターゲットとして先に作成したインターネットゲートウェイを指定する “サブネットの関連付けの編集”をクリックし、 ap-subnetに関連づける

| セキュリティグループの作成グループ名: ap-secgroup およびグループ名: db-secgroup のふたつのセキュリティグループを作成する。 VPCは前に作成したものを指定する。説明は自由。 db-secgroupのインバウンド・ルールとして、 Oracle-RDSを追加する。ソースはカスタムを選んで、ap-secgroup(のグループID)を入力する。 ap-secgroupのインバウンド・ルールとして、カスタムTCPルールとして、ポート範囲8080の指定と、SSHの２行を追加する。ソースは任意の場所を選ぶ。

| RDSダッシュボード 6. サブネットグループの作成 7. オプショングループの作成 8. インスタンスの作成以下の作業はRDSダッシュボードから行う

| DBサブネットグループの作成名前: oracleapexdbnet VPCは前に作成したものを指定する。アベイラビリティゾーンの異なるサブネットが２つだけの状態にする。一つ目 AZ: us-east-2a CIDRブロック: 10.0.1.0/24 二つ目 AZ: us-east-2b CIDRブロック: 10.0.2.0/24 ”サブネットを追加します。” をクリックして追加するか、不要なサブネットを削除する。サブネットを登録して作成

| オプショングループの作成名前: oracle-se2-12-1-apex-191 エンジン: oracle-se2 メジャーエンジンのバージョン: 12.1 と名前: oracle-se2-12-2-apex-191 エンジン: oracle-se2 メジャーエンジンのバージョン: 12.2 ふたつのオプショングループを作成する。最初にオプション: APEX バージョン: 19.1.v1 を選んで追加する。新規インスタンスに使うので、すぐに適用するは”はい”にする。次にオプション: APEX-DEV を選んで追加する。新規インスタンスに使うので、すぐに適用するは”はい”にする。作成したふたつのグループそれぞれにオプションを追加する。 *) 12.2は無償枠のインスタンスとして指定できないため、本手順ではDBを12.1で作成します。

| DBインスタンスの作成 – Oracleの選択エディションはなんでもあっても、APEXは利用可能です。

| DB詳細の指定適切なライセンスモデルを選択する作成したオプショングループと互換のあるバージョンを選択する。今回は12.1.を選択する。 RDS無料利用枠の対象オプションのみを有効化にチェックを入れると、以下は自動的に決まる。 OracleのSIDとは異なる単なる名前。 APEXを構成する際にsqlplusでインスタンスに接続する。その際に使用するユーザー名とパスワードになる。 DBの接続ユーザー

| 詳細設定作成済みのものを選ぶ作成済みのものを選ぶパブリックアクセシビリティは不要 AZはdb-subnet1が含まれるものを指定する既存のVPCセキュリティグループとして”db-secgroup”を割り当てる OpracleのSIDを指定デフォルトの1521は変更しないパラメータグループはデフォルト値を使用する新規に登録したAPEXを含むオプショングループを指定する文字セットの“AL32UTF8” は変更しないそれ以外の設定は自由に行えます DBのSID

| DBインスタンスの作成 – 完了作成開始作成完了一旦作成が完了するが、すぐにAPEXの適用が始まり、変更中になる。変更が完了すると、再度、利用可能になる。インスタンスの情報ページから、接続情報を確認しておく。 DBのホスト名

| EC2ダッシュボード 9. キーペアの作成 10. EC2インスタンスの作成 11. Elastic IPの割り当て以下の作業はEC2ダッシュボードから行う

| キーペアの作成キーペア名: myaws として、作成する。ブラウザから”myaws.pem”というファイルがダウンロードされます。このファイルを使用して、EC2のインスタンスにSSH接続を行います。 ※) キーペアを手元で作成して、”キーペアのインポート”を行う方が望ましい操作です。

| EC2インスタンスの作成(1) インスタンスタイプは無料枠の範囲で、t2.microを選んだ。もちろん、もっと大きいのを選んでもよい。 AMIの選択はRedHat系で、Amazon のサポートが受けられるAmazon Linuxを選ぶ。 RedHatを選んでも良いが、後の Javaのインストールなどの手順が変わる。インスタンスの詳細の設定にて、 VPCはoracleapex-vpc、サブネットは ap-subnetが指定されていることを確認する。他の設定は変更不要。

| EC2インスタンスの作成(2) ストレージは追加しないので、そのまま、次の手順へ進む。タグは追加しないので、そのまま、次の手順へ進む。既存のセキュリティグループとしてap-secgroupを割り当てる。

| EC2インスタンスの作成(3) 既存のキーペア”myaws”を選択し、”選択した…”の説明にチェックを入れる。インスタンスが作成され、インスタンスの状態が”running”になり、ステータスチェックに合格する。

| Elastic IPの割り当て割り当たるIPアドレスは、それぞれ異なります。 APEXに接続するIPアドレス

| アドレスの関連付けアドレスを選択し、アクションメニューからアドレスの関連付けを実行する。リソースタイプとして、インスタンスを選択し、先ほど作成した EC2インスタンスを選ぶ。プライベートIPとして、選択したインスタンスに割りついているものを選ぶ。今回はひとつだけなので、それを選ぶ。関連付けの完了

| 接続方法の確認今までの手順で、AWS側の構成はすべて完了インスタンスをひとつ選択し、接続をクリックする。 IPアドレス、プライベートキーファイルは環境を反映しているので、コマンドはそのまま使えるはず。

| APEXの構成に必要なファイル • APEX 19.1 のアーカイブ – apex_19.1.zip • 最新のORDSのアーカイブ – ords-19.2.0.199.1647.zip • 最新のインスタント・クライアント – basicとsqlplus – oracle-instantclient19.3-sqlplus-19.3.0.0.0-1.x86_64.rpm – oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm

| APEX 19.1 All Languagesのダウンロード https://www.oracle.com/tools/downloads/apex-v191-downloads.html Oracle APEX 19.1 – All languagesをダウンロードする

| ORDSのダウンロード https://www.oracle.com/database/technologies/appdev/rest-data-services-v192-downloads.html Oracle REST Data Servicesをダウンロードする

| 全アーカイブをec2-userにてアップロード • ORDSを動作させるために作成したEC2インスタンスにアップロードする。IP アドレスはElastic IPとして割り当てられたアドレスを使う。 $ scp ords-19.2.0.199.1647.zip apex_19.1.zip ec2-user@<ec2のIPアドレス>: ords-19.2.0.199.1647.zip 100% 58MB 3.2MB/s 00:18 apex_19.1.zip 100% 144MB 5.7MB/s 00:25 $

| インスタントクライアントのインストール $ sudo yum localinstall https://download.oracle.com/otn_software/linux/instantclient/193000 /oracle-instantclient19.3-sqlplus-19.3.0.0.0-1.x86_64.rpm https://download.oracle.com/otn_s oftware/linux/instantclient/193000/oracle-instantclient19.3-basic-19.3.0.0.0-1.x86_64.rpm 「中略] 合計容量: 228 M インストール容量: 228 M Is this ok [y/d/N]: y 「中略] Running transaction インストール中 : oracle-instantclient19.3-basic-19.3.0.0.0-1.x 1/2 インストール中 : oracle-instantclient19.3-sqlplus-19.3.0.0.0-1 2/2 検証中 : oracle-instantclient19.3-basic-19.3.0.0.0-1.x 1/2 検証中 : oracle-instantclient19.3-sqlplus-19.3.0.0.0-1 2/2 インストール: oracle-instantclient19.3-basic.x86_64 0:19.3.0.0.0-1 oracle-instantclient19.3-sqlplus.x86_64 0:19.3.0.0.0-1 完了しました! $ ２つあるrpmをyum localinstall コマンドでインストールする。

| APEXとORDSの展開 $ unzip apex_19.1.zip [./apex以下に展開されます] $ unzip ords-19.2.0.199.1647.zip [./index.html, ./docs, ./examples, ./params, ./ords.warが展開されます] $ ln –s /usr/lib/oracle/18.5/client64/bin $ ln –s /usr/lib/oracle/18.5/client64/lib /home/ec2-userをORACLE_HOMEとして扱う前提でAPEXとORDSを展開し、インスタントクライアントのbinとlibへのシンボリックリンクを作成する。

| Javaのインストール $ sudo yum install java-11-amazon-corretto 読み込んだプラグイン:extras_suggestions, langpacks, priorities, update-motd [中略] 総ダウンロード容量: 168 M インストール容量: 321 M Is this ok [y/d/N]: y Downloading packages: (1/27): dejavu-fonts-common-2.33-6.amzn2.noarch.rpm | 64 kB 00:00 「中略] インストール: java-11-amazon-corretto.x86_64 1:11.0.3+7-1.amzn2 「中略] 完了しました! $ Java 11 Amazon Correttoをyum install コマンドでインストールする。

| 環境変数の設定 export ORACLE_HOME=$HOME export PATH=$ORACLE_HOME/bin:$PATH export NLS_LANG=American_America.AL32UTF8 export LD_LIBRARY_PATH=$ORACLE_HOME/lib 以下の環境変数を設定する。~/.bashrcに記載するとよい。

| 日本語リソースのインストール $ cd ~/apex $ sqlplus <マスターユーザー>/<パスワード>@<DBホスト名>/<SID> [中略] SQL> alter session set current_schema=APEX_190100; Session altered. SQL> @load_trans JAPANESE Session altered. Installing Application Express translation – JAPANESE [中略] Adjust instance settings PL/SQL procedure successfully completed. SQL> exit $ sqlplusでDBに接続する際には、マスターユーザーで接続する。

| ORDSをインストールするためのRDS独自構成 $ sqlplus <マスターユーザー>/<パスワード>@<DBホスト名>/<SID> [中略] SQL> alter user APEX_PUBLIC_USER identified by <パスワード>; User altered. SQL> alter user APEX_PUBLIC_USER account unlock; User altered. SQL> exec rdsadmin.rdsadmin_run_apex_rest_config('<パスワード>','<パスワード>'); PL/SQL procedure successfully completed. SQL> exec rdsadmin.rdsadmin_util.grant_apex_admin_role; PL/SQL procedure successfully completed. SQL> grant apex_administrator_role to orclapex; Grant succeeded. [次ページへ継続] Amazon RDSの以下の資料に従った作業をおこなう。(Englishを参照すること) https://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/Appendix.Oracle.Options.APEX.html パスワードの設定を３つの異なるアカウントに行うが、全部同じで設定するのが良いでしょう。 ORDSの構成に使います。

| APEXの管理者情報の設定 SQL> @/home/ec2-user/apex/apxchpwd.sql ================================================================================ This script can be used to change the password of an Application Express instance administrator. If the user does not yet exist, a user record will be created. ================================================================================ Enter the administrator's username [ADMIN] User "ADMIN" exists. Enter ADMIN's email [ADMIN] Enter ADMIN's password [] Changed password of instance administrator ADMIN. SQL> exit Disconnected from Oracle Database 12c Standard Edition Release 12.1.0.2.0 - 64bit $ ほとんどデフォルトの設定を行なっています。それぞれ、適切に変更してください。

| ORDSインストール・ユーザーの構成 exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'master_user', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'master_user', 'EXECUTE', true); マスター・ユーザーにてORDSのセットアップを行うため、必要な権限を割り与える。マスター・ユーザーは大文字で指定する。最後のWPIUTLのEXECUTE権限は、AWSのマニュアルに記載がなく、ORDS 19.2 のセットアップの際に追加で必要だった。

| 接続先データベースの設定 $ java -jar ords.war setup このOracle REST Data Servicesインスタンスはまだ構成されていません。次のプロンプトを完了してください構成データを格納する場所を入力してください:conf データベース・サーバーの名前を入力してください [localhost]:<DBホスト名> データベースのリスニング・ポートを入力してください [1521]: データベース・サービス名を指定するには1を、データベースSIDを指定するには2を入力してください [1]:2 データベースSIDを入力してください [xe]:ORCL [次ページへ継続] SIDで指定するので”2”を選択します。

| ORDS_METADATAスキーマのインストール Oracle REST Data Servicesスキーマを確認/インストールする場合は1を、このステップをスキップする場合は2を入力してください [1]:1 ORDS_PUBLIC_USERのデータベース・パスワードを入力してください: <パスワード> パスワードの確認: <パスワード> Oracle REST Data Servicesスキーマを確認するには、SYS AS SYSDBAが必要です。 Enter the administrator username: <マスターユーザー> orclapexのデータベース・パスワードを入力してください: <マスターユーザーのパスワード> パスワードの確認: <マスターユーザーのパスワード> 情報の取得中. Enter the default tablespace for ORDS_METADATA [SYSAUX]: <デフォルトを選択> Enter the temporary tablespace for ORDS_METADATA [TEMP]: <デフォルトを選択> Enter the default tablespace for ORDS_PUBLIC_USER [USERS]: <デフォルトを選択> Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP]: <デフォルトを選択> [次ページへ継続]

| ORDSコネクション・プールの設定 PL/SQLゲートウェイを使用する場合は1を、このステップをスキップする場合は2を入力してください Oracle Application Expressを使用しているかmod_plsqlから移行する場合は、1を入力する必要があります [1]: PL/SQLゲートウェイ・データベースのユーザー名を入力してください [APEX_PUBLIC_USER]: APEX_PUBLIC_USERのデータベース・パスワードを入力してください: <パスワード> パスワードの確認: <パスワード> Application Express RESTfulサービスのデータベース・ユーザー(APEX_LISTENER, APEX_REST_PUBLIC_USER)にパスワードを使用するには1を、このステップをスキップするには2を入力してください [1]:2 8月 20, 2019 2:44:31 午前情報: reloaded pools: [|apex||, |apex|pu|] [中略] ... データベース前提条件を確認しました ... Oracle REST Data Servicesプロキシ・ユーザーを作成しました ... Oracle REST Data Servicesスキーマを作成しました ... Oracle REST Data Servicesに権限を付与しました ... Oracle REST Data Servicesデータベース・オブジェクトを作成しました [中略] Oracle REST Data Servicesバージョン19.2.0.r1991647のインストールが完了しました。経過時間: 00:00:18.112 $ APEXを使用するので、最初の選択は１。 Application Express RESTfulサービスは使用しないので、次の選択は２。

| ORDSの起動 $ java -jar ords.war [中略] スタンドアロン・モードで起動するには1を、終了するには2を入力してください [1]: APEX静的リソースの場所を入力します:/home/ec2-user/apex/images/ HTTPを使用する場合は1を、HTTPSを使用する場合は2を入力してください [1]: [各種ログ出力] 2019-04-25 10:23:35.626:INFO:oejs.AbstractConnector:main: Started ServerConnector@9597028{HTTP/1.1,[http/1.1, h2c]}{0.0.0.0:8080} 2019-04-25 10:23:35.627:INFO:oejs.Server:main: Started @32757ms スタンドアロン・モード、HTTPで起動する。

| APEX先頭画面と管理画面 http://<Elastic IP>:8080/ords/ apxchpwd.sqlにて設定したユーザー名、パスワードでログインする。

| 静的ファイル・アクセス/REST呼び出しエラーの対応 $ cd $HOME/apex $ sqlplus <マスターユーザー>/<パスワード>@<DBホスト名>/<SID> [中略] SQL> alter user APEX_REST_PUBLIC_USER identified by <パスワード>; User altered. SQL> @apex_rest_config.sql Enter a password for the APEX_LISTENER user [] ******** Enter a password for the APEX_REST_PUBLIC_USER user [] ******** ...set_appun.sql ...create APEX_LISTENER and APEX_REST_PUBLIC_USER users Grant succeeded. [中略] SQL> APEXアクセス時、静的ファイルの構成に問題がある旨が報告されたり、RESTの呼び出しができない状況に対応するために実施した作業。 APEX_REST_PUBLIC_USERのパスワードがrdsadmin.rdsadmin_run_apex_rest_configで設定した値と異なっているため再設定する。 rdsadmin.rdsadmin_run_apex_rest_configの実行で、シノニムが適切に作成されていないようなので、スクリプトの実行によって作成する。パスワードは rdsadmin_run_apex_rest_configにて指定したものを入力する。

| CDNから静的ファイルを取得する $ cd $HOME/apex/utilities $ sqlplus <マスターユーザー>/<パスワード>@<DBホスト名>/<SID> SQL> @reset_image_prefix.sql Enter the Application Express image prefix [/i/] https://static.oracle.com/cdn/apex/19.1.0.00.15/ ...Changing Application Express image prefix NEW_IMAGE_PREFIX ------------------------------------------------ https://static.oracle.com/cdn/apex/18.2.0.00.12/ PL/SQL procedure successfully completed. [中略] Image Prefix update complete @reset_image_prefix.sqlを実行する。指定する値は https://static.oracle.com/cdn/apex/19.1.0.00.15/ ORDSの再起動が必要。

|

Amazon RDS for OracleでのAPEX環境作成

Amazon RDS for OracleでのAPEX環境作成

More Decks by Yuji Nakakoshi

Other Decks in Technology

Featured

Transcript