デベロッパー サービス ポータル v. 4.17.05
ここでは、既存の Apigee デベロッパー チャネル サービスをアップグレードする方法について説明します。 説明します。
<ph type="x-smartling-placeholder">で確認できます。正しいアップデート手順の決定
ポータルの更新手順は、現在のインストール環境によって異なります。
- インストール環境でシステムの Apache/MySQL または Apache/MariaDB が使用されている場合は、 4.17.01 に更新してから、アップグレード .tar ファイルを使用する方法
- 新しい 4.17.01 以降の Nginx/Postgres を使用している場合、 インストールしてから、ポータルのアップグレード 確認します。
判断中 現在のインストール タイプ
現在のインストール タイプがわからない場合は、次のコマンドを使用して確認します。 説明します。
- ls /opt
Nginx/Postgres を使用している場合は、/opt/apigee と /opt/nginx のディレクトリが表示されます。
Apache/MySQL または Apache/MariaDB を使用している場合、これらのディレクトリを できます。 - /opt/apigee/apigee-service/bin/apigee-all
ステータス
Nginx/Postgres を使用している場合、次の出力が表示されます。
+ apigee-service apigee-drupal-devportal のステータス
OK: apigee-drupal-devportal が稼働しています
+ apigee-service apigee-lb のステータス
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql のステータス
apigee-service: apigee-postgresql: OK - apachectl -S
Apache/MySQL または Apache/MariaDB を使用している場合、このコマンドを実行すると、 ポータルのルート ディレクトリ。形式は
です。
*:80 192.168.56.102 です。 (/etc/httpd/conf/vhosts/devportal.conf:1)
デフォルトのインストール ディレクトリ
アップグレード プロセスは、デベロッパー ポータルが次の場所にインストールされたことを前提としています。
- /opt/apigee/apigee-drupal (Nginx)
- /var/www/html（Apache）
ポータルをデフォルト ディレクトリにインストールしていない場合は、手順のパスを変更します。 インストール ディレクトリを使用します。
インストール ディレクトリがわからない場合は、よく使用される Drush コマンドの説明に沿って確認できます。
新規 新しい 4.17.01 から Nginx/Postgres を更新した後のデフォルトのインストール ディレクトリ 設置
Nginx/Postgres を使用する 4.17.01 の新規インストールを更新すると、ルート ディレクトリ 変更前:
/opt/apigee/apigee-drupal
これを、次のように変更します。
/opt/apigee/apigee-drupal/wwwroot
サポートされているアップグレード バージョン
このアップグレード手順は、次のバージョンのポータルでサポートされています。
- pantheon-14.02.x
- pantheon-14.03.x
- pantheon-14.04.x
- pantheon-14.07.x
- pantheon-15-01.x
- OPDK-15-04.x
- OPDK-15-07.x
- OPDK-16-01.x
- OPDK-16-05.x
- OPDK-16-09.x
- OPDK-17-01.x
ポータルのバージョンを確認するには、ブラウザで次の URL を開きます。
http://yourportal.com/buildInfo
更新する前に
既存のインストールで、Drupal コアまたはカスタム以外の 変更内容は上書きされます。この変更には、特に .htaccess にアクセスした可能性もあります。 /sites ディレクトリの外部はすべて Drupal が所有していると想定してください。「 robots.txt は例外です。このファイルがウェブに存在するかどうか そのまま保持されます。
インストールに進む前に、Drupal ウェブルート全体のバックアップを作成してください。 されます。以下のインストール手順を実施したら、 カスタマイズを実行します。
.tar ファイルを使用したポータルのアップグレード
- Drupal MySQL/MariaDB インスタンスをバックアップします。
詳細については、http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ をご覧ください。 <ph type="x-smartling-placeholder">- </ph>
- オプション 1: Drush を使用する
Drush コマンド sql-dump データベースのコピーを作成します。Drupal ディレクトリ（デフォルトでは /var/www/html）から、 コマンド:
>drush sql-dump > /path/to/backup_dir/database-backup.sql
次の場合は drush help sql-dump を使用します。 ご確認ください。 - オプション 2: MySQLdump を使用する
mysqldump コマンドを使用します。 データベースのコピーを作成するには:
mysqldump -u ユーザー名 -p'パスワード'データベース名 > /path/to/backup_dir/database-backup.sql
-p オプションとパスワードの間にはスペースを入れないでください。独身 パスワードに特殊文字が含まれている場合は、パスワードを引用符で囲む必要があります。
USERNAME と DATABASENAME を設定します。 。デフォルトでは、両方とも開発ポータルです。
- オプション 1: Drush を使用する
- Drupal ウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、 インストール時に変更されています。
- デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar をダウンロードします。
ファイル（ftp.apigee.com）からファイルを取得します。ここで、x.y.z
ポータルのバージョン番号に対応します。プロンプトが表示されたら、受け取った認証情報を入力します。
Apigee からデプロイできます。
ファイルは、ブラウザで Apigee から送られてきたリンクからダウンロードするか、ファイルをコピーしてダウンロードすることができます。 これを次の cURL コマンドに追加します。
>curl -kOL <リンクを貼り付ける here>
注: 外部インターネット接続のないサーバー上にポータルがある場合、 この手順はアクセス権のあるサーバーで実行してください。
Apigee Edge サポートに移動します。 [Login to your Support Portal] を選択して Developer Channel をリクエストします サービス アップグレード用の .tar ファイル。サポート ポータルのアカウントがない場合は、[ サポート ポータルにログインし、ログインページで [ 急いでいるの？こちらからサポート チケットを送信してください。 -
インターネットに接続されているサーバーでアップグレードを行う場合:
<ph type="x-smartling-placeholder">
- </ph>
- ポータルのアップグレード ファイルを抽出します。
>tar -xvf <tar file>
このコマンドの抽出により、DeveloperServices-4.x.y.z という新しいディレクトリが作成されます。 - DeveloperServices-4.x.y.z に変更します。 されます。
- 次のコマンドを使用して、Drupal の最新バージョンをダウンロードします。
>drush dl drupal
このコマンドは、drupal-x.y という名前のディレクトリを作成します。ここで、x.y は現在の 表示する必要があります。 - networked-update.sh スクリプトを実行します。
> ./networked-update.sh
ファイルの権限によっては、このコマンドの実行に sudo を使用するか、 できます。 - Drupal の更新通知を受け取るには、Drupal Update Manager が
有効になります。Drupal メニューで [Modules] を選択し、下にスクロールして、
アップデート マネージャー モジュールをご覧ください。有効になっていない場合は有効にします。
有効にした後は、[レポート >使用可能 [Updates] メニュー項目。
[レポート >利用可能なアップデート >[設定] メニュー項目で 更新が利用可能になったときにメールで通知するようにモジュールを構成し、 アップデートを確認しています。
- ポータルのアップグレード ファイルを抽出します。
-
インターネットに接続していないサーバーでアップグレードを行う場合:
<ph type="x-smartling-placeholder">
- </ph>
- デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードしたサーバーで、次の操作を行います。
ポータルのアップグレード ファイルを抽出します。
>tar -xvf <tar file>
このコマンドの抽出により、DeveloperServices-4.x.y.z という新しいディレクトリが作成されます。 - DeveloperServices-4.x.y.z に変更します。 されます。
- non-networked-update.sh スクリプトを実行します。
> ./non-networked-update.sh
ファイルの権限によっては、このコマンドの実行に sudo を使用するか、 できます。
このコマンドは、必要なアップデート ファイルをすべてダウンロードし、1 つのファイルにパッケージ化します。 devportal-update.tgz という名前の 選択した場所にファイルを書き込みます。 - devportal-update.tgz をターゲットとしてコピーする
ポータルを実行するサーバーです
注: devportal-update.tgz をアプリケーションのウェブルートにはコピーしないでください。 作成されます。 - devportal-update.tgz ファイルを
現在のディレクトリ:
>tar -xzf /path/to/devportal-update.tgz - developer-update ディレクトリに移動します。
- 次のコマンドを実行して、アップデートをインストールします。
> ./install-update.sh - 画面の指示に沿って操作します。
- デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードしたサーバーで、次の操作を行います。
ポータルのアップグレード ファイルを抽出します。
これでアップグレードが完了しました。
RPM を使用してポータルをアップグレードする
ノードのポータル RPM を更新するには、次の操作を行います。
- 次のコマンドを実行して、Drupal ディレクトリ /opt/apigee/apigee-drupal に移動します。
デフォルト:
> cd /opt/apigee/apigee-drupal - Drupal データベース インスタンスをバックアップします。pg_dump コマンドを実行すると、
データベース:
pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
ここで- dbname には、 ポータルの PG_NAME プロパティで指定されたデータベース名 インストール構成ファイルを作成します。
- host は、IP アドレスまたは IP アドレス ポータルノードのアドレスです。
- username には、以下を指定します。 ポータルがデータベースにアクセスするために使用する Postgres ユーザー名（ DRUPAL_PG_USER プロパティ（ インストール構成ファイルを作成します。
- 環境変数の DRUPAL_PG_PASS プロパティで定義されている Postgres ユーザーのパスワードの入力を求められます。 インストール構成ファイルを作成します。
後でバックアップから復元する必要がある場合は、次のコマンドを使用します。
pg_restore --clean --dbname=devportal --host=localhost --username=apigee </tmp/portal.dmp - Drupal ウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所
/opt/apigee/apigee-drupal
変更した可能性があります。
このディレクトリの場所が不明な場合は、drush status コマンドまたは 設定 >メディア >[File] エントリで Drupal のメニューを開き、 パブリック ファイル システムとプライベート ファイル システムのパスの場所（次の ステップ）。 - /opt/apigee/data/apigee-drupal-devportal/private にあるファイルのバックアップを作成します。
- インストール Edge apigee-setup ユーティリティをご覧ください。
-
インターネットに接続されているサーバーでアップグレードを行う場合:
<ph type="x-smartling-placeholder">
- </ph>
- Edge 4.17.05 の bootstrap_4.17.05.sh ファイルを次の場所にダウンロードします。
/tmp/bootstrap_4.17.05.sh:
>curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh - Edge 4.17.05 の apigee-service ユーティリティをインストールし、
依存関係:
>sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uNameuName apigeepassword=pWord
ここで、uName:pWord は、 ApigeepWord を省略すると、パスワードの入力を求められます。
デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。こちらの 「C」Java をインストールせずに続行するオプションを選択できます。
- Edge 4.17.05 の bootstrap_4.17.05.sh ファイルを次の場所にダウンロードします。
/tmp/bootstrap_4.17.05.sh:
-
インターネットに接続していないサーバーでアップグレードを行う場合:
<ph type="x-smartling-placeholder">
- </ph>
- 「ローカルの Apigee リポジトリを作成する」の説明に沿って、ローカルに 4.17.05 リポジトリを作成する
Edge apigee-setup をインストールする
ユーティリティです。
注: 既存の 4.17.01 リポジトリがある場合は、 「ローカルの Apigee リポジトリを更新する」の説明に沿って 4.17.05 リポジトリをこのフォルダに移動します。Edge apigee-setup ユーティリティのインストールをご覧ください。 -
.tar ファイルから apigee-service をインストールするには:
<ph type="x-smartling-placeholder">
- </ph>
- ローカル リポジトリがあるノードで、次のコマンドを使用してローカル リポジトリをパッケージ化します。
リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz という名前の単一の.tar ファイルに変換します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror パッケージ - Edge を更新するノードに .tar ファイルをコピーします。たとえば、 /tmp ディレクトリに移動します。 作成されます。
- 新しいノードで、ファイルを /tmp ディレクトリに展開します。
>tar -xzf apigee-4.17.05.tar.gz
このコマンドを実行すると、.tar が含まれるディレクトリに repos という新しいディレクトリが作成されます 表示されます。例: /tmp/repos - Edge apigee-service ユーティリティをインストールします。
/tmp/repos からの依存関係:
>sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
このコマンドには、Repo ディレクトリのパスが含まれています。
- ローカル リポジトリがあるノードで、次のコマンドを使用してローカル リポジトリをパッケージ化します。
リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz という名前の単一の.tar ファイルに変換します。
-
Nginx ウェブサーバーを使用して apigee-service をインストールするには:
<ph type="x-smartling-placeholder">
- </ph>
- 「 Nginx ウェブサーバー」Edge のインストール apigee-setup ユーティリティを実行します。
- リモートノードで、Edge の bootstrap_4.17.05.sh ファイルを次の場所にダウンロードします。
/tmp/bootstrap_4.17.05.sh:
>/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
ここで、uName:pWord は上記で設定したユーザー名とパスワードです。 remoteRepo は、リポジトリの IP アドレスまたは DNS 名です。 移動します - リモートノードで Edge apigee-service ユーティリティをインストールし、
依存関係:
>sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
ここで、uName:pWord はリポジトリのユーザー名とパスワードです。
- 「ローカルの Apigee リポジトリを作成する」の説明に沿って、ローカルに 4.17.05 リポジトリを作成する
Edge apigee-setup をインストールする
ユーティリティです。
- apigee-service を使用して以下を行います。
apigee-setup を更新する
ユーティリティ:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup の更新 - ノードで更新ユーティリティを実行して、Postgres データベースを更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
ここで、configFile は、インストールに使用した構成ファイルです。 Postgres データベースです構成ファイルに対する唯一の要件は、構成が 「apigee」がファイルにアクセスまたは読み取り可能にするできます。 - Postgres を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - ノードで update ユーティリティを実行してポータルを更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
ここで、configFile は、インストールに使用した構成ファイルです。 必要があります。構成ファイルに対する唯一の要件は、 「apigee」がアクセスまたは読み取りできるできます。
更新後のルート ディレクトリは次のようになります。
/opt/apigee/apigee-drupal/wwwroot
これでアップグレードが完了しました。