インストール＆管理ガイド

イントロダクション

"Self Service Interfaces Generic Enabler" のインストールおよび管理ガイドへようこそ。このジェネリック・イネーブラは、オープンソースプロジェクトに基づいて構築されています。このガイドはこのプロジェクト用に作成された適切なオンライン・コンテンツを示しています。オンライン・ドキュメントは継続的に更新され、改善されているため、インストールと管理に関する最新情報を入手する最も適切な場所になります。

このジェネリック・イネーブラに必要な部分は、Object Storage GE, Service Manager GE DCRM GE, OpenStack Keystone または Identity Manager GE です。PaaS Manager GE も利用できます。

要件

Self Service Interfaces GE を実行するには、以下のフレームワークのソフトウェアを事前にインストールする必要があります :

  • 管理用スクリプト・ツールキット

  • ユーザ・クラウドポータル

    • Node.js Server v0.8.17以上 (http://nodejs.org/download/)
    • Node Packaged Modules。通常、Node.js(https://npmjs.org/)に含まれています
    • Ruby は、インストール中に CSS ファイルを生成するためにも使用されます

システムのインストール

  • 前提条件

Cloud Portal を実行する前に、Ruby, Ruby gem, Node および npm をインストールする必要があります。

このインストールは2つの部分に分かれています :

  • 管理用スクリプト・ツールキット

再起動、サイズ変更、サーバのパスワード変更などの高度なクラウド管理機能を提供します。

スクリプティング・ツールキットを使用するには、最初に jstack コンポーネントをインストールする必要があります :

 npm install jstack-client -g

インストールしたら、次のコマンドを実行するなどしてスクリプトを使用できます :

 jstack-client -u username -p password -l http://130.206.80.100:5000/v2.0/ -t tenant_id server-list
  • ユーザ・クラウドポータル

インスタンスの開始と停止、イメージの一覧表示、キーペアの作成など、毎日のユーザ操作をサポートしています。

Cloud Portal を起動して実行するには、次の手順を実行する必要があります :

  • GitHub を使用して Cloud Portal をダウンロードします
 git clone https://github.com/ging/fiware-cloud-portal.git portal
  • NPM を使用して必要なライブラリをすべてインストールします
 cd portal
 sudo gem install sass
 npm install
  • インストールの設定

Cloud ポータルを設定するには、config.js.template という名前のファイルを config.js にコピーし、対応する情報で編集します。以下にその例を示します :

 var config = {};

 config.useIDM = false;

 config.oauth = {
     account_server: '',
     client_id: '',
     client_secret: '',
     callbackURL: ''
 };

 config.keystone = {
     host: '130.206.80.123',
     port: 5000,
     admin_host: '130.206.80.123',
     admin_port: 35357, 
     username: 'administrator', 
     password: 'password',
     tenantId: '2131278931289371289euwe'
 };

 module.exports = config;
  • 以下を実行してコードをコンパイルします :
 npm install
  • TCP ポート80 で実行されるように、管理者権限で次のコマンドを実行して、実行可能ファイルを起動します :
 node server.js
  • forever.js をインストールしてプロダクション環境で実行することもできます :
 sudo npm install forever -g
  • そして、forever に使用してサーバを実行します :
 forever start server.js
  • プロセスの状態を知るには、次のコマンドを実行します :
 forever status

システム管理

Self-Service Interfaces GE は Web インタフェースに基づいているため、特定のシステム管理は必要ありません。

健全性チェック手順

健全性チェック手順は、システム管理者がインストールのテスト準備が整ったことを確認するための手順です。したがって、単体テスト、統合テスト、ユーザ検証に進む前に、明白なまたは基本的な誤動作が修正されていることを確認するための予備テストセットです。

エンド・ツー・エンドのテスト

この手順を実行する前に、以下の情報が必要です :

  • Cloud Portal ノードの IP アドレス (例 : FIWARE Lab の http://cloud.lab.fiware.org)
  • Self-Service Interfaces GE のデプロイメントのセキュリティを管理する Openstack Keystone ノードの IP アドレス

  • 有効なユーザ名とパスワード

  • http://cloud.lab.fiware.org にアクセスできることを確認してください。デフォルトで、Webアクセスではログイン・ページが表示されます

  • 有効なユーザ名とパスワードを取得し、これらの資格情報でアクセスします。結果として得られる Web ページは、Cloud Portal のランディングページです
  • プロジェクトのインスタンスとイメージを一覧表示できることを確認します

実行中プロセスのリスト

Self-Service Interfaces を実行するために forever を使用している場合、次のコマンドを使用すると、管理者はそのプロセスを見ることができます :

 forever list

ネットワーク・インターフェースのアップとオープン

  • ポータルをロードするには、TCP ポート80 に Web ブラウザからアクセスできる必要があります
  • Cloud GEs は、Cloud Portal からリクエストが出されるため、Cloud Portal からアクセス可能でなければなりません

データベース

Cloud Portal は従来のデータベースを使用していません。他のジェネリック・イネーブラに直接リクエストします。

診断手順

診断手順は、GE のエラーの原因を特定するためにシステム管理者が行う最初の手順です。これらのテストでエラーの性質が特定されると、システム管理者はエラーの正確なポイントと可能な解決方法を特定するために、より具体的で具体的なテストに頼らざるを得なくなります。このような特定のテストは、このセクションの範囲外です。

リソースの可用性

  • UNIX コマンド 'df' を使用して 2.5MB のディスク領域が残っていることを確認します

リモートサービス・アクセス

ポート80 にアクセスできることを確認してください。SSL モードではポート 443 です。

リソース消費

Self-Service Interfaces GE には、データベースや複雑なアプリケーション・ロジックがないため、サーバ上のリソース制約はごくわずかです。

一般的なメモリ消費量は 100MB で、2GHz の CPU コアのほぼ 1％ を消費しますが、それはユーザのリクエストに依存します。また、多くの TCP ソケットを消費し、リクエストに応じて増加します。

I/Oフロー

クライアントは、クライアントの Web ブラウザを介してセルフサービス・インターフェイスにアクセスします。これは単純な HTTP トラフィックです。Cloud portal を介して、さまざまな Cloud GEs (SM GE, DCRM GE, Object Storage GE, Keystoneなど) に定期的にリクエストを送信します。