目次
-
- バージョン確認
1-1 BizMagicバージョンの確認
1-2 Javaバージョンの確認
1-3 Tomcatバージョンの確認
1-4 PostgreSQLバージョンについて - バックアップ取得
2-1 Tomacatの停止
2-2 データベースの確認
2-3 データベースのバックアップを取得 - PostgreSQLバージョンの確認、インストール
3-1 データベースバージョンの確認
3-2 PostgreSQL12のインストール
3-3 バックアップデータのリストア
3-4 PostgreSQL8.x、もしくは 9.x の停止 - Javaの確認、インストール
4-1 Javaバージョンの確認
4-2 amazon-corretto-8.xのインストール - Tomcatの確認、インストール
5-1 Tomcatバージョンの確認
5-2 Tomcat9のインストール - BizMagicバージョンアッププログラムのインストール
6-1 BizMagicのインストール
6-2 [Tomcatバージョンの確認］で確認したバージョンがTomcat5、6の場合Tomcat 起動
6-3 [Tomcatバージョンの確認］で確認したバージョンがTomcat9の場合
6-4 Tomcat 起動 - BizMagic起動確認
7-1 バージョンの確認
7-2 起動確認 - BizMagic簡易バックアップ確認
8-1 BizMagic簡易バックアップファイル
8-2 BizMagic簡易バック設定
- バージョン確認
１．バージョン確認
現在ご利用中のバージョンを確認します。バージョンによって手順が異なりますのでご注意ください。
1-1 BizMagicバージョンの確認
- BizMagicにログインします。
- 左メニュー［システム設定］－［BizMagicについて］（もしくは［システム設定］－［基本設定］タブー［各種設定］タブー［BizMagicについて］）をクリックします。
- 下記項目について確認ください。
| 製品バージョン （BizMagicバージョンの確認） |
［BizMagic Version 3.2 Release 8］以降の場合 → 問題ありません。［BizMagic Version 3.2 Release 7］以前の場合 → バージョンアップ手順が本手順書と異なります。弊社へお問合せ下さい。 |
| データベースプロダクト情報 （PostgreSQLバージョンの確認） |
［PostgreSQL 9.3.XX］もしくは［PostgreSQL 8.X］の場合 →今回のバージョンアップ作業で、PostgreSQL12のインストールが必要となります。本手順書に沿ってインストールを行ってください。［PostgreSQL 7.X］の場合 → バージョンアップ手順が本手順書と異なります。弊社へお問合せ下さい。 |
1-2 Javaバージョンの確認
- ［スタート］ – ［Windows システムツール］ – ［コマンドプロンプト］を実行してください。
- コマンド［java –version］を入力して、実行してください。
上記の様に Corretto-8 の文字列が存在している場合、amazon-corretto-8 が既にインストールされています。amazon-corretto-8 以外の java がインストールされている場合、必ず同梱の amazon-corretto-8をインストールしてください。
1-3 Tomcatバージョンの確認
［$CATALINA_HOME/RELEASE-NOTES］にバージョンの記載があります。
［Apache Tomcat 9.X］の場合
今回のバージョンアップではTomcatのバージョンアップは必要ありません。
［Apache Tomcat 6.X］の場合
今回のバージョンアップで、Tomcat9のインストールが必要となります。
本手順書に沿ってインストールを行ってください。
［Apache Tomcat 5.X］の場合
今回のバージョンアップで、Tomcat9のインストールが必要となります。
本手順書に沿ってインストールを行ってください。
■［$CATALINA_HOME/RELEASE-NOTES］が見当たらない場合
[スタート]メニュー内にある [Apache Tomcat x.0 Tomcatx]を確認してください。xの部分がTomcatのバージョン番号になります。
バージョン9以外がインストールされている場合、同梱のTomcat9を必ずインストールしてください。
1-4 PostgreSQLバージョンの確認
［スタート］メニュー［PostgreSQL xx］ を確認してください。x の部分が PostgreSQL のバージョン番号になります。
バージョン 12 以外がインストールされている場合、必ず同梱の PostgreSQL をインストールしてください。
２．バックアップ取得
バージョンアップの実行前にデータベースのバックアップを行います。
バックアップを行うことにより、バージョンアップの途中で問題が発生した場合でもデータを復旧する事が出来ます。
2-1 Tomacatの停止
BizMagic をログアウトして Tomcat を停止します。（Tomcat を停止すると BizMagic は起動できなくなります）
- ［スタート］－［プログラム］－［Apache Tomcat X.X］－［Configure Tomcat］をクリックしま
す。 - ［General］タブ －［Stop］をクリックして［OK］をクリックします。
2-2 データベースの確認
BizMagicで使用しているデータベースの情報を確認します。
（使用スキーマ名、ユーザ名、DBパスワード、ポート番号を確認済みの場合は、2-3 データベースのバックアップを取得 へお進みください）
- Tomcat インストールフォルダ内にある WEB-INF フォルダを開きます
（例）C:\BizMagic¥Tomcat6\webapps\（コンテキスト名）\WEB-INF - ［web.xml］をダブルクリックして、下記の値を確認します。
■データベーススキーマ名
<!-- DataBase Schema -->
<init-param>
<param-name>dbschema</param-name>
<param-value>データベーススキーマ名</param-value>
</init-param>■データベースユーザ名
<!-- DataBase User -->
<init-param>
<param-name>dbuser</param-name>
<param-value>データベースユーザ名</param-value>
</init-param>■データベースユーザパスワード
<!-- DataBase Password -->
<init-param>
<param-name>dbpassword</param-name>
<param-value>データベースユーザパスワード</param-value>
</init-param>■データベースサーバ名
<!-- DataBase Host (postgresql) -->
<init-param>
<param-name>dbhost</param-name>
<param-value>データベースサーバ名</param-value>
</init-param>■データベースポート番号
<!-- DataBase Port (postgresql) -->
<init-param>
<param-name>dbport</param-name>
<param-value>データベースポート番号</param-value>
</init-param>
- 設定ファイル（XML）を修正すると、BizMagicが起動できなくなる場合があります。ご注意ください。
2-3 データベースのバックアップを取得
- ［スタート］－［プログラム］－［PostgreSQL X.X］－［pgAdminⅢ］をクリックします。
- BizMagic で利用している PostgreSQL サーバをダブルクリックします。
（パスワードの入力が必要な場合は、スーパーユーザーのパスワードを入力します）
- ［データベース］をダブルクリックします。
- BizMagic で利用している［データベーススキーマ名］を右クリックして［バックアップ］をクリックします。
- バックアップ保存先を選択し、バックアップファイル名を入力して［OK］をクリックします。
＊ファイル名の拡張子は［.backup］としてください。
- ［０のリターンコードを返しました］の文言が表示されたらバックアップは完了です。必ず画面をスクロールしてエラーが表示されていないことを確認して［完了］をクリックします。
- バックアップファイルが取得できていることを確認して［pgAdminⅢ］を終了します。
３．PostgreSQLバージョンの確認、インストール
BizMagic Version4.0.19で使用するデータベースは［PostgreSQL12］のみとなります。
12以外のバージョンがインストールされている場合は、手順に沿って新たにインストールしてください。
3-1 データベースバージョンの確認
PostgreSQL 12 の場合
バージョンが PostgreSQL 12 の場合はDBのインストールの必要はありません。
4. Javaの確認、インストール へお進みください。
［PostgreSQL 9.x］、［PostgreSQL 8.x］の場合
PostgreSQL12をインストールします。3-2 PostgreSQL12のインストール へお進みください。
［PostgreSQL 7.x］の場合
バージョンアップ手順が本手順書と異なります。弊社までご連絡ください。
3-2 PostgreSQL12のインストール
インストーラー
BizMagic インストールプログラム内
postgresql-12.xx-xx-windows-x64.exe
インストール手順
インストールマニュアル Windows ［2 PostgreSQLのインストール］を実施してください。
（Web サーバとデータベースサーバの２台構成の場合 ２-３データベースサーバのファイアウォール設定 も実施ください）
データベースロール名とデータベース名について
- データベースロール名とデータベース名は、PostgreSQL8.x、9.x で使用していたものと同じ名前で作成してください。
- PostgreSQL8.X、もしくは 9. X がインストールされているサーバへ PostgreSQL12 のインストーラーを実行すると、ポート番号指定画面で［5433］が表示されます。PostgreSQL8.X、9.X とは異なる未使用ポート番号を入力ください。
- 未使用ポートを調べる方法は インストールマニュアル Windows ［使用されているポートの確認方法］をご参照ください。
3-3 バックアップデータのリストア
2-3 データベースのバックアップ取得 で取得したデータを復元します。
リストア手順
インストールマニュアル Windows ［8-2 リストア］を実施してください。
- 「リストアにてエラーを無視しました」等のエラー表記がある場合は、必ずスクロールして内容を確認してください。
インストールマニュアル Windows ［エラーが表示される場合］にエラー例が記載されています。こちらに記載のないエラーが表示される場合は作業を中断して弊社までご連絡ください。 - BizMagic 導入時に PostgreSQL7.x を使用しており、その後 PostgreSQL8.x へバージョンアップされたお客様の場合、データのリストアで複数エラーが表示される場合があります。このようなお客様の場合データ変換が必要となります。その場合は下記を参照ください。
BizMagic インストールプログラム内
Windows\setup\ convert\旧 BizMagic データ変換手順.pdf
3-4 PostgreSQL8.x、もしくは 9.x の停止
- ［スタート］－［管理ツール］－［サービス］をクリックします。
- ［postgresql-x64-x.x - PostgeSQL Server x.x］をダブルクリックします。（x にはそれぞれのバージョン番号が入ります）
- ［スタートアップの種類］を［手動］へ変更し、［停止］をクリックして［OK］をクリックします。
４．Javaの確認、インストール
BizMagic Version4.0.19 で使用する Java は［amazon-corretto-8.xxx.xx.x］です。
4-1 Javaバージョンの確認
Javaバージョンの確認 で確認したバージョンが、amazon-corretto-8 以外の java がインストールされている場合 Tomcat9 をインストールします。
4-2 amazon-corretto-8.x のインストール
インストーラー
BizMagic インストールプログラム内
Windows\setup\amazon-corretto-8.xxx.xx.x-windows-x64.msi
インストール手順
インストールマニュアル Windows ［3．Java8のインストール］を実施してください。
５．Tomcatの確認、インストール
BizMagic Version4.0.19 で使用するTomcatは Tomcat9.x です。Tomcat9以外のバージョンがインストールされている場合は新たにインストールする必要があります。
5-1 Tomcatバージョンの確認
Tomcatバージョンの確認 で確認したバージョンが、Tomcat6、または5 の場合は、Tomcat9をインストールします。
5-2 Tomcat9のインストール
インストーラー
BizMagicインストールプログラム内
Windows\setup\apache-tomcat-9.xx.xx.tar.gz
インストール手順
インストールマニュアル Windows ［4．Tomcat9 のインストール］ を実施してください。
ポート番号について
下記のポート番号指定画面で は Tomcat 5 もしくは 6 と 同 ポート 番号で問題ありません。
環境変数の編集
環境変数の設定 を行う 場合は、 既存の［ CATALINA_HOME ］［ PATH ］の 編集 を行ってください。
６．BizMagicバージョンアッププログラムのインストール
6-1 BizMagicのインストール
インストーラー
BizMagicインストールプログラム内
Windows\setup\ BizMagic4.x.xx-JRE8-PostgreSQL12.zip を解凍します。
BizMagicインストール終了後、解凍したファイルは削除してください。
インストール手順
- Tomcatを停止します。停止方法はこちらを参照してください。
- 解凍されたフォルダ［inst］内の［install.bat］をダブルクリックして実行します。
- ［Tomcatのホームディレクトリを入力してください（現在ご使用中もしくは新規）］と表示されます。
Tomcatインストール状況によって入力値が異なります。下記へ従って入力ください。 - ［Tomcatバージョンの確認］で確認したバージョンがTomcat9の場合は こちら
- ［Tomcatバージョンの確認］で確認したバージョンがTomcat５,6の場合は、下記［6‐2］へお進みください。
6-2 [Tomcatバージョンの確認］で確認したバージョンがTomcat5、6の場合
- 今まで使用していたTomcat5、もしくはTomcat 6のディレクトリを入力してください。
- ［移行先のTomcatホームディレクトリを入力してください］と表示されます。今回インストールしたTomcat 9 ディレクトリを入力してください。
- ［ｙ］を入力してください。
- 括弧内のコンテキストが正しいことを確認してENTER押下ください。
- 以前のAJPポートの設定を引継ぐ場合はYを選択してください。（通常はNを選択してください。以前のBizMagic が SSL で運用されている場合など Apache 連携されている場合のみ Y を選択してください。）
- 各ポート番号が正しいことを確認してENTER押下ください。
- ホスト名、ユーザ、スキーマ名、パスワード等を確認してENTER押下ください。
- データベースポート番号は必ず PostgreSQL12のポート番号を入力 下さい。
今回のバージョンアップ作業でPostgreSQL 12 をインストールした場合、括弧内にはPostgreSQL8.x または 9.3 のポート番号が表示されています。必ず PostgreSQL 12 のポート番号を入力し直してください。
9.3または8.xのポート番号が入力された場合、エラーになりインストールが中止されます。 - データベースの接続を確認後、［y］を入力してください。
- ENTER押下して終了します。
- インストールを中断する場合は［Ctrl+C］を押下してください。
6-3 [Tomcatバージョンの確認］で確認したバージョンがTomcat9の場合
- バージョンアップインストール時に入力待ち状態（「？」表示）の前、既にインストールされているバージョンアップ対象のBizMagicの情報がカッコ（[ ]）内に表示されます。カッコ内の情報でよければ、そのまま［Enter］押下で値が入力されます。
- Tomcatホームディレクトリを指定します。インストール時の環境変数で設定したCATALINA_HOMEの値が表示されます。問題なければ[ENTER]押下で進めてください。
Tomcatのホームディレクトリを入力してください。（現在ご使用中もしくは新規）(必須)
[C:\BizMagic\Tomcat9]:? - 下記表示がされた場合は［ｙ］を入力して進めてください。
(!) デフォルトコンテキストを検出 [docs, examples, ROOT]
指定のTomcat内に上記デフォルトのコンテキストが存在します。
（セキュリティ上削除される事をお勧めします）
削除してよろしいですか？(Y/N)? - アップデートを行うコンテキスト名を指定します。表示されているコンテキストが正しければ、［Enter］押下で進めてください。
(i) 既存コンテキスト [run]
コンテキスト名を入力してください。
（"ROOT"を入力されるとドメインのルート上に配置されます）(必須)
[run]:? - Tomcatが使用するポートやデータベース情報が表示されます。表示されているポート番号やデータベース情報が正しければ［Enter］押下で進めてください。
(i) Tomcat現在の設定 [HTTP port:8080 / AJP port:8009 / SHUTDOWN port:8005]
HTTPポート番号を入力してください。(必須)
[8080]:?
AJPポート番号を入力してください。(必須)
[8009]:?
SHUTDOWNポート番号を入力してください。(必須)
[8005]:?
-------------------------------------------------------------------------------
データベースホスト名を入力してください。(必須)
[localhost]:?
データベースユーザを入力してください。(必須)
[run]:?
データベーススキーマ名を入力してください。(必須)
[run]:?
データベースパスワードを入力してください。(必須)
[runrun]:?データベースポート番号を入力してください。(必須)
[5432]:?Apache連携などでAJPポートを使用されていなければ、AJPポートの情報と入力は表示されません。
データベース情報などが正しく表示されない場合は、コンテキスト名を誤って入力している可能性があります。その場合はすぐにインストールを中断（Ctrl+C）して再度実行してください。 - データベース接続エラーが表示された場合は、上記で入力したデータベース情報を確認して、再度入力してください。
(!) データベース接続チェック中…FATAL:
(X) データベースに接続できません。接続情報を再入力してください。
- データベース接続に成功した場合、下記メッセージが表示されます。［ｙ］を入力して進めてください。
アップデートを行います。よろしいですか？(Y/N)? - ［ENTER］押下して終了します。
(i) インストールは正常に終了しました。
-- Enterキー --
6-4 Tomcat起動
- ［スタート］－［すべてのプログラム］－［Apache Tomcat9］－［Configure Tomcat］をクリックします。
- ［General］タブ－［Startup type］が［Manual］の場合は［Automatic］に変更します。［Service Status］－［Start］をクリックして［適用（ A ）］［ OK ］をクリックして終了します。
７．BizMagic起動確認
BizMagic4.0.19はFirefox、Google Chromeでご利用いただけます。
7-1 バージョンの確認
- ブラウザからBizMagicへ接続します。
- BizMagic［ENTER］画面が表示されます。［ENTER］クリックします。
- タブ表記のBizMagicのバージョンが、今回バージョンアップしたバージョンと一致しているかご確認ください。
- Tomcat起動後、 BizMagic へ接続できるまでの時間はご利用の環境により異なります。
5分以上待っても BizMagic へ接続できない場合や、ログイン出来ないなどの問題がある場合は、弊社までご連絡ください。
7-2 起動確認
インストールマニュアル Windows ［6．起動確認］ を参照ください。
８．BizMagic簡易バックアップ確認
今回のバージョンアップでPostgreSQLやTomcatを新たにインストールした場合は、BizMagic簡易バックアップファイル［backup.bat］の記述を変更する必要があります。
また、今までバックアップ設定をされていなかったお客様は、BizMagicインストールプログラム内の同梱のファイルを使用して設定をお願いいたします。
8-1 BizMagic簡易バックアップファイル
簡易バックアップファイル
BizMagicインストールプログラム内 Windows\setup\backup
-
- bat（データベース、コンテキスト名等の記述をするファイルです）
- jar
- bat
backup_load.batについて
2017年より配布開始しました。backup.batを実行してログファイルを作成するためのファイルです。
正しくコマンドを入力できる方の場合、こちらのファイルは必ずしも必要ではありません。
8-2 BizMagic簡易バック設定
インストールマニュアル Windows ［8-1 BizMagicのバックアップ］ を設定してください。