Esri arcgis-server-singlemachine-upgrade.template.json Amazon Web Services (AWS) CloudFormation テンプレートは、「CloudFormation を使用した単一コンピューターの ArcGIS Server サイトのデプロイ」で説明したテンプレートを使用して作成された 1 つの Amazon Elastic Compute Cloud (EC2) インスタンス上の ArcGIS Server 10.9、10.9.1、または 11.0 サイトをアップグレードします。
arcgis-server-singlemachine-upgrade.template.json テンプレートは、単一の EC2 インスタンス上で構成された、次のプロダクトをアップグレードします。
- ArcGIS Server
- ArcGIS Web Adaptor
前提条件
CloudFormation テンプレートを実行する前に取得する必要があるアイテム (ファイル、アカウントなど) や、実行する必要があるタスクごとに、前提条件がグループ化されています。
必須アイテム
このテンプレートを実行する前に、次のアイテムが必要です。
- アップグレードするデプロイメントにアクセスできる Amazon Web Services アカウント。
- ArcGIS Server ライセンス。 ライセンス ファイルには、必要なサーバー ライセンス ロール (ArcGIS GIS Server、ArcGIS Image Server、または ArcGIS GeoAnalytics Server) が含まれている必要があります。
- SSL 認証ファイルまたは証明書 (.pfx 形式) およびそれに対応するパスワード 証明書は証明局から取得する必要があります。
- Esri Amazon Web Services CloudFormation テンプレート arcgis-server-singlemachine.template.json を使用して作成した、単一コンピューターの既存の ArcGIS Server サイト。
- CloudFormation アップグレード テンプレートの arcgis-server-singlemachine-upgrade.template.json。
注意:
デプロイメントをアップグレードするには、この CloudFormation アップグレード テンプレートを実行します。これにより、新しい CloudFormation スタックが作成されます。 このテンプレートを使用して、既存のデプロイメントの CloudFormation スタックを更新しないでください。
必須タスク
このテンプレートを実行する前に、次のタスクを実行する必要があります。
- AWS アカウントにデプロイメントの Amazon Simple Storage Service (S3) バケットを準備します。 スタックを起動するときに、テンプレートのバケット名を指定します。
- バケットを作成するか、既存の S3 バケットを使用します。 ユーザーはバケットの所有者でなくてはなりません。
- バケットに ArcGIS ソフトウェア認証情報ファイルをアップロードします。
- SSL 証明書ファイルをデプロイメント バケットにアップロードします。
- AWS Secrets Manager でのパスワードの構成 (オプション、推奨)
サイト管理者のユーザー名や Windows の arcgis ユーザーのパスワードなどのアカウントのパスワードは、AWS Secrets Manager で構成できます。 これにより、シークレットの Amazon Resource Name (ARN) が提供されます。 スタックを起動するときに、テンプレートのパラメーターにパスワードの代わりに ARN を使用します。 パスワードの格納に AWS Secrets Manager を使用しない場合は、スタックの起動時にテンプレートのパラメーターにパスワードをプレーン テキストで入力する必要があります。
注意:
Esri CloudFormation テンプレートで使用するパスワードのために AWS Secrets Manager でシークレットの ARN を作成する場合、シークレット タイプに [Other type of secrets (他の種類のシークレット)] を使用し、[Plaintext (プレーンテキスト)] オプションを使用する必要があります。 パスワード用の Amazon Resource Name を作成する方法については、「AWS CloudFormation および ArcGIS」をご参照ください。
ヒント:
デフォルトでは、スタックの作成に失敗すると、CloudFormation は部分的に作成されたリソースを削除します。 これにより、使用できないデプロイメントがアカウントから削除されるため便利ですが、トラブルシューティングが難しくなる可能性もあります。 スタックを失敗した状態で保持するには、スタックを起動する前に CloudFormation スタック作成オプションの [Rollback on failure (失敗時にロールバックする)] を無効にします。 詳細については、AWS ヘルプの「Setting AWS CloudFormation options (AWS CloudFormation オプションの設定)」をご参照ください。
パラメーター
この CloudFormation テンプレートで使用されるパラメーターの説明については、次の表をご参照ください。 表はパラメーターのタイプ別に分けられています。
ArcGIS Server Configuration
| パラメーター名 | 必須 | パラメーターの説明 |
|---|---|---|
Platform Type | 必須 | 既存の ArcGIS Server サイトのプラットフォーム タイプを選択します。
|
ArcGIS Server EC2 インスタンス ID | 必須 | 既存の ArcGIS Server サイトの EC2 インスタンスの ID を選択します。 既存のサイトが、Esri CloudFormation テンプレートまたは Cloud Builder を使用して作成されている場合は、AWS Management Console の既存の CloudFormation スタックの [リソース] セクションでインスタンス ID を確認できます。 リソースの論理 ID は [ArcGISServerEC2Instance] です。 |
Deployment Bucket Name | 必須 | ソフトウェア ライセンス ファイルと SSL 証明書を含む Amazon S3 バケットの名前を指定します。 このバケットがすでに存在することと、配置用のライセンス ファイルおよび SSL 証明書が含まれていることが必要です。 ユーザーはバケットの所有者でなくてはならず、バケットは配置と同じ AWS アカウントにある必要があります。 |
License File Name | 必須 | ArcGIS Server 認証ファイル オブジェクト キー名を指定します。 このスタックを起動する前に、デプロイメント バケットにライセンス ファイル (.ecp または .prvc) をアップロードする必要があります。 Amazon S3 コンソールの配置バケット内にあるファイルを参照することで、ファイル オブジェクト キー名を取得できます。 たとえば、server.prvc や resources/licenses/server/server.prvc などがあります。 ライセンス ファイル名では大文字と小文字が区別されます。 正しい名前を、大文字と小文字の区別を付けて入力します。 |
Site Administrator User Name | 必須 | 既存サイトの ArcGIS Server プライマリ サイト管理者のユーザー名を指定します。 |
Site Administrator User Password | 必須 | 既存サイトの ArcGIS Server プライマリ サイト管理者のパスワードを指定します。 プレーン テキストのパスワードを入力することも、AWS Secrets Manager のシークレット ID の ARN を入力することもできます。 |
Windows arcgis user password | 条件 | このパスワードは、Windows に配置した場合にのみ必須です。 既存の配置の arcgis ユーザーのパスワードを指定します。 プレーン テキストのパスワードを入力することも、AWS Secrets Manager のシークレット ID の ARN を入力することもできます。 パスワードは AWS Secrets Manager で管理することをお勧めします。 パスワード用の Amazon Resource Name を作成する方法については、「AWS CloudFormation および ArcGIS」をご参照ください。 |
Site Domain Name | 必須 | 既存の ArcGIS Server サイトの完全修飾ドメイン名を指定します。 |
Web Adaptor Name | オプション | 既存の ArcGIS Server サイトのサーバーの Web Adaptor の名前を指定します。 既存の配置の作成時にポータルの Web Adaptor 名を指定しなかった場合、このパラメーターは空のままにしておきます。 |
SSL Certificate File Name | オプション | 証明機関から取得した SSL 証明書 (*.pfx ファイル) を指定します。 既存の配置の作成時に使用したのと同じ (または更新した) SSL 証明書を使用します。 このスタックを起動する前に、配置バケットに証明書をアップロードする必要があります。 AWS S3 コンソールの配置バケット内にあるファイルを参照することで、ファイル オブジェクト キー名を取得できます (domainname.pfx や resources/sslcerts/domainname.pfx など)。 既存の配置の作成時に SSL 証明書ファイル名を指定しなかった場合、このパラメーターは空のままにしておきます。 |
SSL 証明書のパスワード | 条件 | SSL 証明書のパスワードを指定します。 プレーン テキストのパスワードを入力することも、AWS Secrets Manager のシークレット ID の ARN を入力することもできます。 パスワード用の Amazon Resource Name を作成する方法については、「AWS CloudFormation および ArcGIS」をご参照ください。 SSL 証明書ファイル名の値を指定しなかった場合、このパラメーターは空のままにしておきます。 |
出力
スタックの作成が成功した場合は、AWS Management Console の CloudFormation スタックの [Outputs (出力)] タブに、次の出力パラメーターが表示されます。
| 出力名 | 出力の説明 |
|---|---|
ServerManagerDirURL | |
ServerRestDirURL | |
ServerAdminDirURL | |
ServerServicesURL | |
DeploymentLogsURL | これは、すべての配置ログが格納される Amazon CloudWatch ログの URL です。 配置が失敗した場合は、これらのログをトラブルシューティングの際に参照できます。 |
検討事項
ArcGIS デプロイメントを含む CloudFormation スタックを作成した後に検討すべき重要な点は次のとおりです。
- スタックが問題なく作成された場合 (つまりスタック ステータスが [CREATE_COMPLETE] の場合)、ArcGIS Server サイトが問題なくアップグレードされたことを意味します。 ArcGIS Server Manager にサイン インするか、REST サービス ディレクトリを使用して、これを確認できます。
- CloudFormation スタックの作成に失敗した場合 (つまりスタック ステータスが [CREATE_FAILED] の場合)、後述の「トラブルシューティング」セクションからリンクされたページの内容に従ってエラーを解決します。 エラーの根本原因を特定して必要な対応を行った後、失敗したスタックを削除して新しいスタックを作成し、既存の ArcGIS Server サイトをアップグレードすることができます。
トラブルシューティング
この CloudFormation スタックの作成時に障害が発生した場合は、「AWS における ArcGIS デプロイメントのトラブルシューティング」をご参照ください。