2016.09.29 SecureAssist Enterprise Portal アップグレードガイド Version 3.0.3 対応版 パッケージのダウンロード アップグレード全体の流れ
目次 * 本資料について * SecureAssist Enterprise Portal アップグレード準備パッケージのダウンロード * SecureAssist Enterprise Portal アップグレード作業の概要 はじめに作業全体の流れ * SecureAssist Enterprise Portal アップグレード後の作業 Rulepack の更新 Eclipse Plugin の配置 * お問い合わせ * SecureAssist Enterprise Portal はじめに 1. アップグレード前の準備 2. 作業ディレクトリの作成 3. ライセンスと設定ファイルの退避 4. CSA_Server.war ファイルの削除 5. CSA_Server ディレクトリの削除 6. 新しい CSA_Server.war ファイルの配置 7. データベースの更新 8. Apache Tomcat の起動 9. ライセンスと設定ファイルの復元 10. ファイルパーミッションの確認 11. MySQL Connector の配置 12. Apache Tomcat のキャッシュの削除 13. Apache Tomcat の再起動 2
本資料について 本資料では Apache Tomcat と MySQL Server の環境で動作する SecureAssist Enterprise Potal のアップグレードに関する 以下の範囲を取り扱います パッケージのダウンロード アップグレード作業の概要 アップグレード後の作業 3
SecureAssist Enterprise Portal アップグレード準備 4
アップグレード準備パッケージのダウンロード SecureAssist の Web サイトの Enterprise Portal Download ページに 最新版の Enterprise Portal のダウンロードリンクがあります ダウンロードした zip ファイルはインストールに備えて展開しておきます SecureAssist Web サイト hrps://secureassist.jp/ SecureAssist Enterprise Portal Download ページ hrps://secureassist.jp/downloads/enterpriseportal/ 5
SecureAssist Enterprise Portal アップグレード作業の概要 6
アップグレード作業の概要はじめに Enterprise Portal のアップグレードで更新が必要なもの そのまま使用できるものは次の通りです アプリケーションは更新が必要です データベースは更新が必要です ライセンスファイルは以前のものをそのまま使用できます また アップグレード作業前には 必ず次の作業を実施してください Apache Tomcat の停止 アプリケーションのバックアップの作成 データベースのバックアップの作成 7
アップグレード作業の概要作業全体の流れ おおまかな作業の流れを紹介します 1. アップグレード前の準備 1. Apache Tomcat の停止 アプリケーションとデータベースのバックアップの作成 2. アップグレード作業 1. ライセンスや設定ファイルなどの作業ディレクトリへの退避 2. アップグレード前のアプリケーションの削除 3. 新しいwarファイルの配置 4. データベースの更新 5. Tomcatの起動 6. ライセンスや設定ファイルなどの作業ディレクトリからの復元 7. ファイルパーミッションの設定とキャッシュの削除 8. Apache Tomcatの再起動 3. アップグレード後の作業 1. Rulepack の更新 2. Eclipse Plugin の更新 8
SecureAssist Enterprise Portal 9
はじめに 本手順は SecureAssist Enterprise Portal User Guide の Upgrade InstrucYons の節を元に構成しています 各手順の番号 (1, 2, 3, ) は元のガイドと本手順とで一致させていますので 必要に応じてご参照ください 元のガイドは hrps://secureassist.jp/downloads/enterpriseportal/ にある Enterprise Portal ユーザーガイド のリンクからダウンロードできます また アップグレード前の準備として 次の作業を確実に行うようお願いいたします Apache Tomcatの停止 アプリケーションのバックアップの作成 データベースのバックアップの作成 10
1. アップグレード前の準備 アップグレード作業時の不整合を防ぐため また問題発生時に元の環境に戻すため 次の作業を必ず行ってください Apache Tomcat の停止 $ sudo /sbin/service tomcat stop アプリケーション (Tomcat) のファイル全体をバックアップ $ sudo tar cvf backup_tomcat-webapps_300_before_upgrade.tar -C /var/lib/tomcat/ webapps/ データベースのバックアップ $ mysqldump -u root -p portal_csa > mysqldump_portal_csa_300_before_upgrade.dump 11
2. 作業ディレクトリの作成 作業ディレクトリを作成します 作業ディレクトリは 現在のライセンスや設定のファイルを退避しておき 新しいバージョンの配置後にその設定をコピーして復元するために使用します $ mkdir backup_csa-portal_3.0_to_3.0.1 $ cd backup_csa-portal_3.0_to_3.0.1 12
3. ライセンスと設定ファイルの退避 <CATALINA_HOME>/webapps/CSA_Server/ 以下のディレクトリとファイルを退避します 退避するファイルとディレクトリ : key-file stats rulepacks WEB- INF/lib/mysql-connector-java-5.x.x.jar $ mkdir CSA_Server $ sudo cp -ir /var/lib/tomcat/webapps/csa_server/key-file CSA_Server $ sudo cp -ir /var/lib/tomcat/webapps/csa_server/stats CSA_Server $ sudo cp -ir /var/lib/tomcat/webapps/csa_server/rulepacks CSA_Server $ sudo cp -ir /var/lib/tomcat/webapps/csa_server/web-inf/lib/mysql-connector-java-5.1.38-bin.jar CSA_Server <CATALINA_HOME>/webapps/CSA_Server/WEB-INF/ 以下のファイルを退避します 退避するファイル : cron.properyes db.properyes <company_name>-secureassist-prikey.der SecureAssist.license classes/log4j.xml $ mkdir CSA_Server/WEB-INF $ mkdir CSA_Server/WEB-INF/classes $ cp -i /var/lib/tomcat/webapps/csa_server/web-inf/cron.properties CSA_Server/WEB-INF $ cp -i /var/lib/tomcat/webapps/csa_server/web-inf/db.properties CSA_Server/WEB-INF $ cp -i /var/lib/tomcat/webapps/csa_server/web-inf/asteriskresearch-secureassist-prikey.der CSA_Server/WEB-INF $ cp -i /var/lib/tomcat/webapps/csa_server/web-inf/secureassist.license CSA_Server/WEB-INF $ cp -i /var/lib/tomcat/webapps/csa_server/web-inf/classes/log4j.xml CSA_Server/WEB-INF/classes 13
4. CSA_Server.war ファイルの削除 <CATALINA_HOME>/webapps ディレクトリにある CSA_Server.war ファイルを削除します $ sudo rm -i /var/lib/tomcat/webapps/csa_server.war 14
5. CSA_Server ディレクトリの削除 <CATALINA_HOME>/webapps ディレクトリにある CSA_Server ディレクトリを削除します $ sudo rm -rf /var/lib/tomcat/webapps/csa_server/ 15
6. 新しい CSA_Server.war ファイルの配置 新しいバージョンの Enterprise Portal の zip ファイルに含まれる CSA_Server.war ファイルを <CATALINA_HOME>/webapps ディレクトリにコピーします $ sudo cp -i ~/CSA_Enterprise_Portal_v3.0.1.20160412/WAR/CSA_Server.war /var/lib/tomcat/webapps 16
7. データベースの更新 新しいバージョンの Enterprise Portal の zip ファイルに含まれる DatabaseScript/upgrade/ 以下の アップグレードするバージョンに対応したディレクトリ内にある SQL スクリプトを実行して データベースを更新します アップグレードするバージョンと実行するスクリプトのあるフォルダーについては 下記の表をご覧ください $ mysql -u root -p portal_csa < ~/CSA_Enterprise_Portal_v3.0.1.20160412/DatabaseScript/upgrade/3.0_to_3.0.1/mysql_upgrade_3.0_to_3.0.1.sql $ mysql -u root -p portal_csa < ~/CSA_Enterprise_Portal_v3.0.1.20160412/DatabaseScript/upgrade/3.0_to_3.0.1/mysql_aggregaYon_upgrade_3.0_to_3.0.1.sql アップグレードするバージョン 実行するスクリプトのあるフォルダー ( 複数ある場合は上から順に実行してください ) 3.0.2 から 3.0.3 へのアップグレード 3.0.2_to_3.0.3 3.0.1 から 3.0.3 へのアップグレード 3.0.1_to_3.0.2 3.0.2_to_3.0.3 3.0 から 3.0.3 へのアップグレード 3.0_to_3.0.1 3.0.1_to_3.0.2 3.0.2_to_3.0.3 17
8. Apache Tomcat の起動 停止していた Apache Tomcat を起動します この作業により <CATALINA_HOME>/webapps/ に CSA_Server ディレクトリが作成され その中に Enterprise Portal の各種ファイルが配置されます $ sudo /sbin/service tomcat start 18
9. ライセンスと設定ファイルの復元 <CATALINA_HOME>/webapps/CSA_Server/ 以下のディレクトリとファイルを復元します 復元するファイルとディレクトリ : key-file stats rulepacks $ sudo cp -ir CSA_Server/key-file /var/lib/tomcat/webapps/csa_server/ $ sudo cp -ir CSA_Server/stats /var/lib/tomcat/webapps/csa_server/ $ sudo cp -ir CSA_Server/rulepacks /var/lib/tomcat/webapps/csa_server/ <CATALINA_HOME>/webapps/CSA_Server/WEB-INF/ 以下のファイルを復元します コピーするファイル : cron.properyes db.properyes <company_name>-secureassist-prikey.der SecureAssist.license classes/log4j.xml $ sudo cp -i CSA_Server/WEB-INF/cron.properties /var/lib/tomcat/webapps/csa_server/web-inf $ sudo cp -i CSA_Server/WEB-INF/db.properties /var/lib/tomcat/webapps/csa_server/web-inf $ sudo cp -i CSA_Server/WEB-INF/AsteriskResearch-SecureAssist-PriKey.der /var/lib/tomcat/webapps/csa_server/web-inf $ sudo cp -i CSA_Server/WEB-INF/SecureAssist.license /var/lib/tomcat/webapps/csa_server/web-inf $ sudo cp -i CSA_Server/WEB-INF/classes/log4j.xml /var/lib/tomcat/webapps/csa_server/web-inf/classes/ 19
10. ファイルパーミッションの確認 すべてのファイルが Apache Tomcat のプロセスにより読み書き可能であることを確認します $ sudo chown -R tomcat:tomcat /var/lib/tomcat/webapps/csa_server 20
11. MySQL Connector の配置 先の手順 3. で退避した MySQL Connector または最新の MySQL Connector をダウンロードしたものを配置します $ wget http://dev.mysql.com/get/downloads/connector-j/mysql-connector-java-5.1.39.tar.gz $ gzip -cd mysql-connector-java-5.1.39.tar.gz tar xf - $ sudo cp i mysql-connector-java-5.1.39/mysql-connector-java-5.1.39-bin.jar /var/lib/tomcat/webapps/csa_server/web-inf/lib/ 21
12. Apache Tomcat のキャッシュの削除 Apache Tomcat のキャッシュを削除します キャッシュの場所の例 : /var/cache/tomcat6/work/catalina/localhost/csa_server/* <tomcat>/work/catalina/localhost/csa_server/* $ sudo rm -rf /var/cache/tomcat/work/catalina/localhost/csa_server/org 22
13. Apache Tomcat の再起動 Apache Tomcat を再起動します $ sudo /sbin/service tomcat restart これで SecureAssist Enterprise Portal 本体のアップグレード作業は完了です Web ブラウザで Enterprise Portal にアクセスして 画面左下に表示されているバージョン番号が更新されていること 各画面が正しく表示されることをご確認ください この後は 新しい Rulepack の登録と 新しい Eclipse Plugin の設置の作業にお進みください 23
SecureAssist Enterprise Portal アップグレード後の作業 24
アップグレード後の作業 Rulepack の更新 Enterprise Portal の zip ファイルの中にある Rulepack ディレクトリの Rulapack の jar ファイルをアップロードして有効 (Enabled) にします その際 古い Rulepack は無効 (Disabled) にします IDE 起動時の Enterprise Portal との通信により IDE 側の Rulepack が更新されます Upload Rulepack ボタンをクリックして 新しい Rulepack ファイルをアップロードします 古い Rulepack は Disabled 新しい Rulepack は Enabled にします Rulepack の更新ができました 25
アップグレード後の作業 Eclipse Plugin の配置 <CATALINA_HOME>/webapps/ に Enterprise Portal パッケージの中にある Eclipse Plugin の zip ファイルに含まれる update ディレクトリを配置します 配置先に以前のバージョンの update ディレクトリがある場合は あらかじめ削除しておきます $ cd CSA_Enterprise_Portal_v3.0.1.20160412 $ unzip -d CSA_Eclipse_Enterprise_Plugin_v3.0.1_201604142 $ sudo rm rf /var/lib/tomcat/webapps/update/ $ sudo cp -ir CSA_Eclipse_Enterprise_Plugin_v3.0.1_201604142/update/ /var/lib/tomcat/webapps/ $ sudo /sbin/service tomcat restart 旧バージョンの Eclipse Plugin をこの update ディレクトリからインストールしている場合 : Eclipse 側で Help の Check for Updates を選択することで この update ディレクトリから更新することができます 旧バージョンの Eclipse Plugin をローカルディスクからインストールしている場合 : Help の Install New Sokware を選択することで この update ディレクトリから新することができます 詳細は hrps://secureassist.jp/downloads/ にある Eclipse Plug-in 導入ガイド の SecureAssist Eclipse Plug-in インストール をご覧ください 26
お問い合わせ 株式会社アスタリスク リサーチ Asterisk Research, Inc. hrp://www.asteriskresearch.com/ 本資料についてのお問い合わせやサポートのご依頼 support@rsrch.jp その他のお問い合わせ パートナーシップ 提携トレーニング 研修サービス プロダクトのご購入ご購入後のサポート広報 取材依頼 partners@rsrch.jp edu@rsrch.jp sales@rsrch.jp support@rsrch.jp press@rsrch.jp 27