オンプレミス（自社サーバー）の設置（NASを含む）

必要であれば、あなたの組織が自社のサーバーを維持する能力がある場合、Ragicを独自のサーバーでホストすることができます。自社サーバーは、サーバーを安全かつセキュアに維持する方法を理解している経験豊富なITスタッフがいる企業のみに使用することを強くお勧めします。

自社サーバーの場合、追加費用は発生しませんが、購入ユーザーは最低10名で、プランの年払いが必要です。 詳細については、 価格ページをご参照ください。

インストールガイド

1. RagicサービスをホストするサーバーにJDK8がインストールされていることを確認してください。 JDK 8がインストールされていない場合は、JDK 8をインストールします。JDKは、 こちら または こちらからダウンロードできます。
2. Ragicのzipファイルをサーバーにアップロードしてください。 Ragic自社サーバー版は、Ragicのユーザーアカウントで www.ragic.com にサインオンし、 こちら から最新版をダウンロードできます。
3. ZIPファイルをRagicをインストールしたいディレクトリに解凍してください
4. Ragic購入後に送付されたライセンスファイル license.xml と sig の2つがあるはずです。 この2つのファイルをRagicディレクトリの下にあるディレクトリcustにコピーしてください。ここは、将来的にライセンスファイルを更新する場所でもあります。

   

5. Linuxシステムを使用している場合は、chmodを使用して、bin/ragic_dbv7.sh と bin/setclasspath_dbv7.shを実行する権限があることを確認してください。
6. 環境変数を設定する：

   JAVA_HOME: JDK 8のインストール先

   RAGIC_HOME: Ragicのインストール先

   Windowsの環境で、 PCを右クリックし、プロパティ を選択し、 システムの詳細設定を見つけて 環境変数 をクリックできます。

   環境変数を編集したくない場合は、ragic.sh（Linux）またはragic.bat（Windows）を編集して以下のようなラインを追加するだけでも可能です：

   JAVA_HOME= /usr/lib/jvm/java-8-openjdk-amd64

   RAGIC_HOME= /home/ragic

   また、 JAVA_OPTS="-Xms5g -Xmx5g の行を変更すると、Ragicが消費できるメモリ量をサーバーに伝えることができます。5gは5GBのメモリを消費することを意味します。JAVA_OPTS="-Xms10g -Xmx10g と設定すると、Ragicに10GBのメモリを与えることができます。 OSが正常に動作するために必要なメモリや、Ragicが動作するために必要なオフヒープメモリがあるため、サーバーで利用可能な物理メモリの70%以上をRagicに与えないようにしてください。

7. Ragic Serverを起動するには、以下のコマンドを実行します：

   Windowsの場合、Ragicディレクトリの下にあるディレクトリbinフォルダを探し、./ragic_dbv7.bat runと入力してください

   Linuxの場合、./bin/ragic_dbv7.sh manualと入力します。

   Linuxでは、ユーザーがセッションを終了してもプロセスが終了しないように、nohupを追加するか、システムサービスに追加することができます。 また、Linuxでは、Ragicをポート80にバインドするために、root権限またはsudoを使用してサービスを実行する必要があることに注意してください。Windowsの場合、ポート80にバインドするためには、十分な権限も必要です。

   Ragicを起動または再起動する際には、常にRagicのインスタンスが1つしか実行されていないことを確認する必要があります。 最も簡単な確認方法は、ブラウザを使ってRagicのURLに接続し、現在実行されていないことを確認することです。 Linuxでは、ps aux | grep javaというコマンドを使用して、すでに実行中のjavaプロセスがあるかどうかを確認することも可能です。Windowsの場合、Process MonitorでJavaのプロセスが動いているかどうかを確認することができます。Ragicを起動する前に、すべてのRagic Javaプロセスを終了させる必要があります。または、Ragicの複数のインスタンスを実行すると、エラーが発生します（すぐに気づかない場合もありますが）。

8. ブラウザでlocalhostにアクセスします（またはRagicリモートサーバーのIPアドレス/ドメイン名を入力します）。localhostのメインページは以下のように表示されるはずです。今作成したユーザーは、Ragicサーバーの管理者権限を持つことになります。 設定が完了すると、Ragic 自社サーバーインストールのデフォルトホームページが表示されます。これで、ホステされたRagicサーバーと同じように、必要なアプリをすべて作成することができるようになりました。

   

   Ragic Serverのセットアップが完了すると、この画面が表示されます：

   

   注：ウイルス対策プログラムによっては、Ragic Serverで問題が発生する場合がありますので、Ragic Server上で動作するウイルス対策ソフトウェアが特定のパス、プロセス、ファイルタイプを除外するように設定することをお勧めします。

9. （任意）オンプレミスサーバーがインターネットに接続できない場合、Ragic で PDF ファイルを生成するために PDF サービスを設定する必要があります。インストール手順については、こちらの記事をご参照ください。

LinuxでのRagicサービスの起動と停止

起動: sudo nohup ./bin/ragic.sh manual

中止: sudo pkill -f RagicJetty9Server

必要な場合を除き、サービスを強制的に停止することは推奨されませんので、ご注意ください。

自社サーバー設定(Private Server Config)

アップグレードを行う前に、Ragicディレクトリ内のすべてのバックアップを作成しておいてください！以下のパッチやフルバージョンをダウンロードする前に、Ragicにログインする必要があります。

ダウンロードが終了したら、以下のページからファイルをサーバーにアップロードしてください。

また、必要であれば、このページからライセンスを更新することも可能です。



サーバーURLとメールサーバーの設定

サーバーの設定が完了したら、「Private Server Config」で、SERVER_NAMEパラメータにサーバーIPまたはURLが正しく入力されていることを確認してください。 次に、メール機能の誤動作を防ぐために、メールサーバーの設定を入力してください。Private Server Configでこれらの設定を変更した後は、忘れずにRagicのサービスを再起動して、設定を適用してください。

Private Server Configのメールサーバー設定が以下の通りです：

SMTP_SERVER=The SMTP / SMTPS server domain name / IP

SMTP_SENDER_AUTH_USER=User name used to log in to SMTP

SMTP_SENDER_AUTH_PWD=Password used to log in to SMTP

SMTP_SSL_ENABLE=For SMTPS put true, SMTP put false

SMTP_PORT=Port to connect to your SMTP service

SMTP_SSL_PORT=Port to connect to your SMTPS service

SMTP_SENDER_PERSONAL=The name used when Ragic sends out an e-mail

SMTP_SENDER_EMAIL=The reply to address used when Ragic sends out an e-mail

ファイアウォール設定

ファイアウォールの設定には、インバウンド接続とアウトバウンド接続があります。 Ragicにアクセスさせたい場合は、インバウンドポート80 / 443を開く必要があります。一方、RagicをPDFサーバーにアクセスさせたい場合は、アウトバウンドポート80とポート8888を開く必要があります。

アプリアクセス設定

Private Server Config にパラメーター「DISABLE_MOBILE_APPLICATION_ACCESS」を追加します。true に設定すると、アプリでのログインがブロックされます。未設定または false に設定されている場合は、通常通りログインできます。

AI 機能

パラメーター「OPEN_AI_KEY=あなたの OpenAI キー」を追加します（こちらから申請できます）。

追加後、Ragic AI や 数式生成器が利用可能になります。

カスタム印刷レポート

カスタム印刷レポート で画像が正しく出力されない場合は、Private Server Config に「CARBONE_SEND_IMAGE_WITH_BASE64」パラメーターを追加してください。true に設定することで、画像が正常に出力されるようになります。

ライセンスファイルの更新

ライセンスファイルの更新は、自社サーバーの設定画面でライセンスファイルをアップロードし、Ragicのサービスを再起動すればOKです。また、すでにサービスの有効期限が切れている場合は、2つのライセンスファイル（license.xmlとsig）をRagicディレクトリ内のcustフォルダにコピーし、Ragicサービスを再起動します。

自社サーバーの更新

Ragicサーバーのバージョンアップは、 https://www.ragic.com/sims/download.jsp からRagicの最新パッチをダウンロードし、自社サーバー設定ページで、ページ下部のサーバーアップデートの項目を探し、パッチファイルをアップロードしてください。

アップデート後にRagicサービスの再起動が必要で、Ragicサービスを再起動するための再起動リンクが表示されます。 Linuxサーバー（QNAPとSynologyサーバーを含む、これらはLinuxベースで構成されています）では、再起動リンクを使用してRagicサービスを再起動できますが、Windowsサーバーでは、Ragicが起動したJavaプロセスを終了して手動で再起動する必要があります。

フルアップデート

場合によっては、フルアップデートを行うことをお勧めします。その場合は、 Ragicのフルバージョンをダウンロードする必要があります。

binディレクトリにある.shや.batファイルに何らかの変更を加えた場合は、再度変更を加える必要があります。そのため、古い.shや.batファイルを置き換える前に、必ずバックアップを取っておいてください。

また、アップデート前にサーバーを停止し、アップデート後にサーバーを再起動する必要があります。

システムシート更新

会社設定 や 機能権限設定に新しい機能がある場合、その機能を持つようにシステムシートを更新する必要があります。

"Ragic On-premises account setup forms patch"をダウンロード し、ファイルを解凍してください。"ragic-setup" フォルダの中にある、これらの.nuiファイルをコピーして、インストールパス下の "ragic-setup" フォルダに貼り付けてください。その後、いずれかのシステムシートにアクセスし、リロードボタンを押して更新してください。

注意： "ragic-setup" フォルダの名前を変更しないでください。そうしないと、システムが期待通りに動作しない場合があります。

毎日の自動バックアップ

以下の設定を追加することで、毎日自動バックアップを行うことができます。

DISTR_DBBACKUP_PATH=バックアップを保存するディレクトリ (ex : D:/MyBackUp/ )

DISTR_PRESERVED_NUM=保存したいバックアップ数 (ex: 5 )

自社サーバーの設定を変更する場合は、Ragicのサービスを再起動する必要があることを忘れないでください。

または、お手持ちのバックアップソフトやスクリプトを使ってバックアップを作成し、Ragicのディレクトリを別の場所にコピーするだけで、Ragicを以前の状態に戻すのに必要なファイルやデータがすべて含まれています。

Linuxサーバーの場合、cron jobを記述して rsync を実行するだけで、定期的にすべてのファイルを別のバックアップサーバーに同期させることができます。

ホストされたRagicからバックアップを復元する

バックアップ復元ツールを使って、オンラインのRagicアカウントからダウンロードしたバックアップを復元するだけでいいのです。 ただし、バックアップを復元した後では、バックアップ内のユーザーは実際には自社サーバー版に登録されていないため、各ユーザーを編集して再保存し、サーバーに追加し、パスワードを新しいデフォルトパスワードにリセットする必要がありますので、ご注意ください。

動作環境

Linux（推奨）：

• Ubuntu Linux 10.04以上(64bit)

• Red Hat Enterprise 6.x以上（64bit）

• Suse Linux Enterprise Server 10 SP2、11.x以上(64bit)

• Oracle Linux 6.x以上(64bit)

• RAM：8GB以上

• ディスク容量：200GB以上




Windows：

• Windows 7以上（64bit)

• Windows Server 2012以降（64bit）

• RAM: 8GB以上

• ディスク容量：200GB以上




Mac OS X：

• Mac OS X 10.7.3 (Lion)以降を搭載したIntelベースのMac(64bit)

• インストール用の管理者権限

• RAM：8GB以上

• ディスク容量：200GB以上

クラウドサーバーでRagicを実行

AWS EC2またはGoogle Compute Engine上でRagicを実行したい場合。以下のVM構成から始めることをお勧めします：

AWS EC2:

m7g.xlarge から始め、より多くのメモリやCPU処理能力が必要になったら m7g.2xlarge にアップグレードする。 ストレージには、データディスク用に EBS gp3 ストレージタイプを、バックアップ用に sc1 ストレージタイプを使用することを推奨する。 500GB程度のディスク容量から始めるとよいでしょう。バックアップに必要な容量は、設定されたバックアップの数によって異なります。

GCP:

e2-standard-4から始め、より多くのメモリやCPU処理能力が必要になったらe2-standard-8にアップグレードする。 ストレージについては、データディスクにはバランス永続ディスクを、バックアップには標準永続ディスクを使用することを推奨する。 ディスク容量は500GB程度から始めるのがよいでしょう。 バックアップに必要な容量は、設定されたバックアップの数によって異なります。

AWS EC2 または GCP 以外のプラットフォーム:

仮想マシン (VM)のために同じようなレベルのハードウェアを探すことができます。一般的には、4つのvCPUと16GBのRAMでスタートし、負荷が増えたら2倍にする。ディスクスペースについては、IO が重要でない限り、一般的にSSDと伝統的なディスクのハイブリッドから始めることができます。そのようなハイブリッドが利用できない場合は、データディスクにSSDディスクを使用することをお勧めします。非SSDディスクとSSDディスクのIO速度の差はかなり顕著だからです。

機能のトラブル対処

メール送信の問題

オンプレミスのサーバーを使用している場合、電子メールの送信やファイルの添付（SMTPを除く）に問題が発生した場合は、まずサーバーの購入証明書がインストールされているかどうかを確認してください。もしそうでなければ、以下の方法を参照してください：

1. 専用の証明書を購入し、インストールします。インストール方法については、こちらの記事をご参照ください。

2. I証明書を購入したくない場合は、conf/ragic.propertiesでパラメータを設定してください： IGNORE_SSL_EXCEPTION=true

.

PDF ダウンロードの問題

PDF ダウンロード機能を利用できない場合は、ネットワーク設定を確認し、必要に応じて調整してください。

1. インターネット接続があるサーバーでは、追加設定なしで利用できるはずです。

2. インターネット接続のない社内ネットワーク環境では、ファイアウォールで node1.ragic.com への接続をポート 80 または 443 で許可してください。設定後、PDF ダウンロード機能が正常に動作するはずです。

3. サーバーがインターネットに接続できず、外向きの HTTP/HTTPS 接続も一切許可できない完全隔離環境の場合は、こちらの記事を参照し、PDF ダウンロード機能を有効にする手順をご確認ください。

インストール時のトラブル対処

Ragic のインストール中に問題が発生し、正常にインストールできない場合は、設定が正しいかどうかを確認するため、以下の項目をご確認ください。

1. サーバーに Java JDK 8 はインストールされていますか？ JRE ではなく JDK であること、また JDK 8 であることをご確認ください。これより前後のバージョンでは問題が発生する可能性があります。
2. license.xml と sig ファイルを cust ディレクトリに配置していますか？ これらのライセンスファイルがないと、システムは正しく動作しません。
3. Linux 環境で ragic_dbv7.sh ファイルに実行権限を付与していますか？
4. Linux で Ragic を起動する際、実行ユーザーに root 権限がありますか？ root 権限がない場合、ポート 443 にバインドできません。
5. HTTP（80）／HTTPS（443）用ポートへのネットワークアクセスを許可していますか？ Linux と Windows は、通常デフォルトでファイアウォールが有効になっています。
6. JVM のヒープメモリ設定が、実際のマシンのメモリ容量内に収まっていますか？ 前述の JAVA_OPTS パラメーター設定において、サーバーに十分なメモリがあることをご確認ください。メモリが不足している場合、起動できません。
7. JVM のヒープメモリ割り当ては十分ですか？ 先ほどの JAVA_OPTS 設定で触れたとおり、割り当てが 5 GB 未満の場合、やや大きめのデータベースでは正常に動作しない可能性があります。
8. java または java.exe が重複して起動していないか確認しましたか？ Linux では `ps aux | grep java`、Windows ではタスクマネージャーで、java／java.exe のプロセスが 1 つだけ稼働しているか確認してください。重複して起動していると、重大なデータベース問題を引き起こす可能性があります。
9. エンドポイント監視ソフトウェアや WAF 製品を使用していますか？ 使用している場合は、Ragic の実行が許可されていることを確認してください。動作に影響する可能性があります。
10. ragic.properties ファイルの SERVER_NAME パラメーターを正しく設定していますか？ 未設定の場合、Ragic が生成するリンクへの接続で問題が発生します。
11. 日次の自動バックアップは、Ragic を配置しているディスクとは別のディスクに正しく設定されていますか？ 設定項目には DISTR_DBBACKUP_PATH と DISTR_PRESERVED_NUM があります。インストール後はバックアップ設定が重要です。ハードディスク障害時にすべてを失うのを防ぐため、バックアップ先は Ragic の稼働ディスクとは別のディスクに設定してください。
12. サーバーに PDF 機能を導入したいのですが、利用すべきサービス／バージョンは何ですか？ PDF 機能には「Node Service（バージョン：v14.19.3）」と「Puppeteer Service（バージョン：14.4.1）」が必要です。