※2018/7からは下記ナレッジでApacheのインストールを不要としており、それ以前の手順書で構築された方向けのナレッジとなります。
なお、手順書のご利用にはBizRobo! PORTALのアカウントが必要です。詳しくはこちらを参照してください。
Windows用Tomcat構築作業手順書(10.3)
バージョンアップ手順をサンプルとして以下の通り記載いたします。
お客様環境に合わせ各設定値を変更のうえご対応下さい。
なお、以下手順は10.1環境から10.3へのバージョンアップ手順となります。
1.Management Consoleへログインいただき、Admin > Backup > Create Backupでバックアップを作成してダウンロードしてください。
⇒MC_backup_日付.zipというファイルがダウンロードされます。
2.旧バージョンのサーバーー上に新バージョンのBizRobo! Basicをインストール下さい。
⇒C:\Program Files\Kapow {Version}\WebApps\ManagementConsole.war を別の場所にコピーし、例えばmc1032.warにファイル名を変更下さい。
3.shutdown_all.batを実行し、サーバーを停止します。
4.ロボットの実行ログ&ロボットファイルを保存するDBは、既存のDBの使いまわしを行うとエラーが発生するため、新しいデータベースを作成します。
⇒以下の順にコマンドを実行いただき、DBを作成下さい。
①cd "C:\Program Files\MySQL\MySQL Server 5.7\bin"
②mysql -u {ユーザー名} -p
③パスワードを入力しログイン下さい。
④CREATE DATABASE basicrobo_mc1032 COLLATE utf8_bin;
⑤SHOW DATABASES; を実行しbasicrobo_mc1032というデータベースが作成されていることを確認下さい。
5.一時的な置き場に下記内容のmc1032.xmlファイルを作成下さい。 ※下記warファイルとmc1032の名前が対応している必要があります。
【mc1032.xml記載内容】
<?xml version='1.0' encoding='utf-8'?>
<Context useHttpOnly="true" mapperContextRootRedirectEnabled="true">
<!-- Default set of monitored resources -->
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<Resource name="jdbc/kapow/platform" auth="Container" type="javax.sql.DataSource"
maxActive="100" maxIdle="30" maxWait="-1"
username="{ユーザ名}(おそらくKpwUser)" password="{パスワード}"
driverClassName="com.mysql.jdbc.Driver"
validationQuery="/* ping */" testOnBorrow="true"
url="jdbc:mysql://{サーバーー名}:3306/basicrobo_mc1032"/>
</Context>
6.作成したmc1032.xmlをC:\Program Files\Apache Software Foundation\Tomcat 8.5\conf\Catalina\localhostにコピー&ペーストしてください。
7.mc1032.warを C:\Program Files\Apache Software Foundation\Tomcat 8.5\webappsにコピー&ペーストして下さい。
8.C:\Program Files\Apache Software Foundation\Tomcat 8.5\conf\server.xmlをコピーし以下の通り修正後上書き下さい。
【server.xml記載内容】
<GlobalNamingResources>
<!-- Editable user database that can also be used by
UserDatabaseRealm to authenticate users
-->
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
<Resource name="jdbc/kapow/platform" auth="Container" type="javax.sql.DataSource"
maxActive="100" maxIdle="30" maxWait="-1"
username="{ユーザ名}(おそらくKpwUser)" password="{パスワード}"
driverClassName="com.mysql.jdbc.Driver"
validationQuery="/* ping */" testOnBorrow="true"
url="jdbc:mysql://{サーバーー名}/basicrobo_mc1032"/>
</GlobalNamingResources>
9.C:\Program Files\Apache24\conf\extra\httpd-proxy-ajp.confファイルをコピーし以下の通り追記後上書き下さい。
【httpd-proxy-ajp.conf追記内容】
<Location /mc1032/ >
ProxyPass ajp://localhost:8009/mc1032/
Order allow,deny
Allow from all
</Location>
10.startup_all.batを実行しサーバーを起動します。
⇒しばらく経つとTomcatによってwarファイルが自動的に展開されます。2分ほどお待ちください。
⇒http://{サーバーー名}/mc1032/にアクセスして、ユーザ名/パスワード共にadminを入力しログインできることを確認下さい。
11.ライセンス登録後、Management Consoleの画面が表示されることを確認下さい。
12.C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps\mc1032\WEB-INF\classes\log4j.propertiesの
最後に以下内容を追記しshutdown_all.bat、startup_all.batの順に実行しサーバーを再起動、MCへログイン下さい。
【log4j.properties追記内容】
#Log4j log to file configuration example
log4j.appender.auditLog=org.apache.log4j.RollingFileAppender
#Configure the file path and maximum file size before rollover
log4j.appender.auditLog.File=C:/LOGS/MC/MC1032.log
log4j.appender.auditLog.MaxFileSize=1MB
log4j.appender.auditLog.layout=org.apache.log4j.PatternLayout
log4j.appender.auditLog.layout.ConversionPattern=%d - %m%n
log4j.category.auditLog=DEBUG, auditLog
log4j.additivity.auditLog=false
※ログの保管の世代数を指定されたい場合は以下を合わせて追記下さい。
log4j.appender.auditLog.MaxBackupIndex=世代数(例:3)
13.C:\LOGS\MC\MC1032.logが作成されていることを確認し、ファイルの中にadminユーザーがログインしたことが記録されていれば成功。
14.Admin > Backup > Restore Backupにて[1.]で作成したバックアップファイルを新Management Consoleにリストアしてください。
15.[Import successful]ウィンドウが表示されればリストア完了です。
⇒旧バージョンでadminユーザのパスワードを変更している場合、この時点でパスワードが上書きされます。
16.Admin > Settings > RoboServer Log Databaseにて以下に変更しSaveをクリック下さい。
Log to Database をON
Host:DBサーバーのIPアドレスかホスト名を指定下さい
Schema:basicrobo_mc1032
Database type:MySQL Database
User name:{ユーザ名}(おそらくKpwUser)
Password:{パスワード}
17.ロボットが使用するDBの以下設定は引き継がれているのでそのままで問題ありません。
[Management Console]-[Admin]-[RoboServers]-[Clusterを選択]-[Edit]-
[Cluster Settings]ウィンドウ-[Database]-[Development Database]
18.以下手順でRoboserverをWindowsサービスに登録してMCに接続します。
①C:\Program Files\Kapow {Version}\bin
②ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account={domain}\{username} wrapper.ntservice.password.prompt=true wrapper.ntservice.name="RoboServer10.3.0.2" wrapper.ntservice.starttype=DELAY_START wrapper.syslog.loglevel=INFO wrapper.app.parameter.1="-p" wrapper.app.parameter.2="50000" wrapper.app.parameter.3="-mcUrl" wrapper.app.parameter.4="http://admin:{password}@{サーバーー名}/mc1032" wrapper.app.parameter.5="-cl" wrapper.app.parameter.6="Non Production"
※すべて1行で入力してください。途中で3カ所、実行環境に応じて書き換えが必要な部分がございます。
※まずは上記をメモ帳に移して、必要な内容を編集してからコピー&ペーストでコマンドプロンプトに入力することを推奨します。
※Production Keyを使用して環境構築している場合は、wrapper.app.parameter.6=”Non Production”をwrapper.app.parameter.6=”Production”に変更してください。
※パスワードの内容はURLエンコードされた値になりますので、パスワードに@,!,(などの値を使用する場合は上記コマンドのパスワードにはURLエンコードした値を使用ください。
※コマンドを実行後、Windowsサービスの実行者となるユーザーのパスワードを入力すると、インストールが完了します。
19.サービスを開いて旧バージョンのRoboServerを停止してから、新バージョンのRoboserverを実行します。 ※このRoboServerは「自動起動(遅延開始)」の設定となっております。
⇒旧バージョンのRoboServerの「スタートアップの種類」は「手動」に変更下さい。 右クリック→プロパティから変更できます。
20.http://{サーバーー名}/mc1032/に接続し、Admin > RoboserversよりRoboserverがOnlineであることを確認します。
21.shutdown_all.bat、startup_all.batの順に実行しサーバーを再起動後、5分ほどおいて再度RoboserverがOnlineであることを確認下さい。
≪以降は新バージョンをしばらく運用いただき、動作確認後に実施いただくことを強く推奨いたします≫
※旧バージョンのBackupファイルもしばらくの間、残しておくことをお勧めいたします。
22.Windowsのサービスより、RoboServerサービスを停止下さい。
23.shutdown_all.batにてサーバーを停止します。
24.C:\Program Files\Apache Software Foundation\Tomcat 8.5\webappsを開き、旧バージョンのフォルダ,warファイルを削除下さい。
⇒念のため、別フォルダにて保存しておいてください。
25.C:\Program Files\Apache Software Foundation\Tomcat 8.5\workを開き、旧バージョンのフォルダを削除下さい。
26.C:\Program Files\Apache Software Foundation\Tomcat 8.5\conf\Catalina\localhostを開き、旧バージョンのxmlファイルを削除下さい。
⇒念のため、別フォルダにて保存しておいてください。
27.startup_all.batにてサーバーを起動します。
28.http://{サーバーー名}/mc1032/にログインできることを確認します。
29.http://{サーバーー名}/mc1032/に接続し、Admin > RoboserversよりRoboserverがOnlineであることを確認します。
30.shutdown_all.bat、startup_all.batの順に実行しサーバーを再起動後、5分ほどおいて再度RoboserverがOnlineであることを確認下さい。
31.Repository > Robotsよりロボットを実行いただき、ロボットを右クリック > View runs for this robot から実行ログが表示されていれば完了です。
≪その後の対応≫
旧バージョンを削除いただいてライセンスを返却いただく際、「廃棄証明書」※というものをご提出いただきますが、そちらの廃棄証明書の中でアンインストールの手順が記載されているため、上記手順では割愛させていただきました。
各種ファイル削除後、アンインストールいただければ完了となります。
ロボットファイルのフォルダや、設定ファイルのフォルダが一部残る場合もございますが、環境移行後問題ないことを確認されましたら、必要に応じて適宜削除ください。
※バージョンアップによりライセンスの更新が発生する場合に必要となります。