版本更新

Windows

一般版本更新步驟

1. 備份OMFLOW

請先備份OMFLOW，備份方式請詳見【備份與還原】章節

1. 執行更新檔

OMFLOW 的 Windows 更新檔可以直接執行，在更新檔按下右鍵後選擇「以系統管理員身份執行」。

1. 選擇語系

選擇顯示的語言後按下「確定」。

1. 同意使用條款

勾選使用條款須知的「我同意」後按下「下一步」。

1. 開始更新

執行檔會檢查你的設備是否可以使用當前的更新，檢查完畢後按下「更新」

如果出現版本不符情況，請先檢查OMFLOW版本，與更新檔版本是否可以使用。 OMFLOW 在 1.1.4 之後的版本，可以直接使用最新的更新檔升級到最新版本。 如果設備上的 OMFLOW 版本小於 1.1.4，請依照 OMFLOW 版本順序，依序更新到 1.1.4.0 後再使用最新的更新檔。

1. 服務重啟

更新完畢後會自動重啟OMFLOW服務，服務重啟完畢後按下「結束」即完成更新。

1.1.4.0 以前的版本更新後，請確認OMFLOW服務已重新啟動後，再繼續更新。

現在你可以繼續使用OMFLOW了！

1.2.0、1.2.2 注意事項 - 2024/9/3 Update

OMFLOW在1.2.0、1.2.2版本分別將Python版本進行升級，若用戶在過去版本額外安裝python套件，更新過程會要求用戶手動更新套件，以下為相關步驟：

1. Python路徑為 C:\PROGRA\~1\OMFLOW Server\Python311 或 C:\PROGRA\~1\OMFLOW Server\Python311x64

2. 以管理者權限開啟CMD視窗並進入 指令進行安裝

3. 以指令 python.exe -m pip install <套件名稱> --target "Lib\site-packages"

4. 安裝後點擊下一步進行檢查，以此循環直到無缺失套件

5. 關閉所有Python相關CMD視窗

Linux

一般更新步驟

1. 備份OMFLOW

請先備份OMFLOW，備份方式請詳見【備份與還原】章節

1. 解壓縮更新檔

解壓縮 patch 檔

tar -zxvf [patch檔路徑]

1. 執行更新檔

移動至 patch.sh 的路徑上，執行 patch.sh

cd [patch檔路徑]
sudo ./patch.sh

1. 重啟服務

確認 OMFLOW 服務是否正常啟動

/opt/omflow/server/omflow_server status

若服務尚未被啟動，請將服務開啟

/opt/omflow/server/omflow_server start

現在你可以繼續使用OMFLOW了！

Linux 更新 1.2.0.0 版本步驟

OMFLOW在1.2.0.0版本對環境需求進一步提升，使用Linux環境之用戶需手動更新，以下為相關步驟：

python version: 3.8 → 3.11 django version: 2.2 → 4.2.6

1. 停止OMFLOW

   omflow_server stop

2. 刪除/opt/omflow資料夾底下的python資料夾

   rm -rf /opt/omflow/python/

3. 安裝ubuntu套件

套件清單

• python 3.11

• python3.11-dev

• python3.11-venv

• python3-pip

安裝方式一：線上安裝版(需連線網際網路)

	# 更新套件庫
	apt-get update -y
	# 增加套件庫
	add-apt-repository ppa:deadsnakes/ppa -y
	# 更新套件庫
	apt-get update -y
	# 安裝python3.11及相關套件
	apt-get install -y python3.11 python3.11-dev python3.11-venv python3-pip

• 安裝方式二：無網路環境、離線安裝方式請見補充

  • 下載Ubuntu套件離線安裝包

  • 離線安裝Ubuntu套件

1. 設定python 3.11為環境變數(使得python3.11可用指令python3呼叫)

   update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1

2. 建立python 3.11的虛擬環境在/opt/omflow資料夾底下

   python3 -m venv /opt/omflow/python

3. 進入虛擬環境並安裝python套件

python套件清單

• wheel

• django==4.2

• ldap3

• mod_wsgi

• openpyxl

• DB會用到的python套件

• 其他會用到的套件…

• 線上安裝版(需連線網際網路)

    # 進入虛擬環境
    source /opt/omflow/python/bin/activate
    # 安裝 wheel
    pip install wheel
    # 非必要可略
    python /usr/lib/python3.11/test/libregrtest/setup.py bdist_wheel
    # 安裝必要套件，其他套件請自行評估安裝
    pip install django==4.2 ldap3 mod_wsgi openpyxl

• 無網路環境、離線安裝方式請見補充

  • 下載python套件離線安裝包(.whl)

  • 離線安裝python套件

1. 修改apache http.conf裡的wsgi_module路徑改成新的路徑

   # 修改django.conf
   vim /etc/apache2/sites-available/django.conf
   
   # 修改wsgi_module的路徑

2. 更新OMFLOW 1.2.0.0

   # 進入tmp
   cd /tmp/
   
   # 解壓縮patch檔
   tar zxvf /tmp/omflow_patch_1_2_0_0.tar.gz

   # 進入patch資料夾
   cd omflow_patch_1_2_0_0/
   
   # 執行patch
   ./patch.sh

3. 啟動OMFLOW(通常無須手動啟動)

補充:

1. 下載Ubuntu套件離線安裝包

   • 找一台環境與OMFLOW server相同的Ubuntu，需有網際網路連線。

套件清單

• python 3.11

• python3.11-dev

• python3.11-venv

• python3-pip

• 下載指令:

    # 切換root身分
    sudo su

    # 新增套件庫**deadsnakes** PPA
    add-apt-repository ppa:deadsnakes/ppa

    # 更新套件列表: 
    apt-get update

    # (如果需要的話)清理預設的下載資料夾
    apt-get clean

    # 下載但不安裝套件
    apt-get install --download-only python3.11 python3.11-dev python3.11-venv python3-pip

• 下載的安裝包將被保存在 /var/cache/apt/archives/ 目錄下，自行使用FTP軟體取出並放至OMFLOW server環境。

1. 離線安裝Ubuntu套件

套件清單

• python 3.11

• python3.11-dev

• python3.11-venv

• python3-pip

• 將 .deb 文件複製到Ubuntu的某個目錄，此用 **/tmp/Downloads**舉例

• Ubuntu指令:

        # 切換root身分
        sudo su
        
        # 移動到安裝包所在的路徑底下
        cd /tmp/Downloads
        
        # 使用 dpkg 安裝下載的套件包
        dpkg -i *.deb

1. 從現有環境匯出已安裝的python套件清單

   • 如果您已經有原OMFLOW使用的套件清單可略過本步驟。

   • 參考資料: https://pip.pypa.io/en/stable/cli/pip_freeze/

   • 匯出指令:

     # 切換到OMFLOW的虛擬環境
     source /opt/omflow/python/bin/activate
     
     # 匯出python套件清單至/tmp底下
     pip freeze > /tmp/requirements.txt
     
     # 將django的版本改為4.2以上版本
     vim /tmp/requirements.txt

   • 自行使用FTP軟體取出並放至有網路的Ubuntu環境，作為後續下載套件的參考。

2. 下載python套件離線安裝包(.whl)

   • 請準備一台已經安裝好python3.11的環境，方便下載python3.11適用的套件版本，此環境必須能連到網路。

   • 下載指令:

     # 新增一個存放離線安裝包的資料夾
     mkdir /tmp/python_package
     cd /tmp/python_package
     
     # [方法一]使用requirements.txt批次下載
     # 假設您已經將前一步的requirements.txt放在/tmp/底下
     pip -m install /tmp/requirements.txt
     
     # [方法二]手動輸入套件名稱下載
     pip -m install <套件名稱>
     
     # 下載完成後檢視資料夾內有多少.whl安裝檔
     ll

   • 自行使用FTP軟體取出並放回OMFLOW server。

   • 補充: mod_wsgi會得到tar.gz，安裝方式較為特別，請見離線安裝mod_wsgi。

3. 離線安裝python套件

   • 假設python套件的離線安裝包(.whl)放在此路徑**/opt/omflow/tmp**底下

   • 安裝指令:

     # 切換到OMFLOW的虛擬環境
     source /opt/omflow/python/bin/activate
     
     # 切換到離線安裝包的檔案路徑底下
     cd /opt/omflow/tmp
     
     # 安裝所有whl
     pip install *.whl

4. 離線安裝mod_wsgi

   • 安裝指令:

     # 切換到OMFLOW的虛擬環境
     source /opt/omflow/python/bin/activate
     
     # 解壓縮mod_wsgi的tar.gz
     tar zxvf <mod_wsgi的檔案路徑>
     
     cd <mod_wsgi解壓縮後的路徑>
     
     # 簡易安裝mod_wsgi
     python setup.py install

注意:

更換完python & django後，要更新OMFLOW版本至1.2.0.0才能成功啟動；之前的版本無法搭配django 4.2使用 。

錯誤處理

如果更新完 OMFLOW 後無法啟動服務，請依照【備份與還原】章節將 OMFLOW 進行還原，再重新執行更新步驟。