狠狠撸

パッケージのダウンロード
アップグレード全体の流れ
アップグレード作業の詳細手順
2016.05.13
SecureAssist Enterprise Portal
アップグレードガイド
（3.0から3.0.1へのアップグレード）

目次
* 本資料について

* SecureAssist Enterprise Portalアップグレード準備

* SecureAssist Enterprise Portal アップグレード作業の概要
はじめに
作業全体の流れ

* 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 の再起動
* SecureAssist Enterprise Portal アップグレード後の作業
Rulepackの更新
Eclipse Pluginの配置

* お問い合わせ

2

本資料について
本資料では、Apache Tomcat と MySQL Server の環境で動作する
SecureAssist Enterprise Potalのアップグレードに関する
以下の範囲を取り扱います。

–? パッケージのダウンロード
–? アップグレード作業の概要
–? アップグレード作業の詳細手順
–? アップグレード後の作業
3

アップグレード準備
4

アップグレード準備
SecureAssistのWebサイトのEnterprise Portal Downloadページに、
最新版のEnterprise Portalのダウンロードリンクがあります。
ダウンロードしたzipファイルはインストールに備えて展開しておきます。
Asterisk Research Webサイト
hQps://secureassist.jp/
SecureAssist Enterprise Portal Downloadページ
hQps://secureassist.jp/downloads/enterpriseportal/

5

アップグレード作業の概要
6

はじめに
Enterprise Portal 3.0 から 3.0.1 へのアップグレードで更新が必要なもの、
そのまま使用できるものは次の通りです。

?? アプリケーションは更新が必要です。
?? データベースは更新が必要です。
?? ライセンスファイルは以前のものをそのまま使用できます。
また、アップグレード作業前には、必ず次の作業を実施してください。

?? 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

9

はじめに
本手順は「SecureAssist Enterprise Portal User Guide」の「Upgrade InstrucXons」の節を元に
構成しています。各手順の番号（1, 2, 3, …）は元のガイドと本手順とで一致させていますので、
必要に応じてご参照ください。
元のガイドは hQps://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-?le 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.properXes db.properXes <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/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_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_aggregaXon_upgrade_3.0_to_3.0.1.sql
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-?le 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.properXes db.properXes <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

アップグレード後の作業
24

Rulepackの更新
Enterprise Portalのzipファイルの中にあるRulepackディレクトリの
Rulapackのjarファイルをアップロードして有効（Enabled）にします。
その際、古いRulepackは無効（Disabled）にします。

IDE起動時のEnterprise Portalとの通信により、IDE側のRulepackが
更新されます。
25
「Upload Rulepack」ボタンをクリックして、
新しいRulepackファイルをアップロードします。
古いRulepackはDisabled、
新しいRulepackはEnabledにします。
Rulepackの更新ができました。

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 Sojware」を選択することで、このupdateディレクトリから新することができます。
詳細は hQps://secureassist.jp/downloads/ にある「Eclipse Plug-in 導入ガイド」の「SecureAssist Eclipse Plug-in インストール」を
ご覧ください。

26

お問い合わせ
27
本資料についてのお問い合わせやサポートのご依頼
support@rsrch.jp
パートナーシップ?提携 partners@rsrch.jp
トレーニング?研修 edu@rsrch.jp
サービス?プロダクトのご購入 sales@rsrch.jp
ご購入後のサポート support@rsrch.jp
広報?取材依頼 press@rsrch.jp
その他のお問い合わせ
株式会社アスタリスク?リサーチ
Asterisk Research, Inc.
hQp://www.asteriskresearch.com/

狠狠撸

SecureAssist Enterprise Portal アッフ?ク?レート?カ?イト?（3.0から3.0.1へのアッフ?ク?レート?）

Recommended

More Related Content

What's hot (20)

Viewers also liked (10)

Similar to SecureAssist Enterprise Portal アッフ?ク?レート?カ?イト?（3.0から3.0.1へのアッフ?ク?レート?） (20)

Recently uploaded (6)

SecureAssist Enterprise Portal アッフ?ク?レート?カ?イト?（3.0から3.0.1へのアッフ?ク?レート?）