<< Javascript工作引擎目錄

私有主機版說明

若公司有特殊的資安考量,並且具備良好的主機維護能力,以及資訊安全知識,也可以選擇將 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 的資料夾,另一個環境變數 RAGIC_HOME 也需要設定並指向您安裝 Ragic 的資料夾。如果您不想要變更您的環境變數,您可以直接修改 ragic_dbv7.sh (Linux) 或 ragic_dbv7.bat (Windows) 並增加如同下面格式的兩行文字,並記得將等號後方修改為相對應的路徑:

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

    RAGIC_HOME= /home/ragic

    您也可以修改 JAVA_OPTS="-Xms1g -Xmx1g 的部分,調整Ragic能使用多少記憶體。1g 就代表可以使用 1GB 的記憶體。改成 JAVA_OPTS="-Xms10g -Xmx10g 就代表可以使用 10GB 的記憶體。建議伺服器整體有多少記憶體,配置最多七成給 Ragic 的服務,以免影響作業系統運作。

  7. 執行下列指令 ./bin/ragic_dbv7.sh manual (Linux) 或 ./bin/ragic_dbv7.bat start (Windows) 來啟動您伺服器上的 Ragic。在 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 私有主機版的預設首頁,之後您便可以在該伺服器上開始建立所有需要的應用。

    成功完成設定會看到的畫面:

  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 或是網址。記得所有私有主機設定調整的時候,都需要重新啟動伺服器。

Ragic 的預設郵件伺服器是一台我們提供的郵件伺服器,如果 Ragic 伺服器要用公司自己的郵件伺服器寄信的時候,需要針對以下私有主機設定填寫郵件伺服器的資訊。記得更改私有主機設定後重啟才會生效:

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。

每日自動備份

您可以在私有主機設定中加入以下屬性來使用每日自動備份的功能

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伺服器,而在更新完畢後,您也會需要重啟伺服器。

硬體規格要求

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

回最上面
<< Javascript工作引擎目錄
瞭解更多:
我們為什麼要開發Ragic?
免費課程
使用說明
Ragic定價
Ragic應用
最新訊息:
部落格
Facebook
YouTube
立即科技 Ragic, Inc.
02-7728-8692
台北市中正區南昌路二段81號9樓
info@ragic.com