设计手册
遇到问题了吗?不用担心,答案都在这。
全站搜索

私有主机版说明

若公司有特殊的资安考量,并且具备良好的主机维护能力,以及信息安全知识,也可以选择将 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

完整更新

在一些状况下,我们会建议您进行一次完整更新。如此一来,您会需要下载完整版本的 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

回最上面 目录
瞭解更多:
我们为什么要开发Ragic?
免费课程
使用说明
Ragic定价
Ragic应用
最新信息:
博客
Facebook
YouTube
北京立即科技有限公司
info@ragic.com
京ICP备2022003680号