インストール前に決定する事項インストールを行う前に以下の情報を決定、確認します。(デフォルト値:run)■NOTEデータベースユーザ名、データベーススキーマ名には[-](ハイフン)は使用できません。(アンダーライン)の使用は可能です。データベースユーザ名、データベーススキーマ名の先頭文字に数字は使用できません。データベースユーザ名、データベーススキーマ名に[postgres]は使用できません。連携時に使用しますコンテキスト名は大文字小文字が区別されます。空白や全角文字を含まないものとします。BizMagicの構成BizMagicはDBサーバとWebサーバとクライアント端末から構成されています。BizMagicユーザーは、LAN(ローカルエリアネットワーク)で繋がれたPCから、ブラウザを通じて情報の登録や、閲覧、検索などをすることができます。外出先からでもスマートフォン等を利用することにより、インターネット経由で利用可能です。Server等の、汎用的な複数OSに対応しています。Chrome、Safariがご利用いただけます。:Webサーバと接続できる環境Webサーバを同一サーバに置いての動作も可能です。セキュリティ、応答速度を考慮した場合には、別サーバでの運用も可能です。以下作業は、サーバへ管理者権限(Administrator)でログインして行ってください[スタート]-[Windows管理ツール]-[サービス]をクリックします。Logon]をダブルクリックします。[全般]タブ-[スタートアップの種類]を[自動]を選択、[サービスの状態]を[開始]をクリックして[OK]をクリックします。ダブルクリックします。(xx=バージョン番号)[Next>]をクリックします。インストール先フォルダを指定して、[Next>]をクリックします。Builder]のチェックを外して[Next]をクリックします。データ格納フォルダを指定して[Next>]をクリックします。例:C:\BizMagic\PostgreSQL12¥dataデータベース管理者のパスワードを入力して[Next>]をクリックします。ポート番号を入力して[Next>]をクリックします。(デフォルト値「5432」が入力されています。お使いの環境により適宜変更ください。)[C]を選択して[Next>]をクリックします。[Next>]をクリックします。[Next>]をクリックしインストール開始します。[Finish]をクリックします。データベースの作成[スタート]-[PostgreSQL12]-[pgAdmin4]をクリックします。pgAdmin4が起動します。初回起動時に、このpgAdmin4任意のマスターパスワードを入力します。([PostgreSQL12インストール]の6で入力した「データベース管理者のパスワード」の入力をお勧めします。)次回以降の起動時は、このパスワードでpgAdmin4を開きます。pgAdmin4の初期設定を行います。pgAdminを実行してください。PathにPostgreSQLをインストールしたパス+\binを入力してください。例)C:\BizMagic\PostgreSQL12\bin\データベースユーザーとデータベースの準備を行います。[Server]またはもしくは[PostgreSQL12]をダブルクリックします。Password]をチェック)OKボタンをクリックします。Roles]をクリックします。設定した[データベースユーザ名]を入力します。設定した[データベースパスワード]を入力します。login]を[Yes]へ変更して[Save]をクリックします。データベースユーザが作成されました。続いてデータベースを作成します。Database]をクリックします。設定した[データベースユーザ名]を選択[Definition]タブ-[Encoding]、[Template]を選択して[Save]をクリックします。[Template0]を選択データベースが作成されました。[×]をクリックしてpgAdmin4を終了します。■POINT以下のようなダイアログが表示された場合は、[このページを離れる]をクリックして終了させてください。作成したデータベースの接続確認をします。Shell(psql)]をクリックします。各値を入力して[Enter]を押下します。インストール前に決定する事項で設定したデータベースユーザパスワード[Server]、[Port]は[***]の中が一致している場合[Enter]押下して進めます。Shell(psql)]を終了します。PostgreSQLパスワードファイルの設定BizMagic簡易バックアップでpostgresユーザーのパスワード入力を省略するために、パスワードファイルを設定します。エクスプローラーを起動します。アドレスバーへ[%APPDATA%]と入力します。[postgresql]フォルダをクリックします。なければフォルダを新規に作成します。フォルダ内でファイル名[pgpass.conf]を新規で作成し、メモ帳などで開き下記のように設定行を追加してください。データベースオプションの設定PostgreSQL12のインストールの5で指定したデータ格納フォルダ内にある[postgresql.conf]ファイルをメモ帳などテキスト形式で開きます。下記の通り編集してください。128kB下記を目安にサイズを変更してください。on]の[#]を削除します。編集したデータベースオプションを反映させるために、PostgreSQLの再起動が必要になります。[サービス]を起動して、[postgresql-x64-12]サービスの停止、開始を行ってください。データベースアクセス許可設定DBサーバとWebサーバを分ける場合や、他PCからデータベースに接続を許可する場合など、必要に応じてアクセス許可設定をします。PostgreSQL12のインストールの5で指定したデータ格納フォルダ内にある[pg_hba.conf]ファイルをメモ帳などテキスト形式で開きます。[pg_hba.conf]最終行に値を追加します。例)192.168.1.*のIPアドレスからの接続を許可する場合、下記のように設定します。■NOTE[METHOD]に[md5]や[passowrd]を設定した場合、接続の際にパスワード入力が必要となります。セキュリティ上安全性が保持できる環境であれば[trust]でも問題ありません。[pg_hba.conf]ファイルを保存して終了します。configuration]をクリックします。下記の様に表示されていることを確認して終了します。PostgreSQL自動起動設定[スタート]-[Windows管理ツール]-[サービス]をクリックします。[postgresql-x64-12]をダブルクリックします。[スタートアップの種類]が[自動]、[サービスの状態]が[実行中]になっていることを確認してください。*[スタートアップの種類]が[自動]以外の場合は[自動]に変更し、[サービスの状態]が[停止]の場合は[開始]をクリックして[OK]をクリックしてください。*[自動]の場合、サーバ再起動した際にPostgreSQLが自動起動されます。本設定は、Webサーバとデータベースサーバの2台構成の場合のものです。Webサーバとデータベースサーバが同一筐体にある場合はこの設定は必要ありませんので、3.Java8のインストールへ進んでください。Webサーバとデータベースサーバの2台構成の場合は、Webサーバからネットワーク越しにデータベースサーバが接続できるように設定する必要があります。2台のネットワークが設定されている状態で、ファイアウォールの設定を行います。ICMPv4の設定インストール時にデータベースサーバの接続を確認するため、ICMPv4を許可する必要があります。ファイアウォールの設定は、サーバーマネージャーから[セキュリティが強化されたWindowsファイアウォール]を起動します。[カスタム]を選択して、[次へ]を実行します。[すべてのプログラム]を選択して、[次へ]を実行します。[プロトコルの種類]に[ICMPv4]を選択して、[次へ]を実行します。ローカルIPアドレスとリモートIPアドレスを[任意のIPアドレス]を選択して、[次へ]を実行します。(この設定についてご理解できる方は、適宜変更してください)[接続を許可する]を選択して、[次へ]を実行します。設定に名前を入力して、完了してください。PostgreSQL用ファイアウォール設定[ポート]を選択して、[次へ]を実行します。[特定のローカルポート]のPostgreSQLのポート番号を入力して、[次へ]を実行します。[接続を許可する]を選択して、[次へ]を実行します。バブリック以外をチェックして、[次へ]を実行します。(この設定についてご理解できる方は、適宜変更してください)[名前]を入力して、完了してください。Webサーバのインストール環境Windows環境でWebサーバ(BizMagic)を利用する場合、データベース以外に次の環境が必要です。8GB以上(アクセス数により追加が必要)同時接続数が100以下の場合Tomcat必要メモリはインストールデフォルト値の1024MBで可動します。memory]が表示されBizMagicが停止する場合があります)同時接続数が100を超える場合Tomcatは以下の計算を基準にメモリ設定を変更してください。Tomcatの使用メモリを増やしてください。インターネットからアクセスするポートとして、1ポート必要です。Apache連携する場合必要となります。[業務依頼]機能などで[緊急]を利用する場合、お客様側で用意するメールサーバへ接続して情報を送信します。SMTPサーバは必須となります。お使いの環境によってはPOPサーバの設定も必要となります。SMTP)管理者のメールアドレスが必要となります。インストール時に指定するHTTPポートの受信を許可する設定が必要です。BizMagicで利用するデータベースが動作するデータベースサーバーと接続できる環境。WEBサーバはDBサーバと同一筐体で動作可能ですが、セキュリティ、応答速度を考慮した場合に別筐体での運用も可能です。Java8のインストールBizMagicインストールプログラム内Windows\setup\amazon-corretto-8.xxx.xx.x-windows-x64をダブルクリックします。[Next]をクリックします。インストールフォルダを変更する場合は[Browse]をクリック、フォルダを選択して[Next]をクリックします。(例:C:\BizMagic\Java8)[Install]をクリックします。Javaがインストールされました。[Finish]をクリックします。■POINT前バージョンまで行っていた環境変数[JAVA_HOME]の設定は、Java8のインストールでは必要ありません。環境変数[JAVA_HOME]と[Path]は下記のように設定されます。mode)C:\Users\Administrator>インストールした正しいJavaのバージョンが表示されている事を確認してください。■NOTE下記のようなエラーメッセージが表示された場合、インストールしたJavaのPathの優先度を上げてください。右下Windowsを検索ー”システムの詳細設定表示の表示”の入力ー検索結果から実行ー詳細設定タブー環境変数を実行してください。Path変数を選択して、編集ボタンを押してください。上へボタンを押して、Java8の優先度を一番上に移動してください。環境変数名の編集ーOKボタンー環境変数ーOKボタンで画面を終了してください。Tomcat9のインストールBizMagicインストールプログラム内Windows\setup\apache-tomcat-9.x.xx.exeをダブルクリックします。[Next]をクリックします。Agree]をクリックします。[Next]をクリックします。HTTPポートが表示されます。変更する場合は値を入力します。変更しない場合は[Next]をクリックします。Port]が[-1]の場合、1以上の数値を入力してください。8005■POINTHTTPポートはクライアントからアクセスするためのポートです。下記の方法で使用されていないポートを確認し、指定する必要があります。]入力3下記の様に表示されます。[プロトコル][アドレス]に表示されたポートはBizMagicのポートとして利用することができません。ポートとBizMagicURLBizMagicは下記のURLとなります。http://www.bizmagic.com/run/先にインストールしたJavaのパスが表示されます。確認して[Next]をクリックします。例:C:\BizMagic\Java8\jre8*表示されたフォルダが、前項でインストールしたJava8である事を必ず確認してください。インストールしたJava8と異なる表示の場合は指定し直してください。Tomcatインストールフォルダを指定して[Install]をクリックします。例:C:\BizMagic\Tomcat9インストールするフォルダは空白や全角文字を含まないものにする必要があります。Readme]のチェックを外して[Finish]をクリックします。-[システム]-[システムの詳細設定]-[詳細設定]タブ-[環境変数]をクリックします。[新規]をクリックします。C:\BizMagic\Tomcat9)システム環境変数[PATH]を選択して[編集]をクリックします。[新規]をクリックします。Tomcatインストールフォルダに¥binを付加したアドレスを入力し[OK]をクリックします。例:C:\BizMagic\Tomcat9\bin[OK]をクリックします。Tomcat]をクリックします。pool]の値を変更します。Options]に下記の文字列を追加して[OK]をクリックします。複数のTomcatをインストールしている場合や、Tomcatインストール後にデフォルトポート番号を変更する場合は下記ファイルを修正します。/>HTTPポートはクライアントからアクセスするためのポートです。AJPポートはApacheと連携する場合に必要なポートです。BizMagic4.x.xx-JRE8-PostgreSQL12.zipを解凍します。BizMagicインストール終了後、解凍したファイルは削除してください。[\解凍先フォルダ\inst\bat]を起動します。■POINTインストーラが起動しない場合は[JAVA_HOME]の設定が正しく出来ていない可能性があります。インストールを中断する場合は[CTRL+C]押下してください。Tomcatのホームディレクトリを入力します。括弧内に[CATALINA_HOME]設定値が表示されますので、確認してENTERを押下ください。Tomcatのホームディレクトリを入力してください。確認し、正しい値を設定してください。下記の画面が表示された場合は[y]をクリックします。表示されない場合は次項へ進みます。ROOT]指定のTomcat内に上記デフォルトのコンテキストが存在します。(セキュリティ上削除される事をお勧めします)削除してよろしいですか?(Y/N)?y[インストール前に決定する事項]で決定したコンテキスト名を入力します。[Tomcatインストールディレクトリ/webapps]直下にコンテスト名フォルダが作成されます。コンテキスト名を入力してください。("ROOT"を入力されるとドメインのルート上に配置されます)(必須)[run]:?各ポート番号を入力します。括弧内のポート番号が正しい場合はENTERを押下して進めます。port:8005]HTTPポート番号を入力してください。(必須)[8080]:?SHUTDOWNポート番号を入力してください。(必須)[8005]:?データベースホスト名を入力します。WEBサーバとDBサーバが同一サーバの場合は[localhost]または[127.0.0.1]と入力します。(データベースホスト名を入力してください。(必須)?localhostインストール前に決定する事項で決定したデータベースユーザ名、スキーマ名、パスワードを入力します。データベースユーザーを入力してください。(必須)?runデータベーススキーマ名を入力してください。(必須)?runデータベースパスワードを入力してください。(必須)?runrunデータベースポート番号を入力します。データベースポート番号を入力してください。(必須)?5432[y]を入力します。新規にインストールします。y[y]を入力します。データベースを作成します。BizMagicのスキーマを作成します。よろしいですか(Y/N)?y下記表示を確認してENTER押下します。以上でBizMagicのインストールは完了です。インストールは正常に終了しました。ライセンスキーの登録はBizMagicへログイン後、システム設定から実行してください。インストール時のエラーインストールでエラーが発生した場合には下記を参考に対応ください。こちらに記載されている以外のエラーについては各サポートデスクへお問い合わせください。インストーラが起動しない環境変数[PATH]に[Javaインストールフォルダ\bin]が設定されているか確認ください。例外が発生したため、インストールは中断しましたTomcatの設定に問題があります。既存のTomcatを利用する場合、server.xmlファイルなどが書き換えられている、もしくはインストールが正しく行われていないことが考えられます。別フォルダにTomcatをインストールしてください。例外が発生したため、インストールは中断しました入力したデータベースユーザ、データベーススキーマが存在するか確認してください。入力したデータベースパスワード、データベースホスト名、データベースポート番号を確認してください。入力したデータベースホストに対してサーバからアクセスできるか確認してください。PostgreSQLのpg_hba.confファイルに自サーバに対してアクセスできるよう設定してあるか確認してください。Tomcat]をクリックします。Status]-[Start]をクリックして[適用(A)][OK]をクリックして終了します。■POINT1Tomcatを停止する方法は以下の通りです。Tomcat]をクリックします。Status]-[Stop]をクリックして[適用(A)]もしくは[OK]をクリックします。Chromeとなります。URLは以下のようになります。bizmagicログインIDBizMagicインストール直後は、次のユーザーでログインしてください。インストールサーバでの起動確認インストールサーバ(複数サーバの場合はWEBサーバ)でブラウザを起動してURLを入力し、BizMagicへアクセスしてください。正常な起動[ENTER]画面が表示されます。[ENTER]クリックします。ログイン画面が表示されます。ログインID、パスワード入力し[ログイン]をクリックします。ライセンス管理画面が表示されます。ライセンスの登録方法はBizMagicオンラインヘルプ-[資料]-[ライセンス追加手順]をご覧くださいEnter画面が表示されない場合Tomcatが起動していません。(Tomcatの起動は時間がかかる場合があります。)■対応方法サーバの現在の状態を確認して、Tomcatを起動します。設定が正しく行われているかご確認ください。Tomcatログを確認ください。参照)ID、パスワード入力画面が表示されない場合データベースが起動していません。正しく行われているかご確認ください。クライアント端末での起動確認クライアント端末でブラウザを起動しBizMagicへアクセスしてください。クライアント端末でBizMagicへアクセスするためには、インストールサーバ側でファイアウォールの設定が必要な場合があります。正常な起動[ENTER]画面が表示されます。[ENTER]クリックします。ログイン画面が表示されます。ログインID、パスワード入力し[ログイン]をクリックします。ライセンス管理画面が表示されます。BizMagicオンラインヘルプ-[資料]-[ライセンス追加手順]をご覧ください。目次へ戻るENTER画面が表示されないENTER画面が表示されない場合は下記の原因が考えられます。URLが間違っている。Tomcatが起動していない。Webサーバがファイアウォールで制限されている。■POINTTomcatの起動には時間がかかる場合があります。時間が経っても起動しない場合は一度ブラウザを閉じ再度接続してください。目次へ戻るログイン画面が表示されないログイン画面が表示されない場合は下記の原因が考えられます。データベースが起動していません。正しく行われているかご確認ください。データベースのアクセス許可設定がされていません。データベースアクセス許可設定が正しく行われているかご確認ください。目次へ戻る7.TomcatログファイルTomcatのログファイルでは、Tomcatやデータベースの起動について確認することができます。Tomcat起動確認ファイル名:CATALINA_HOME\logs\commons-daemon.YYYY-MM-DD.logYYYMMDDには日付が入ります日付は、最新サーバ起動日のものを選択してくださいTomcatが正しく起動している場合、下記のメッセージが表示されます。milliseconds」の?????に入る数字はそれぞれ異なります。Tomcatログ出力レベルの設定によって表示されない場合があります。(デフォルトでは表示されます。データベースとTomcatの接続確認データベースとTomcatの接続で問題がある場合、下記のエラーメッセージが表示されます。ファイル名:CATALINA_HOME\logs\[tomcatサービス名]-stderr.YYYY-MM-DD.logYYYMMDDには日付が入ります日付は、最新サーバ起動日のものを選択してくださいTomcat起動からログに出力されるまで5分以上かかる場合があります。データベースが起動していない可能性があります。データベースの接続設定を確認してください。複数のTomcatがインストールされている状態でそれぞれのポートが重複している場合や、他のソフトウェアが同じポートを使用している場合、下記のエラーメッセージが表示されます。ファイル名:CATALINA_HOME\logs\[tomcatサービス名]-stderr.YYYY-MM-DD.logYYYMMDDには日付が入ります日付は、最新サーバ起動日のものを選択してください既にTomcatが起動しているか、ポートが他のアプリケーションで利用されている可能性があります。ログ検索キーワード:BindException起動しているTomcatをすべて停止し、ポート番号が利用されていないことを確認の上Tomcatを再起動するか、BizMagicを再インストールして使用していないポート番号を指定します。Tomcatのポートはデフォルトの場合、HTTP用ポート:8080、AJP用ポート:8009です。管理者メールの設定に誤りがある場合BizMagicの左メニュー[システム設定]‐[メール設定]の[管理者用メールアドレス]の設定に誤りがある場合、BizMagicのメール送信機能が利用できなくなり、以下のメッセージがTomcatのログに出力されます。YYYYMMDD.log■ログファイルの場所:CATALINA_HOME\webapps\コンテキスト名\WEB-INF\logs\YYYYMMDD\*YYYMMDDには日付が入りますメールサーバ名を間違えている、またはメールサーバへアクセス出来ない状態の場合POP認証の設定に誤りがある場合いずれの場合も[システム設定]‐[メール設定]でメールサーバの接続情報を正しく入力してください。管理者に連絡してください]と表示される場合は、インストール時に設定したTomcatのメモリ最大容量が不足している可能性があります。Tomcatのログを確認してください。OutOfMemoryErrorTomcatメモリ設定は下記の作業を行います。Tomcatを停止します。Tomcatの停止方法はTomcat起動-■POINTを参照ください。Tomcatのメモリ設定値を変更します。pool]の値を修正します。Tomcatを起動します。目次へ戻る8.バックアップとリストアBizMagicのデータを外部へ保存するために、バックアップの設定を行ってください。障害時の復旧のための手順の確立も必要となります。簡易バックアップBizMagicの簡易バックアップツールとして、BizMagicインストールプログラム内のWindows\setup\backup\backup.batをご提供しています。[backup.bat]以外の専用バックアップソフトウェアを使用する際は、ご利用のソフトウェアの手順に従い設定を行ってください。backup.batについて[backup.bat]でのバックアップ対象はデータベースと添付ファイルです。[backup.bat]は同一筐体にTomcatとデータベースをインストールした環境での動作を想定しています。別筐体にそれぞれをインストールした環境ではバッチファイルを修正してください。保存先のメディアによっては修正が必要な場合があります。Windows\setup\backupフォルダ内にあるファイルをコピーします。C:\BizMagic\backupbackup.batをエディタソフトなどで開き、下記部分について利用している環境に合わせて修正を行います。赤字部分を修正します。修正後、上書き保存します。Tomcatログを残す日数backup.batを実行します。[STR_DIR]で指定したフォルダに実行日時名フォルダが作成されます。例:D:\backup\data\20181001_0400002バックアップログの取得設定バックアップ実行時にログを取得するには[backup.bat]を直接実行せずに、BizMagicインストールプログラム内の[backup]フォルダ内にある[backup_load.bat]を実行ください。C:\BizMagic\backupbackup_load.batを実行すると指定フォルダへ[backuplog.txt]が作成されます。■POINTバックアップ実行後、ログにエラーが表示された場合は[backup.bat][backup_load.bat]の修正箇所に誤りがある可能性があります。修正箇所を確認して再度実行してください。3backup_load.batの編集バックアップ用フォルダに[backup_load.bat]をコピーします。backup_load.batをエディタソフトなどで開き、パスを利用環境に合わせて修正を行います。4タスクスケジューラの設定[backup.bat][backup_load.bat]が正しく実行できたことを確認後、タスクスケジューラにて自動実行の設定を行ってください。[スタート]-[Windows管理ツール]-[タスクスケジューラ]をクリックします。[タスクの作成]をクリックします。[全般]タブのセキュリティオプションにて、下記にチェックを入れてください。・[ユーザーがログオンしているかどうかにかかわらず実行する]・[最上位の権限で実行する][トリガー]タブの新規ボタンからの設定画面で実行周期を設定します。[操作]タブの新規ボタンからの設定画面で[bat]を指定してください。リストアTomcatの停止Tomcat起動-■POINTの手順で停止します。DB、WEBサーバのインストール1障害の程度によってPostgreSQLをインストールする必要があります。手順でインストールします。2障害の程度によってJava及びTomcatをインストールする必要があります。手順でインストールします。手順で新たなログインロールとデータベースを作成してパスワードを設定します。DBのリストア[backup.bat]で作成されたバックアップデータをpgAdmin4からリストアします。作成したデータベースを右クリックします。2[フォーマット][ロール名]を選択して[リストア]をクリックします。リストア先DBの作成]で作成したロール名を選択します3リストアが終了すると[プロセスは1のリターンコードを返しました。4[キャンセル]をクリックして終了します。スクロールして内容を確認してください。■エラー例1エラー数が1で下記赤枠内の内容であれば問題ありませんので、[キャンセル]をクリックして終了します。■エラー例2エラー数が1で下記赤枠内の内容であれば問題ありませんので、[キャンセル]をクリックして終了します。existリストア先データベースのオーナーが、バックアップ元データベースのオーナーと異なる場合に出るエラーです。エラーは複数表示されます。この場合は問題ありませんので、[キャンセル]をクリックして終了します。existsPostgreSQL9.3のバックアップデータをPostgreSQL12へリストアした時に出る場合があります。この場合は問題ありません。手順でBizMagicをインストールします。リストアした内容を入力します。添付ファイルのリストア[backup.bat]で取得したフォルダ内の[コンテキスト名]¥attachedフォルダの中身を全て、Tomcatインストールフォルダ\webapps\コンテキスト名\WEB-INF\attachedへリストアします。手順で正常にBizMagicへログインできることを確認してください。目次へ戻る9.障害時の復旧方法BizMagicへ接続できない場合、下記をお試しください。Tomcat再起動Tomcatの停止Tomcat起動-■POINTの手順で停止します。Tomcatの起動Tomcat起動の手順で起動します。Tomcat」を一度閉じ、再度開くとTomcatの起動ができるようになります。