安裝在 Linux

開始安裝 OMFLOW Server

OMFLOW Server 安裝前環境準備,

本文件以Ubuntu 20.04 和 CentOS 8,

Python 版本為3.8.x為範例,

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

第一步驟,必須準備 Python3 的環境及 OMFLOW 套件

Ubuntu 必要套件安裝範例

apt-get update -y
apt-get install -y python3.8-dev apache2-dev python3-venv python3.8-venv

CentOS Python 及必要套件安裝範例

dnf -y install python38 gcc httpd-devel python38-devel redhat-rpm-config

第二步驟,安裝網頁伺服器 Apache Server

Ubuntu 安裝 Apache 範例

apt-get install apache2

CentOS 安裝 Apache 範例

dnf install httpd

第三步驟,建立 OMFLOW 的 Python 執行環境

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

第四步驟,安裝 Python 必要套件

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

source /opt/omflow/python/bin/activate
pip install wheel
python /usr/lib/python3.8/test/libregrtest/setup.py bdist_wheel
pip install django==2.2 ldap3 mod_wsgi

若 Python 版本不是 3.8,請將指令中的 3.8 修改為使用版本。

第五步驟,解壓縮 omflow 資料夾

解壓縮 /tmp/omflow.tar.gz

cd /opt/omflow 
tar zxvf /tmp/omflow.tar.gz

重新命名資料夾 為 server

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

第六步驟,資料庫準備

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

Django database config

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

UBUNTU

CentOS

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

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

必要套件對照表:

更改 /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,
        }
    }
}

第七步驟,執行 omflow_config.sh 檔案

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

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

若 Python 版本不是 3.8,請在 /etc/apache2/sites-available/django.conf 中,將 3.8 修改為使用的版本

第八步驟,類型選擇為 server

omflow type : server

執行範例

django.conf 設定檔

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

Ubuntu 檢視

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

CentOS 檢視

vi /etc/httpd/conf.d/django.conf

Ubuntu 啟用 django.conf 設定檔

sudo a2ensite django.conf

Ubuntu 停用 apache 預設檔

sudo a2dissite 000-default.conf

第九步驟,omflow_server 服務

啟動 omflow_server 服務

/opt/omflow/server/omflow_server start

停用 omflow_server 服務

/opt/omflow/server/omflow_server stop

確認 omflow_server 服務狀態

/opt/omflow/server/omflow_server status

第十步驟,開始使用 OMFLOW

開始安裝OMFLOW Collector

第一步驟,必須準備 Python3 的環境

Ubuntu 安裝範例

apt-get install python3

CentOS 安裝範例

yum install python3

第二步驟,建立 OMFLOW 的 Python 執行環境

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

如果無法建立虛擬環境,請安裝套件apt-get install python3-venv

第三步驟,安裝 OMFLOW 必要套件

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

source /opt/omflow/python/bin/activate
pip install django==2.2

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

第四步驟,解壓縮 omflow 資料夾

解壓縮 /tmp/omflow.tar.gz

cd /opt/omflow 
tar zxvf /tmp/omflow.tar.gz

重新命名資料夾 為 collector

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

第五步驟,執行 omflow_config.sh 檔案

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

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

第六步驟,類型選擇為 collector

omflow type : collector

第七步驟,輸入必填資訊

此步驟將會更改 /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

第八步驟,omflow_collecter 服務

啟動omflow_collector 服務

/opt/omflow/collector/omflow_collector start

停止omflow_collector 服務

/opt/omflow/collector/omflow_collector stop

確認 omflow_collector 服務狀態

/opt/omflow/collector/omflow_collector status

開始安裝 OMFLOW Patch

第一步驟,解壓縮 Patch檔

tar xvf omflow_patch_1_x_x_x.tar.gz

第二步驟,執行 patch.sh

cd omflow_patch_1_x_x_x/
./patch.sh

最后更新于