私有主机版说明 (含 QNAP / Synology)

若公司有特殊的资安考量，并且具备良好的主机维护能力，以及信息安全知识，也可以选择将 Ragic 安装在公司内部的服务器上使用，而非选择云版本。强烈建议公司内部有专业的信息人员，具备网络服务器维护经验，才选择私有主机方案，以策信息安全！

私有主机方案的最低人数限制为 10 名用户并且以年付为单元，专业版及企业版都可以选择安装在私有主机，价格信息请参阅定价页面面。

安装步骤

1. 请确保要存放 Ragic 系统的服务器中安装有 Java SE Development Kit 8 的 JDK。您可以至此链接或此链接中找到需要的 JDK。
2. 拷贝您的 Ragic 系统 Zip 檔到您的服务器中，您可以使用您登记过的帐号密码登录 www.ragic.com 并至此链接下载最新的 Ragic 私有主机版软件。
3. 解压该 Zip 檔至您希望安装 Ragic 的文件夹中。
4. 您会需要两个授权文件 license.xml 和 sig。这两个文件在您订购私有主机版后会被寄送至您的邮箱中。将这两个文件拷贝到您 Ragic 文件夹中的 cust 子文件夹内，这也是未来您需要更新授权文件的地方。

   

5. 如果您是使用 Linux 操作系统，须使用 chmod 来确保您有权限运行 bin/ragic.sh 和 bin/setclasspath.sh 这两个文件。
6. 新增并设置环境变量：

   JAVA_HOME：指向您安装 JDK 8的路径

   RAGIC_HOME：指向安装 Ragic 的路径

   Windows环境中可以在我的计算机单击右键，选择内容，找到进阶系统设置后点击环境变量。

   如果您不想要变更您的环境变量，您可以直接修改 ragic_dbv7.sh (Linux) 或 ragic_dbv7.bat (Windows) 并增加如同下面格式的两行字，并记得将等号后方修改为相对应的路径：

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

   RAGIC_HOME= /home/ragic

   您也可以修改 JAVA_OPTS="-Xms5g -Xmx5g 的部分，调整Ragic能使用多少内存。5g 就代表可以使用 5 GB 的内存。改成 JAVA_OPTS="-Xms10g -Xmx10g 就代表可以使用 10GB 的内存。建议服务器整体有多少内存，分配最多七成给 Ragic 的服务，以免影响操作系统运作。

7. 接着便可以开始运行启动 Ragic 的动作：

   在 Windows 环境，找到您 Ragic 文件夹下的 bin 文件夹，手动运行：./ragic_dbv7.bat start

   在 Linux 环境，手动运行下列指令：./ragic_dbv7.sh manual

   在 Linux 系统上您可以增加 nohup 这个指令，如此一来可以让程序在您的用户离开系统后不会被终止，或者将它增加至系统服务中。记得在 Linux 上要用 root 权限或是用 sudo 运行，才能使用 port 80。

   一般在重新启动的时候，建议先检查目前系统是否已经在运行 Ragic。最简单的检查方式就是直接用浏览器联机看看目前是否连得到服务，确认连不到任何服务才是有把目前运行的 Ragic 程序砍光，如果有重复同时运行会造成系统发生错误。如果是在 Linux 上可以使用 ps aux | grep java 来检查有没有 java 的程序在运行。在 Windows 上则是观察是否有名称叫 java 程序在运行中，有的话都是需要先砍掉。

8. 使用您的浏览器并联机至您 Ragic 服务器的 localhost (127.0.0.1)，或远端主机的 IP 或主机名称，接着您就可以看到下列的画面：

   

   您现在所创建的这位用户会获得此 Ragic 服务器管理员的权限。当设置完成后，您会被导向 Ragic 私有主机版的默认主页，之后您便可以在该服务器上开始创建所有需要的应用。

   成功完成设置会看到的画面：

   

   （备注：若您无法成功运行您的Ragic服务器，请确认您的防毒软件未阻塞Ragic服务器运行。在某些特殊情形下，Ragic服务器会遇到被防毒软件挡住，而无法运行的状况。）

9. (非必要) 如果你的私有主机是在内网，无法联机到因特网的话，你会需要安装一个 PDF 文件生成的服务在该台服务器上，以支持把数据印成 PDF 的功能。首先要安装 Node Js，你可以在此链接取得安装檔(目前是建议选用 10.15.1 这个 LTS 版本)。

   Windows系统安装步骤 :

   (1) 直接点两下安装。

   (2) 打开命令提示字符，输入node -v，假如出现10.15.1代表安装成功。

   Ubuntu系统安装步骤:

   (1) sudo apt-get install build-essential checkinstall

   (2) sudo apt-get install libssl-dev

   (3) curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash

   (4) 设置环境变量

   export NVM_DIR="$THE_DIR_WHERE_YOU_INSTALL_NVM/.nvm"

   [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

   (5) 确认是否设置成功

   nvm --help

   (6) 安装NodeJs nvm install 10.15.1

   (7) 确认是否安装成功以及 version 是否为 10.15.1 node -v，版本不对的话输入 nvm use 10,15.1，假如有其他错误信息的就请依照信息排除即可。

   　

   (8) 确认看看npm是否也顺便安装好了 npm -v

   　

   再来是安装 Puppeteer 这个 NodeJs 套件，无关系统步骤都是相同的：

   (1) 先到 $YOUR_RAGIC_ROOT\web\sims\js\pdfMaker 输入 npm i Puppeteer@1.12.1

   (2) 接着回到 $YOUR_RAGIC_ROOT，输入 node web\sims\js\pdfMaker\nodeJs $YOUR_PORT 打开 pdf 下载功能，YOUR_PORT 需跟之前设置在 Config 内的 PHANTOMJS_SERVER_PORT 一致。

Linux 启动及终止 Ragic 服务指令

启动： sudo nohup ./bin/ragic.sh manual

停止：sudo pkill -f RagicJetty9Server

请注意停止服务时，不建议使用强迫终止，除非万不得已。

私有主机设置

主机网址及邮件服务器设置

设置好服务器后，请记得到私有主机设置的地方，修改 SERVER_NAME 参数，确定他写上了该台服务器的 ip 或是网址；接着再填写邮件服务器的设置，以避免通知信件功能无法正常运作，记得更改私有主机设置后重启才会生效。

以下为私有主机设置填写邮件服务器的信息：

SMTP_SERVER=请填入您的 SMTP 邮件服务器网址

SMTP_SENDER_AUTH_USER=登录 SMTP 服务器的用户名称

SMTP_SENDER_AUTH_PWD=登录 SMTP 服务器的用户密码

SMTP_SSL_ENABLE=使用加密 smtps 联机填写 true；无加密 smtp 填写 false

SMTP_PORT=无加密 smtp 的端口

SMTP_SSL_PORT=加密 smtps 联机的端口

SMTP_SENDER_PERSONAL=系统寄信时使用的名称

SMTP_SENDER_EMAIL=系统寄信时的回信邮箱

防火墙设置

防火墙分服务器对外联机 outbound 跟对内联机 inbound，要能够访问 Ragic 服务需要开 80 / 443 inbound，Ragic要能够访问 PDF 服务器的话会变成要开 80 outbound 及 Port 8888。

每日自动备份

您可以在私有主机设置中加入以下属性来使用每日自动备份的功能

DISTR_DBBACKUP_PATH=请填入放备份檔的目录 (例如 : D:/DBBackUp/ )

DISTR_PRESERVED_NUM=留存几天份的备份檔 (例如 : 7)

记得更改私有主机设置后重启才会生效。

还原备份

您可以用数据库还原的功能，将您从在线版下载的 Ragic 备份檔还原到您的私有主机版上。不过注意到因为数据库里面的用户都没有在您的私有主机登记过，所以要进到用户管理的表单，将他们一一重新保存，才会登记到系统中，另外再将他们的密码一一复位成一个新的默认密码，才能让用户使用这个默认密码登录。

更新授权

在帐号管理 => 私有主机管理的地方可以上载更新您的授权檔。

如果授权已经过期，没办法从私有主机管理处更新的时候，可以直接把授权码拷贝到 Ragic 安装目录的 cust 文件夹中，重启启动服务即可。

系统更新

在更新之前，请确保您已经将 Ragic 文件夹内的所有数据进行备份！

您会需要登录我们云的 Ragic 站点(若云版没有帐号，要先从官网登记一个)，链接下面网址，以取得下列所述的所有更新补丁或者完整版本软件，下载完成后透过系统设置里的私有主机设置进行系统更新。

下载最新更新文件网址是：https://www.ragic.com/sims/download.jsp

备注：“私有主机”泛指任何私有主机服务，除了自建的服务器以外，NAS 之类的产品也在范围内，例如：QNAP 或 Synology，皆适用于此方式来更新 Ragic 服务。主要原因在于 NAS 之类的产品，其更新方式对于 Ragic 来说能控制的比较少，并且版本更新一定会比官方慢，因此建议至官方站点下载最新的更新檔 ，并利用此方式作更新，替换使用 Application Center 的更新方式。

完整更新

在一些状况下，我们会建议您进行一次完整更新。如此一来，您会需要下载完整版本的 Ragic。如果您有对安装 Ragic 的文件夹路径进行调整，您也会需要再次修改在 bin 文件夹中的 .sh 或 .bat 檔。请确保您在进行这些修改前有针对旧的 .sh 与 .bat 檔进行备份。在进行任何更新前，您都会需要先停止Ragic服务器，而在更新完毕后，您也会需要重启服务器。

系统表单更新

当有针对公司设置、功能权限设置的新功能发布时，会需要更新系统表单才能取得该功能。

您可以至上面提供的网址中，选择 ”Ragic On-premises account setup forms patch” 下载并运行解压。解压后，请将 "ragic-setup" 文件夹中总计 19 个扩展名为 .nui 的文件拷贝至您原本安装路径中的 "ragic-setup" 文件夹下，覆盖原本的 .nui 文件。完成后不需重启服务器，回到系统表单内刷新即可生效。

备注：请勿重新命名安装路径中的 "ragic-setup" 文件夹，以避免系统无法顺利运行。

硬件规格说明要求

Linux (Recommended)：

• Ubuntu Linux 10.04 and above (64-bit)

• Red Hat Enterprise 6.x and above (64-bit)

• Suse Linux Enterprise Server 10 SP2, 11.x and above (64-bit)

• Oracle Linux 6.x and above (64-bit)

• RAM: over 8GB

• Disk space: over 200GB

Windows：

• Windows 7 or later (64-bit)

• Windows Server 2012 or later (64-bit)

• RAM: over 8GB

• Disk space: over 200GB

Mac OS X：

• Intel-based Mac running Mac OS X 10.7.3 (Lion) or later. (64-bit)

• Administrator privileges for installation

• RAM: over 8GB

• Disk space: over 200GB

云虚拟主机规格说明建议

如果想在 AWS EC2 或 Google Compute Engine 上建置 Ragic，可以参阅以下虚拟主机分配：

AWS EC2：

可以先使用 m7g.xlarge，需要更多内存或 CPU 效能时，则升级到 m7g.2xlarge。针对保存空间，建议选择 EBS gp3 的磁盘类型作为硬盘，并使用 sc1 的磁盘类型作为备份。可以从约 500GB 的保存空间开始，而备份空间的需求将取决于分配的备份数量。

GCP：

可以先使用 e2-standard-4，需要更多内存或 CPU 效能时，则升级到 e2-standard-8。针对保存空间，建议选择 balanced persistent disk 作为硬盘，并使用 standard persistent disk 作为备份。可以从约 500GB 的保存空间开始，而备份空间的需求将取决于分配的备份数量。

AWS EC2 或 GCP 之外的平台：

可以查找相似等级的硬件。一般来说，可以从 4 个虚拟 CPU 和 16GB RAM 开始，当负载增加时可以将两者加倍。针对磁盘空间，除非 IO 特别重要，否则通常可以从 SSD 和传统磁盘的混合选项开始。如果没有此类混合选项，建议使用 SSD 磁盘作为数据磁盘，因为非 SSD 磁盘和SSD 磁盘之间的 IO 速度差异非常明显。