secureassist enterprise portal...
TRANSCRIPT
パッケージのダウンロードアップグレード全体の流れ
アップグレード作業の詳細手順
2016.05.13
SecureAssistEnterprisePortalアップグレードガイド
（3.0から3.0.1へのアップグレード）
目次
*本資料について
*SecureAssistEnterprisePortalアップグレード準備
パッケージのダウンロード
*SecureAssistEnterprisePortal アップグレード作業の概要
はじめに
作業全体の流れ
*SecureAssistEnterprisePortalアップグレード作業の詳細手順
はじめに
1.アップグレード前の準備
2.作業ディレクトリの作成
3. ライセンスと設定ファイルの退避
4.CSA_Server.war ファイルの削除
5.CSA_Server ディレクトリの削除
6.新しい CSA_Server.warファイルの配置
7.データベースの更新
8.ApacheTomcat の起動
9. ライセンスと設定ファイルの復元
10. ファイルパーミッションの確認
11.MySQLConnector の配置
12.ApacheTomcat のキャッシュの削除
13.ApacheTomcat の再起動
*SecureAssistEnterprisePortalアップグレード後の作業
Rulepackの更新
EclipsePluginの配置
*お問い合わせ
2
本資料について
本資料では、ApacheTomcat とMySQLServerの環境で動作するSecureAssistEnterprisePotalのアップグレードに関する以下の範囲を取り扱います。
– パッケージのダウンロード
– アップグレード作業の概要
– アップグレード作業の詳細手順
– アップグレード後の作業
3
SecureAssistEnterprisePortalアップグレード準備
4
アップグレード準備パッケージのダウンロード
SecureAssistのWebサイトのEnterprisePortalDownloadページに、最新版のEnterprisePortalのダウンロードリンクがあります。
ダウンロードしたzipファイルはインストールに備えて展開しておきます。
AsteriskResearchWebサイトhQps://secureassist.jp/
SecureAssistEnterprisePortalDownloadページhQps://secureassist.jp/downloads/enterpriseportal/
5
SecureAssistEnterprisePortalアップグレード作業の概要
6
アップグレード作業の概要はじめに
EnterprisePortal3.0から3.0.1へのアップグレードで更新が必要なもの、そのまま使用できるものは次の通りです。• アプリケーションは更新が必要です。• データベースは更新が必要です。• ライセンスファイルは以前のものをそのまま使用できます。
また、アップグレード作業前には、必ず次の作業を実施してください。• ApacheTomcatの停止。• アプリケーションのバックアップの作成。• データベースのバックアップの作成。
7
アップグレード作業の概要作業全体の流れ
おおまかな作業の流れを紹介します。1. アップグレード前の準備
1. ApacheTomcatの停止、アプリケーションとデータベースのバックアップの作成
2. アップグレード作業1. ライセンスや設定ファイルなどの作業ディレクトリへの退避2. アップグレード前のアプリケーションの削除3. 新しいwarファイルの配置4. データベースの更新5. Tomcatの起動6. ライセンスや設定ファイルなどの作業ディレクトリからの復元7. ファイルパーミッションの設定とキャッシュの削除8. ApacheTomcatの再起動
3. アップグレード後の作業1. Rulepackの更新2. EclipsePluginの更新
8
SecureAssistEnterprisePortalアップグレード作業の詳細手順
9
アップグレード作業の詳細手順はじめに
本手順は「SecureAssistEnterprisePortalUserGuide」の「UpgradeInstrucXons」の節を元に構成しています。各手順の番号（1,2,3,…）は元のガイドと本手順とで一致させていますので、必要に応じてご参照ください。元のガイドは hQps://secureassist.jp/downloads/enterpriseportal/にある「EnterprisePortalユーザーガイド」のリンクからダウンロードできます。また、アップグレード前の準備として、次の作業を確実に行うようお願いいたします。• ApacheTomcatの停止。• アプリケーションのバックアップの作成。• データベースのバックアップの作成。
10
アップグレード作業の詳細手順1.アップグレード前の準備
アップグレード作業時の不整合を防ぐため、また問題発生時に元の環境に戻すため、次の作業を必ず行ってください。ApacheTomcatの停止
実行例：$sudo/sbin/servicetomcatstop
アプリケーション（Tomcat）のファイル全体をバックアップ実行例：$sudotarcvfbackup_tomcat-webapps_300_before_upgrade.tar-C/var/lib/tomcat/webapps/
データベースのバックアップ実行例：$mysqldump-uroot-pportal_csa>mysqldump_portal_csa_300_before_upgrade.dump
11
アップグレード作業の詳細手順2.作業ディレクトリの作成
作業ディレクトリを作成します。作業ディレクトリは、現在のライセンスや設定のファイルを退避しておき、新しいバージョンの配置後にその設定をコピーして復元するために使用します。
実行例：$mkdirbackup_csa-portal_3.0_to_3.0.1
$cdbackup_csa-portal_3.0_to_3.0.1
12
アップグレード作業の詳細手順3. ライセンスと設定ファイルの退避
<CATALINA_HOME>/webapps/CSA_Server/ 以下のディレクトリとファイルを退避します。退避するファイルとディレクトリ：key-filestatsrulepacksWEB-INF/lib/mysql-connector-java-5.x.x.jar実行例：$mkdirCSA_Server
$sudocp-ir/var/lib/tomcat/webapps/CSA_Server/key-file CSA_Server
$sudocp-ir/var/lib/tomcat/webapps/CSA_Server/stats CSA_Server
$sudocp-ir/var/lib/tomcat/webapps/CSA_Server/rulepacksCSA_Server
$sudocp-ir/var/lib/tomcat/webapps/CSA_Server/WEB-INF/lib/mysql-connector-java-5.1.38-bin.jarCSA_Server
<CATALINA_HOME>/webapps/CSA_Server/WEB-INF/以下のファイルを退避します。退避するファイル：cron.properXesdb.properXes<company_name>-SecureAssist-PriKey.derSecureAssist.licenseclasses/log4j.xml実行例：$mkdirCSA_Server/WEB-INF
$mkdirCSA_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.derCSA_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ファイルを削除します。
実行例：$sudorm-i/var/lib/tomcat/webapps/CSA_Server.war
14
アップグレード作業の詳細手順5.CSA_Server ディレクトリの削除
<CATALINA_HOME>/webappsディレクトリにある CSA_Serverディレクトリを削除します。
実行例：$sudorm-rf/var/lib/tomcat/webapps/CSA_Server/
15
アップグレード作業の詳細手順6.新しい CSA_Server.warファイルの配置
新しいバージョンのEnterprisePortalのzipファイルに含まれる CSA_Server.warファイルを、<CATALINA_HOME>/webappsディレクトリにコピーします。
実行例：$sudocp-i~/CSA_Enterprise_Portal_v3.0.1.20160412/WAR/CSA_Server.war/var/lib/tomcat/webapps
16
アップグレード作業の詳細手順7.データベースの更新
新しいバージョンのEnterprisePortalのzipファイルに含まれるDatabaseScript/upgrade/3.0_to_3.0.1ディレクトリにあるSQLスクリプトを実行して、データベースを更新します。実行例：$mysql-uroot-pportal_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-uroot-pportal_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.ApacheTomcat の起動
停止していたApacheTomcatを起動します。この作業により、<CATALINA_HOME>/webapps/に CSA_Serverディレクトリが作成され、その中にEnterprisePortalの各種ファイルが配置されます。
実行例：$sudo/sbin/servicetomcatstart
18
アップグレード作業の詳細手順9. ライセンスと設定ファイルの復元
<CATALINA_HOME>/webapps/CSA_Server/以下のディレクトリとファイルを復元します。復元するファイルとディレクトリ：key-filestatsrulepacks実行例：$sudocp-irCSA_Server/key-file /var/lib/tomcat/webapps/CSA_Server/
$sudocp-irCSA_Server/stats /var/lib/tomcat/webapps/CSA_Server/
$sudocp-irCSA_Server/rulepacks/var/lib/tomcat/webapps/CSA_Server/
<CATALINA_HOME>/webapps/CSA_Server/WEB-INF/以下のファイルを復元します。コピーするファイル：cron.properXesdb.properXes<company_name>-SecureAssist-PriKey.derSecureAssist.licenseclasses/log4j.xml実行例：$sudocp-iCSA_Server/WEB-INF/cron.properties/var/lib/tomcat/webapps/CSA_Server/WEB-INF
$sudocp-iCSA_Server/WEB-INF/db.properties/var/lib/tomcat/webapps/CSA_Server/WEB-INF
$sudocp-iCSA_Server/WEB-INF/AsteriskResearch-SecureAssist-PriKey.der/var/lib/tomcat/webapps/CSA_Server/WEB-INF
$sudocp-iCSA_Server/WEB-INF/SecureAssist.license/var/lib/tomcat/webapps/CSA_Server/WEB-INF
$sudocp-iCSA_Server/WEB-INF/classes/log4j.xml /var/lib/tomcat/webapps/CSA_Server/WEB-INF/classes/
19
アップグレード作業の詳細手順10. ファイルパーミッションの確認
すべてのファイルがApacheTomcatのプロセスにより読み書き可能であることを確認します。
実行例：$sudochown-Rtomcat:tomcat/var/lib/tomcat/webapps/CSA_Server
20
アップグレード作業の詳細手順11.MySQLConnector の配置
先の手順3.で退避したMySQLConnector、または最新のMySQLConnectorをダウンロードしたものを配置します。実行例：$wgethttp://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.39.tar.gz
$gzip-cdmysql-connector-java-5.1.39.tar.gz|tarxf-
$sudocp–imysql-connector-java-5.1.39/mysql-connector-java-5.1.39-bin.jar/var/lib/tomcat/webapps/CSA_Server/WEB-INF/lib/
21
アップグレード作業の詳細手順12.ApacheTomcat のキャッシュの削除
ApacheTomcatのキャッシュを削除します。
キャッシュの場所の例：/var/cache/tomcat6/work/Catalina/localhost/CSA_Server/*<tomcat>/work/Catalina/localhost/CSA_Server/*
実行例：$sudorm-rf/var/cache/tomcat/work/Catalina/localhost/CSA_Server/org
22
アップグレード作業の詳細手順13.ApacheTomcat の再起動
ApacheTomcatを再起動します。
実行例：$sudo/sbin/servicetomcatrestart
これでSecureAssistEnterprisePortal本体のアップグレード作業は完了です。WebブラウザでEnterprisePortalにアクセスして、画面左下に表示されているバージョン番号が更新されていること、各画面が正しく表示されることをご確認ください。この後は、新しいRulepackの登録と、新しいEclipsePluginの設置の作業にお進みください。
23
SecureAssistEnterprisePortalアップグレード後の作業
24
アップグレード後の作業Rulepackの更新
EnterprisePortalのzipファイルの中にあるRulepackディレクトリのRulapackのjarファイルをアップロードして有効（Enabled）にします。その際、古いRulepackは無効（Disabled）にします。IDE起動時のEnterprisePortalとの通信により、IDE側のRulepackが更新されます。
25
「UploadRulepack」ボタンをクリックして、新しいRulepackファイルをアップロードします。
古いRulepackはDisabled、新しいRulepackはEnabledにします。
Rulepackの更新ができました。
アップグレード後の作業EclipsePluginの配置
<CATALINA_HOME>/webapps/ に、EnterprisePortalパッケージの中にあるEclipsePluginのzipファイルに含まれるupdateディレクトリを配置します。配置先に以前のバージョンのupdateディレクトリがある場合は、あらかじめ削除しておきます。
実行例：$cdCSA_Enterprise_Portal_v3.0.1.20160412
$unzip-dCSA_Eclipse_Enterprise_Plugin_v3.0.1_201604142
$sudorm–rf/var/lib/tomcat/webapps/update/
$sudocp-irCSA_Eclipse_Enterprise_Plugin_v3.0.1_201604142/update//var/lib/tomcat/webapps/
$sudo/sbin/servicetomcatrestart
旧バージョンのEclipsePluginをこのupdateディレクトリからインストールしている場合：
Eclipse側で「Help」の「CheckforUpdates」を選択することで、このupdateディレクトリから更新することができます。
旧バージョンのEclipsePluginをローカルディスクからインストールしている場合：
「Help」の「InstallNewSojware」を選択することで、このupdateディレクトリから新することができます。
詳細は hQps://secureassist.jp/downloads/にある「EclipsePlug-in導入ガイド」の「SecureAssistEclipsePlug-inインストール」をご覧ください。
26
お問い合わせ
27
本資料についてのお問い合わせやサポートのご依頼[email protected]
パートナーシップ・提携 [email protected]
トレーニング・研修 [email protected]
サービス・プロダクトのご購入 [email protected]
ご購入後のサポート [email protected]
広報・取材依頼 [email protected]
その他のお問い合わせ
株式会社アスタリスク・リサーチAsteriskResearch,Inc.hQp://www.asteriskresearch.com/