Contrail インストレーション

Transcription

1 Contrail 評価版 - How to install Juniper Networks, K.K. Jan Rev

2 はじめに この資料は Contrail の評価版をご利用頂く際に 製品ドキュメントの補助としてご利用頂くことを目的に作成しました 内容 ファイルのダウンロード インストールの注意点 新規インストール手順 アップグレード手順 1.02 から 1.03 へ インストール確認 本資料記載の内容は 2014 年 1 月 22 日現在のリリース 1.03 をベースにしています 記載内容は予告なく変更されることもあります ご了承ください 2 Copyright 2013 Juniper Networks, Inc.

3 インストールの注意点 3 Copyright 2013 Juniper Networks, Inc.

4 Contrail 構成サーバー 通常は 複数のサーバーにインストールします Contrail のシステムは下記のコンポーネントから構成されます cfgm Contrail configuration manager を実行 (Contrail のクラスタ *1 をコントロールする役割 ) openstack OpenStack の各種サービス (Nova, Quantum など ) を実行 collector モニター Analytics( 通信の統計情報収集等 ) compute vrouter が動作し 仮想マシン (VM) を起動し実ネットワークとの通信を提供 control コントロール プレーンのサービスを提供 database Analytics とシステム設定情報のデータベース webui 管理者向け GUI ダウンロードしたソフトウェアは サーバーの持つ役割に関わらず全てのサーバーにインストールします その後のセットアップで サーバーの役割に応じた設定が行われます 4 Copyright 2013 Juniper Networks, Inc. *1 1 つの Contrail システムを構成するサーバー群をクラスタと呼びます

5 インストールのポイント サーバーの設定 次の設定が必要です サーバー名でアドレスを解決できること ( 必須 ) /etc/hosts に Contrail のクラスタを構成するサーバー名と IP アドレスを登録してください 複数サーバー構成の場合 サーバー間で時刻が同期していること ntp パッケージをインストールして設定してください インストール作業に影響を与えませんが サーバー間で時刻がずれていると 起動後の統計情報の処理が正しく行われません Contrail ソフトウェアパッケージのインストール RPM 利用の場合 yum や rpm コマンドを使ってパッケージをインストールします ISO イメージ利用の場合 その他 サーバーの BIOS 設定を変更し ISO のイメージから起動します ネットブート DVD ドライブ等 Ver の CentOS 版は bootable USB メモリからのインストールはサポートしていません インストーラーの指示に従って必要項目を設定します ISO イメージからインストールしたサーバーは 外部から ssh, sftp で接続可能ですが telnet, ftp は不可です 必要に応じてパッケージをインストールするか 予め ssh, sftp の利用できるターミナルソフトをご用意頂くと良いでしょう 5 Copyright 2013 Juniper Networks, Inc.

6 インストールのポイント セットアップ Contrail パッケージのインストールが完了したら サーバーのセットアップが必要です セットアップは 1 台のサーバーからネットワーク経由で実行されます 設定ファイルの作成セットアップを実行するサーバー上で /opt/contrail/utils/fabfile/testbeds の下にある testbed_multibox_example.py ( 複数サーバー構成の場合 ) をコピーして testbed.py を作成してください ( 同じディレクトリ ) 同ディレクトにある testbed_singlebox_example.py は 1 台構成 *2 ( 全てのコンポーネントを 1 台のサーバー上で稼働させる ) 用のテンプレートです *2 主に GUI の操作感の確認や小規模のデモ用とお考えください 6 Copyright 2013 Juniper Networks, Inc.

7 インストールのポイント 設定ファイルの内容 testbed.py の主な行を以下に示します お使いのネットワーク環境に合わせて編集してください host1 = 'root@ ' host2 = 'root@ ' < 省略 > host10 = 'root@ ' <= ここから各ホストでセットアップを実行する < ユーザー名 >@<IPアドレス > を編集不要な行は削除またはコメントアウトする ext_routers = [('mx-1', ' '), ('mx-2', ' ')] <= ルーター名とIP router_asn = <= AS 番号 アドレス host_build = 'root@ ' <= セットアップを実行するホストとユーザー ( 注 ) Env.roledefs = { 'all': [host1, host2, host3, host4, host5],<= 全てのホスト名を列挙以下 各役割のホスト名を記述 'cfgm': [host1], <= Configuration Manager 'openstack': [host1], <= OpenStack 'control': [host2, host3], <= Control Node ( 注 ) Contrail のシステムを構成するサーバー以外からのセットアップも可能なため この項目があります 7 Copyright 2013 Juniper Networks, Inc.

8 インストールのポイント 'compute': [host4, host5], <= Compute Node 'collector': [host1], <= Collector 'webui': [host1], <= Web UI 'database': [host1], <= Databaseを作成するホスト ( 通常はConfiguration 'build': [host_build], Manager と同じ ) } env.hostnames = { 全ホスト名を列挙 'all': ['system001', 'system002', 'system003','system004', 'system005'] } env.passwords = { host1: 'juniper123', < 省略 > host5: 'juniper123', <= 各ホストのユーザーのパスワードを列挙する } host_build: 'juniper123', <= セットアップを実行するホストのパスワード セットアップの実行 #cd <parent-of-fabfile-directory> #fab setup_all <= fabfile の親ディレクトリに移動 (/opt/contrail/utils) 8 Copyright 2013 Juniper Networks, Inc.

9 VMware 上の Linux へインストールする場合 VMware Workstation で Linux の VM を作り その上に Contrail をインストールすることもできます その場合 セットアップを実行する前に下記設定を有効にしておいてください 9 Copyright 2013 Juniper Networks, Inc.

10 ファイルのダウンロード 10 Copyright 2013 Juniper Networks, Inc.

11 ダウンロードサイト Contrail のバイナリファイルは こちらからダウンロードできます Note, this will require registering for an account if you re not already a Juniper.net user. It may take up to 24 hours for Juniper to respond to the new account request. We highly recommend reading the Installation Guide to go through the minimum requirements and get a sense of the installation process before you jump in. ダウンロードするためには juniper.net のアカウントが必要となります 事前に インストールガイドをお読みください インストールに必要な最低限の環境や手順が記載されています ご利用に際して Contrail Software Evaluation License Agreement へ同意頂く必要があります インストールガイドは こちらからご覧いただけます 11 Copyright 2013 Juniper Networks, Inc.

12 ファイルの種類 サポート OS Cent OS 6.4 Fedoracore 17 Software 既に OS をインストール済みで Contrail のパッケージのみをインストールする場合 こちらをお使いください RPM のファイルです Install Media Contrail のパッケージを含む OS の iso イメージです 新規にインストール可能な空きディスク / パーティションがある場合にご利用頂けます 別途 Contrail のセットアップは必要です ダウンロード前に こちらをご確認ください 12 Copyright 2013 Juniper Networks, Inc.

13 注意事項 ISO イメージからインストールされる方へ フリーのツール等を使って ISO からブータブルな USB メモリスティックを作成し インストールすることができます DVD に焼いてからのインストールよりも速度面で有利です 但し CentOS 版は USB メモリスティックからのブートに対応していません 13 Copyright 2013 Juniper Networks, Inc.

14 新規インストール手順 14 Copyright 2013 Juniper Networks, Inc.

15 インストール手順 1 RPM ファイルから サーバーの構成 ネットワーク OS の種類により 手順は異なります ここでは CentOS RPM 1 つの NIC を使用する場合を説明します 詳細はインストールマニュアルをご参照ください 1. OS のインストール 1. CentOS 6.4 をダウンロードしてインストール 2. ホスト名の設定 /etc/sysconfig/network ファイルにホスト名を記述してください 例 : [root@system001 ~]# cat /etc/sysconfig/network NETWORKING=yes HOSTNAME=system001.xyz.juniper.net 15 Copyright 2013 Juniper Networks, Inc.

16 インストール手順 1 RPM ファイルから 3. ネットワークの設定 /etc/sysconfig/network-scripts/ifcfg-<if name> ファイルを編集 例 : [root@system001 ~]# cat /etc/sysconfig/network-scripts/ifcfg-eth0 DEVICE=eth0 HWADDR=00:25:90:A6:7D:25 TYPE=Ethernet UUID=330e f1-4bf1-8dd3-8932a47a5b7f ONBOOT=yes NM_CONTROLLED=yes BOOTPROTO=none IPADDR= NETMASK= GATEWAY= ホスト名 ネットワークを設定したらリブートしてください 2. Contrail の RPM パッケージをインストール # yum localinstall < パッケージファイル名 ( フルパス )> 又は # rpm Uvh < パッケージファイル名 ( フルパス )> 16 Copyright 2013 Juniper Networks, Inc.

17 インストール手順 1 RPM ファイルから 3. Contrail のセットアップ # cd /opt/contrail/contrail_packages;./setup.sh 4. testbed.py の編集 前述のtestbed.pyの例を参考に必要な項目を編集 詳細は 17 Copyright 2013 Juniper Networks, Inc.

18 インストール手順 1 RPM ファイルから 6. Contrail の RPM インストール ( 他のサーバーへ ) インストール作業を行うサーバーのみで実行 # fab install_rpm_all:<rpmパッケージファイル名 > 例 : # fab install_rpm_all:/tmp/contrail-install-packages el6.noarch.rpm 7. Contrail パッケージをインストール fabfileディレクトリの親ディレクトリで # fab install_contrail 8. セットアップ # fab setup_all 18 Copyright 2013 Juniper Networks, Inc.

19 インストール手順 2 Install media から ( クリーン インストール可能なディスク パーティションがある場合 ) Install media の ISO イメージは OS Contrail パッケージ ( 展開済 rpm の展開は不要です ) OpenStack を含んだブータブル イメージです 1. OS インストール ISO を焼いた DVD からブートさせます 画面の指示に従って必要な項目を選択 入力し OS をインストールします 詳しくは インストールドキュメントをご参照ください 2. OS の設定 1. ホスト名の設定 /etc/sysconfig/network ファイルにホスト名を記述してください 例 : [root@system001 ~]# cat /etc/sysconfig/network NETWORKING=yes HOSTNAME=system001.xyz.juniper.net 19 Copyright 2013 Juniper Networks, Inc.

20 インストール手順 2 Install media から 2. ネットワークの設定 /etc/sysconfig/network-scripts/ifcfg-<if name> ファイルを編集例 : 3. 再起動 [root@system001 ~]# cat /etc/sysconfig/network-scripts/ifcfg-eth0 DEVICE=eth0 HWADDR=00:25:90:A6:7D:25 TYPE=Ethernet UUID=330e f1-4bf1-8dd3-8932a47a5b7f ONBOOT=yes <= ブート時にインタフェースを有効にします NM_CONTROLLED=yes BOOTPROTO=none <= デフォルトではdhcpになっていることが多いです IPADDR= NETMASK= GATEWAY= OS を再起動して ホスト名 IP アドレスの設定が正しく反映されていることを確認してください 20 Copyright 2013 Juniper Networks, Inc.

21 インストール手順 2 Install media から 1. ホスト名でアドレス解決できるようにしてください (DNS 設定 又は hosts ファイル編集 ) 例 :/etc/hosts ファイルを編集 [root@sv001 ~]# cat /etc/hosts localhost localhost.localdomain localhost4 localhost4.localdomain4 ::1 localhost localhost.localdomain localhost6 localhost6.localdomain sv001 sv001.localdomain sv002 sv002.localdomain sv003 sv003.localdomain [root@sv001 ~]# 2. ファイル確認 ( 参考 ) Install mdedia の ISO から OS をインストールすると 下記ディレクトリにインストール用のファイルが展開されています [root@sv001 ~]# ls -lh /opt/contrail/ total 605M drwxr-xr-x 2 root root 4.0K Nov 29 00:38 bin drwxr-xr-x K Oct 23 15:58 contrail_installer -rw-r--r-- 1 root root 6.2M Oct 23 15:58 contrail_installer.tgz drwxrwxr-x K Oct 23 11:02 contrail_packages -rw-r--r-- 1 root root 599M Oct 23 16:41 contrail_packages_243.tgz [root@sv001 ~]# 21 Copyright 2013 Juniper Networks, Inc.

22 インストール手順 2 Install media から 3. Contrail のセットアップ # cd /opt/contrail/contrail_packages;./setup.sh 4. testbed.py の編集 /opt/contrail/utils/fabfile/testbeds の下に testbed.py を作成してください 前述の testbed.py の例を参考に必要な項目を編集 詳細は 5. Contrail パッケージをインストール fabfile ディレクトリの親ディレクトリ /opt/contrail/utils で # fab install_contrail ネットワーク経由で 各サーバーにパッケージがインストールされます 例 : インストール時に 次のような形で接続しているサーバーとインストール中のパッケージ情報が出力されます [root@ ] out: Installing : contrail-database-venv el6.x86 [################### ] 9/52 [root@ ] out: Installing : contrail-database-venv el6.x86 [#################### ] 9/52 [root@ ] out: Installing : contrail-database-venv el6.x86 [##################### ] 9/52 完了すると Compute ノードはリブートします 22 Copyright 2013 Juniper Networks, Inc.

23 インストール手順 2 Install media から 例 : 終了直前の画面出力 [root@ ] out: wpa_supplicant.x86_64 1: el6_3 [root@ ] out: [root@ ] out: Complete! [root@ ] out: Reboot issued; Waiting for the node ( ) to go down... Node ( ) is down... Waiting for node to come back. Done. Disconnecting from done. Disconnecting from done. Disconnecting from done. [root@sv001 utils]# 以下の様な場合は失敗です ( メモリ不足などが考えられます ) Stopped. Disconnecting from [root@ ] out: Installing : contrail-database-venv el6.x86 [################################## ] 9/52done. Disconnecting from done. Disconnecting from done. [root@sv001 utils]# 6. セットアップ # fab setup_all 終了直前の出力例 [root@ ] Executing task 'prov_external_bgp' [root@ ] Executing task 'compute_reboot' Reboot issued; Waiting for the node ( ) to go down... Node ( ) is down... Waiting for node to come back. Done. Disconnecting from done. Disconnecting from done. Disconnecting from done. [root@sv001 utils]# 23 Copyright 2013 Juniper Networks, Inc.

24 アップグレード手順 1.02 から 1.03 へ 24 Copyright 2013 Juniper Networks, Inc.

25 1.03 へのアップグレード手順 (1/3) 既に 1.02 をお使いの方で 今の環境を保持したまま 1.03 へアップグレードする方法です 注意 Compute ノードの再起動 VM の再起動が必要です VM 上で作業中のタスクは全て終了して情報が失われないように注意してください 1.02 を構築したときからサーバーの構成に変更がないことが前提です (testbed.py が同一であること ) 1. RPM ファイルをダウンロード お使いの OS に対応したパッケージファイル contrail-install-packages-1.03-xxx.xxx.noarch.rpm をダウンロードしてください ダウンロードしたファイルは Config ノードの /tmp に置いてください 2. contrail インストールパッケージを展開 : # yum localinstall /tmp/contrail-install-packages-1.03-xxx.xxx.noarch.rpm または # rpm -Uvh /tmp/contrail-install-packages-1.03-xxx.xxx.noarch.rpm 25 Copyright 2013 Juniper Networks, Inc.

26 1.03 へのアップグレード手順 (2/3) 3. ローカルマシン ( アップグレードコマンドを実行するサーバー ) のセットアップ # cd /opt/contrail/contrail_packages;./setup.sh 4. testbed.py の確認セットアップのときに使用した testbed.py ファイルが そのまま ( 変更されずに ) /opt/contrail/utils/fabfile/testbeds/ に存在していることを確認してください 1.02 インストール時からクラスタの構成が変更されている場合は 別途お問い合わせください 5. アップグレードコマンド実行 # cd /opt/contrail/utils; fab upgrade_contrail:/tmp/contrail-installpackages-1.03-xxx.xxx.noarch.rpm; fab setup_cfgm 終了時に Compute ノードが自動的に再起動します 1 サーバー構成 ( 全てのコンポーネントを 1 台にインストール ) の場合は Compute のサービスを再起動してください # cd /opt/contrail/utils; fab restart_openstack_compute 26 Copyright 2013 Juniper Networks, Inc.

27 1.03 へのアップグレード手順 (3/3) 6. VMの再起動 Openstackサーバー上で 全ての仮想マシンをソフト リブートしてください 方法 1 GUIの各インスタンスのメニューから再起動してください 方法 2 コマンドラインからリブートします # source /etc/contrail/openstackrc ; nova reboot <vmインスタンスid> openstack-nova-novncproxy が起動していることを確認してください # service openstack-nova-novncproxy status サービスを再起動するには 次のコマンドを使用します # service openstack-nova-novncproxy restart 27 Copyright 2013 Juniper Networks, Inc.

28 インストール確認 28 Copyright 2013 Juniper Networks, Inc.

29 インストール確認 モジュールの起動確認コマンド openstack-status 動作している OpenStack モジュールの状態を表示します 例 : [root@system001 ~]# openstack-status == Nova services == openstack-nova-api: active openstack-nova-cert: active openstack-nova-compute: dead (disabled on boot) openstack-nova-network: dead (disabled on boot). openstack-cinder-scheduler: active openstack-cinder-volume: inactive (disabled on boot) == Support services == mysqld: active httpd: active libvirtd: inactive qpidd: active memcached: active == Keystone users == Warning keystonerc not sourced 29 Copyright 2013 Juniper Networks, Inc.

30 インストール確認 OpenStack nova ホスト確認 nova host-list 動作している nova ホストの一覧を表示します Configuration Manager 上で実行します Compute ノードが表示されない場合 通信ができていません 例 : [root@system001 ~]# (source /etc/contrail/openstackrc ; nova host-list) host_name service zone system001.xyz.juniper.net cert internal system001.xyz.juniper.net conductor internal system001.xyz.juniper.net conductor internal system001.xyz.juniper.net conductor internal system001.xyz.juniper.net consoleauth internal system001.xyz.juniper.net scheduler internal system004.xyz.juniper.net compute nova system005.xyz.juniper.net compute nova [root@system001 ~]# 30 Copyright 2013 Juniper Networks, Inc.

31 インストール確認 OpenStack の UI にログイン の IP アドレス > ユーザー名 :admin パスワード :contrail Copyright 2013 Juniper Networks, Inc.

32 インストール確認 Contrail UI にログイン Manager の IP アドレス >:8080 ユーザー名 :admin パスワード :contrail Copyright 2013 Juniper Networks, Inc.

33