中文

安裝在 Linux

安裝 OMFLOW Server (安裝 1.2.0.0 以後的版本)

OMFLOW Server 安裝前環境準備，

本文件以 Ubuntu 24.04，

Python 版本為 3.11.x 為範例，

其他作業系統請參考下列準備步驟完成準備。

1. 準備 Python3 的環境及 OMFLOW 套件

Ubuntu 必要套件安裝範例

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

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

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

3. 安裝網頁伺服器 Apache Server

sudo apt-get install -y apache2

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

sudo mkdir /opt/omflow
sudo python3 -m venv /opt/omflow/python

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

python 套件清單

  • wheel

  • django==4.2

  • ldap3

  • mod_wsgi

  • openpyxl

  • requests

  • python-docx

  • DB 會用到的 python 套件

  • 其他會用到的套件…

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

    # 切換root身分
    sudo su
    # 進入虛擬環境
    source /opt/omflow/python/bin/activate
    # 安裝 wheel
    pip install wheel
    # 安裝必要套件，其他套件請自行評估安裝
    pip install django==4.2 ldap3 mod_wsgi openpyxl requests python-docx

6. 解壓縮 omflow 資料夾

解壓縮 OMFLOW 安裝檔

cd /opt/omflow
sudo tar zxvf [OMFLOW安裝檔路徑]

7. 重新命名資料夾 為 server

sudo mv /opt/omflow/omflow /opt/omflow/server

8. 資料庫準備

資料庫目前預設為 SQLite 如要選擇其它資料庫，請參考網址

Django database config

Linux 安裝資料庫套件對照表:

UBUNTU

MySQL

apt update -y && apt upgrade -y apt -y install software-properties-common add-apt-repository 'deb http://archive.ubuntu.com/ubuntu bionic main' apt update -y apt install -y python-mysqldb apt install -y libmysqlclient-dev

CentOS

SQLite

dnf install -y sqlite

如果您要選擇其他的資料庫 ，請預先建立好資料庫以給予相對應的權限。 以下資料庫需要安裝額外的套件(使用 pip 安裝)

要安裝資料庫套件前請先進入虛擬環境 source /opt/omflow/python/bin/activate

必要套件對照表:

PostgreSQLOracleSQL ServerMySQL

psycopg2-binary

cx_Oracle

django-mssql

pymysql

django-pytds

mysqlclient

django-sqlserver

django-pyodbc

更改 /opt/omflow/server/omflow/settings.py 檔案以下是 settings.py 修改範例

SQLite

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": os.path.join(BASE_DIR, "db.omflow"),
        "OPTIONS": {
            "timeout": 300,
        }
    }
}

PostgreSQL

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql",
        "NAME": "<資料庫名稱>",
        "USER": "<使用者名稱>",
        "PASSWORD": "<密碼>",
        "HOST": "<資料庫IP>",
        "PORT": "<資料庫PORT>",
        "OPTSIONS": {
            "connect_timeout": 300
        }
    }
}

MySQL

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.mysql",
        "NAME": "<資料庫名稱>",
        "USER": "<使用者名稱>",
        "PASSWORD": "<密碼>",
        "HOST": "<資料庫IP>",
        "PORT": "<資料庫PORT>",
        "OPTSIONS": {
            "connect_timeout": 300
        }
    }
}

Oracle

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.oracle",
        "NAME": "<資料庫名稱>",
        "USER": "<使用者名稱>",
        "PASSWORD": "<密碼>",
        "HOST": "<資料庫IP>",
        "PORT": "<資料庫PORT>"
    }
}

SQL Server

DATABASES = {
    "default": {
        "ENGINE": "sql_server.pyodbc",
        "NAME": "<資料庫名稱>",
        "USER": "<使用者名稱>",
        "PASSWORD": "<密碼>",
        "HOST": "<資料庫IP>",
        "PORT": "<資料庫PORT>",
        "OPTIONS": {
            "driver": "",
            "MARS_Connection": True,
        }
    }
}

9. 執行 omflow_config.sh 檔案

進入到 /opt/omflow/server 資料夾

cd /opt/omflow/server
sudo ./omflow_config.sh

19. 類型選擇為 server

omflow type : server

執行範例

django.conf 設定檔

執行檔已經幫您把 django.conf (apache 設定檔) 複製到 apache 資料夾 可以用指令檢視

檢視

sudo vi /etc/apache2/sites-available/django.conf

啟用 django.conf 設定檔

sudo a2ensite django.conf

停用 apache 預設檔

sudo a2dissite 000-default.conf

11. omflow_server 服務

啟動 omflow_server 服務

sudo /opt/omflow/server/omflow_server start

停用 omflow_server 服務

sudo /opt/omflow/server/omflow_server stop

確認 omflow_server 服務狀態

sudo /opt/omflow/server/omflow_server status

12. 開始使用 OMFLOW

安裝 OMFLOW Collector (安裝 1.2.0.0 以後的版本)

OMFLOW Collector 安裝前環境準備，

本文件以 Ubuntu 24.04，

Python 版本為 3.11.x 為範例，

其他作業系統請參考下列準備步驟完成準備。

1. 準備 Python3 的環境及 OMFLOW 套件

Ubuntu 必要套件安裝範例

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

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

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

3. 建立 OMFLOW 的 Python 執行環境

sudo mkdir /opt/omflow
sudo python3 -m venv /opt/omflow/python

4. 安裝 OMFLOW 必要套件

進入虛擬環境並安裝必需套件

# 切換root身分
sudo su
# 進入虛擬環境
source /opt/omflow/python/bin/activate
# 安裝必要套件
pip install django==4.2 openpyxl requests python-docx

其他非必要套件視 Collector 實際用途有所不同，可至【資料收集>收集器套件】章節觀看說明。

5. 解壓縮 omflow 資料夾

解壓縮 OMFLOW 安裝檔

cd /opt/omflow
sudo tar zxvf [OMFLOW安裝檔路徑]

6. 重新命名資料夾 為 collector

sudo mv /opt/omflow/omflow /opt/omflow/collector

7. 執行 omflow_config.sh 檔案

進入到 /opt/omflow/collector 資料夾

cd /opt/omflow/collector
sudo ./omflow_config.sh

8. 類型選擇為 collector

omflow type : collector

9. 輸入必填資訊

此步驟將會更改 /opt/omflow/collector/omflow/settings.py

  • Collector IP : 本機 IP

  • Collector port : 5168

  • Server IP : OMFLOWserver IP

  • Server port : OMFLOWserver port

  • Server protocol : OMFLOW server protocol

9. omflow_collecter 服務

啟動 omflow_collector 服務

sudo /opt/omflow/collector/omflow_collector start

停止 omflow_collector 服務

sudo /opt/omflow/collector/omflow_collector stop

確認 omflow_collector 服務狀態

sudo /opt/omflow/collector/omflow_collector status

開始安裝 OMFLOW Patch

第一步驟，解壓縮 Patch 檔

sudo tar xvf [Patch檔路徑]

第二步驟，執行 patch.sh

cd [解壓縮後產生的資料夾路徑]
sudo ./patch.sh
Previous安裝在WindowsNextLicense安裝

Last updated