Skip to main content

BriefCam安裝指南

複製BriefCamPostgreSQL數據庫

最後更新日期: 閱讀時間 10 分鐘
版本2024r2
語言中文(繁體)

本節詳細介紹了如何簡化PostgreSQL數據庫的複製。

必要條件、備註和慣例

注意

從本文檔的示例中粘貼命令時,請使用Windows PowerShell,而不是命令提示符(cmd)。

  1. 如果主服務器空間足夠,請在嘗試創建複製副本之前執行數據庫的完全備份(使用pg_dump工具)。

  2. 記下主服務器的IP地址。在本文檔的稍後部分,它將稱為<主要IP>。

  3. 記下輔助服務器的IP地址。在本文檔的稍後部分,它將稱為<次要IP>。

  4. 在PGSQL服務器中,以下三個安BriefCam裝組件都需要設置為主機名或IP地址。確保它們都使用相同的方法(以確保一致性)。 可以通過在下面的文件或設置中查找PostgreSQLconnectionString來完成此操作:

    • VS伺服器: C:\Program Files\BriefCam\BriefCam Server\VSServer.exe.config

    • Web服務: C:\Program Files\BriefCam\WebServices\ProWebApi\Web.config

    • Qlik(RESEARCH):ODBC 64位條目(服務器字段)

      ODBC Driver Setup.png
  5. 建議在建立次要伺服器之前,測試系統的完整功能。務必記下您更改的參數的所有原始值。

  6. 在部署BriefCam服務器組件的所有服務器上,將hosts文件設置為指向主PostgreSQL數據庫服務器–這將覆蓋DNS。

  7. 在中BriefCam Administrator Console,打開“環境設置”部分,並將DB.LocalStorageAddress和VideoProductsPath設置設置為使用主機名而不是IP地址。

  8. PostgreSQL基本備份的速度因環境設置(SSD / HDD / NIC速度)而異。 根據經驗,在虛擬環境中的ISCSI存儲(10 Gbps鏈路HDD陣列)和1 Gbps網絡NIC (vmxnet3)上,執行包含90 GB數據的PostgreSQL數據庫的基本備份大約需要40分BriefCam鍾。

    考慮在實際環境中測試速度,以便能夠估計基本備份需要多長時間才能正確設置副本創建過程的時隙。

  9. 使用目錄的實際路PostgreSQL_Data徑。預設值為。C:\PostgreSQL_Data.BriefCam但是,這可能會因不同的設置而異(在本文檔稍後部分將使用默認BriefCam路徑)。

  10. 使用實際pgsql.exe路徑。預設值為C:\PostgreSQL\bin\psql.exe(本主題稍後會使用預設BriefCam路徑)。BriefCam

主伺服器上的步驟

  1. 連接到主PostgreSQL服務器sql shell,並通過執行以下命令驗證配置文件和hba文件的位置:

    C:\PostgreSQL\bin\psql.exe -U dbadmin postgres SHOW config_file; SHOW hba_file;

    以下是(根據資料PostgreSQL_Data夾位置)預期輸出的範例:

    C:/PostgreSQL_Data/postgresql.conf C:/PostgreSQL_Data/pg_hba.conf

  2. 通過在PowerShell中執行以下命令來備份原始config和hba文件:

    copy C:/PostgreSQL_Data/postgresql.conf C:/PostgreSQL_Data/postgresql.conf.$(((get-date).ToUniversalTime()).ToString("yyyyMMddTHHmmssZ"))

    copy C:/PostgreSQL_Data/pg_hba.conf C:/PostgreSQL_Data/pg_hba.conf.$(((get-date).ToUniversalTime()).ToString("yyyyMMddTHHmmssZ"))

  3. 通過執行以下命令驗證是否創建了備份文件:

    dir C:/PostgreSQL_Data/*.conf.*

    預期輸出為:

    PS C:\Users\Administrator> dir C:/PostgreSQL_Data/*.conf.*

    目錄:C:\PostgreSQL_Data

    模式LastWriteTime長度名稱

    ---- ------------- ------ ----

    -a---- 2021/10/11 11:22 AM 4374 pg_hba.conf.20211117T100109Z

    -a---- 11/10/2021 11:25 AM 23798 postgresql.conf.20211117T100344Z

  4. 將參數新增至postgres.conf檔案。您可以在文字編輯器中開啟檔案,並將以下行新增至檔案結尾(位於區Customized Options段正下方):

    wal_level = replica hot_standby = on hot_standby_feedback = on full_page_writes = on max_wal_senders = 6 max_replication_slots = 6

  5. 為複製創建角色/用戶並設置其密碼(不要使用示例命令中指定的密碼)。

    1. 通過PowerShell控制台使用以下命令連接到主PostgreSQL服務器的SQLshell:

      C:\PostgreSQL\bin\psql.exe -U dbadmin postgres

    2. 執行下列命令(在上一步中打開的SQLshell中):

      CREATE ROLE repl_user LOGIN REPLICATION PASSWORD 'replQwerty123';

  6. 將參數新增至pg_hba.conf檔案。您可以在文字編輯器中開啟檔案,並將以下行新增至檔案(在#replication privilege行下方):

    # replication privilege. host replication repl_user <secondaryIP>/32 md5

  7. 以管理員身份開啟PowerShell並執行下列命令,以重新啟動主要PostgreSQL伺服器上的BriefCamPostgreSQL服務:

    net stop "BriefCamPostgreSQL - PostgreSQL Server 10" net start "BriefCamPostgreSQL - PostgreSQL Server 10"

  8. 驗證配置文件是否包含您對該文件所做的postgres.conf更改,如下所示:

    1. 通過PowerShell控制台使用以下命令連接到主PostgreSQL服務器的SQLshell:

      C:\PostgreSQL\bin\psql.exe -U dbadmin postgres

    2. 通過SQLshell使用以下命令打印出添加到PostgreSQL會議文件中的自定義配置:

      \pset pager off SELECT pg_read_file('postgresql.conf');

    3. 驗證您現在可以在輸出底部看到新增到postgresql.conf檔案的行。

      Replicating postgresql conf.png
  9. 驗證配置文件是否包含您對該文件所做的pg_hba.conf更改,如下所示:

    1. 通過執行以下命令連接到主PostgreSQL服務器的SQLShell:

      C:\PostgreSQL\bin\psql.exe -U dbadmin postgres

      \pset pager off

      選擇pg_read_file('pg_hba.conf');

    2. 驗證您現在可以在輸出底部看到新增到pg_hba.conf檔案的行。

      Replicating pg_hba conf.png

在次要伺服器上的步驟

  1. 安裝BriefCamPostgreSQL。

  2. 在次要PostgreSQL伺服器上,以管理員身分在PowerShell中執行下列項目,以停止BriefCamPostgreSQL服務:

    net stop "BriefCamPostgreSQL - PostgreSQL Server 10"

  3. 清理數據目錄,如下所示:

    1. 重新命名資料PostgreSQL_Data夾。

    2. 創建一個名為“”的新文件夾,PostgreSQL_Data並在文件夾的“權限”選項卡中將“完全控制”添加到“所有人”。

      Replicating PostgreSQL properties.png
  4. 按如下所示從主服務器執行到輔助服務器的PostgreSQL基本備份:

    1. 以管理員身份在PowerShell中執行以下命令:

      c:\PostgreSQL\bin\pg_basebackup -h <primaryIP> -U repl_user --checkpoint=fast -D C:\PostgreSQL_Data -R TBD #--slot=standby1

    2. 建議在可能較長的BriefCam資料庫備份期間,停止所有伺服器上的所有服務。根據數據集的大小,可以在不停止所有服務的情況下執行此步驟。

  5. 在輔助PostgreSQL服務器上,以管理員身份在PowerShell中執行以下命令以啟動BriefCamPostgreSQL服務:

    net start "BriefCamPostgreSQL - PostgreSQL Server 10"

驗證複製操作

  1. 通過PowerShell控制台使用以下命令連接到主PostgreSQL服務器的SQLshell:

    C:\PostgreSQL\bin\psql.exe -U dbadmin postgres

  2. 通過在SQLshell中運行以下命令檢查延遲值(write_lag值必須以00:00:00開始):

    SELECT write_lag,client_addr FROM pg_stat_replication ;

    以下為預期輸出範例:

    postgres=#從pg_stat_replication中選擇write_lag,client_addr ;

    寫入延遲 | client_addr

    -----------------+-------------

    00:00:00.003972 | 10.30.30.30

    (1列)

    postgres=#

注意

此檢查每天至少需要執行一次。

啟動次要伺服器以作為主要伺服器

本節介紹在主服務器出現故障且需要恢復/遷移的情況下,作為PostgreSQL數據庫的主實例激活輔助服務器的過程。

  1. 將所有BC服務器中的hosts文件更改為反映<次要IP>而不是<主要IP>。

  2. 通過在PowerShell控制台中運行以下命令,檢查狀態並將輔助服務器PGSQL升級為主服務器(確保以管理員身份運行PowerShell,並相應地編輯pg_ctl.exe文件和PostgreSQL_Data文件夾的路徑):

    • c:\PostgreSQL\bin\pg_ctl.exe status -D ”C:\PostgreSQL_Data”

    範例輸出:

    pg_ctl: server is running (PID: 5672) C:\PostgreSQL\bin\postgres.exe "-D" "C:\PostgreSQL_Data"

    • c:\PostgreSQL\bin\pg_ctl.exe promote -D ”C:\PostgreSQL_Data”

    範例輸出:

    waiting for server to promote.... done server promoted

在從屬服務器上創建定期備份

Windows任務計劃程序中的PG_DUMP腳本
  1. 創建%APPDATA%\postgresql\pgpass.conf包含db憑據的文件(即: *:5432:*:dbadmin:Qwerty123)。 如需詳細資料,請參閱:https://www.postgresql.org/docs/10/libpq-pgpass.html和https://www.postgresql.org/docs/10/libpq-envars.html (外部連結)。

    如果上述方法不起作用,可以在執行行上指定腳本的密碼:

    $env:PGPASSWORD='Qwerty123' ;& c:\PostgreSQL\bin\pg_dump.exe -F t -U dbadmin -d briefcam -f e:\PostgresBackups\db_briefcam-$(((get-date).ToUniversalTime()).ToString("yyyyMMddTHHmmssZ")).tar

  2. 建立備份檔案的資料夾,例如:。E:\PostgresBackups\

  3. 為備份腳本文件創建一個文件夾,例如:。E:\PostgresBackupScripts\

  4. 在E:\PostgresBackupScripts\backup.ps1以下位置創建備份腳本:使用如下所示的三個命令:

    • c:\PostgreSQL\bin\pg_dump.exe -F t -U dbadmin -d postgres -f e:\PostgresBackups\db_postgres-$((get-date)。ToUniversalTime()。ToString("yyymdthmmssz")。tar

    • c:\PostgreSQL\bin\pg_dump.exe -F t -U dbadmin -d briefcam -f e:\PostgresBackups\db_briefcam-$((get-date)。ToUniversalTime()。ToString("yyymdthmmssz")。tar

    • #ls -file E:\PostgresBackups\db*.tar | where {(get-date) - $_.creationtime -gt 15.} | Remove-Item –Verbose

    * 上述第3個命令應根據所需的備份保留時間進行調整,方法是刪除行開頭的“#”符號,然後修改數字15,因為它表示倒退的天數。例如,如果您要設定指令檔刪除所有超過7天的檔案,您必須將數字15變更為7。

  5. 通過將-gt設置為0測試備份的創建和舊文件的刪除,並在Windows cmd中運行以下命令:

    powershell.exe e:\PostgresBackupScripts\backup.ps1

    Replicating PostgresBackupScripts.png

    這樣會移除所有已建立的檔案。

  6. 調整備份的保留期間,如上述步驟4底部所述。

  7. 將備份腳本添加到Windows任務計劃程序,如下所示:

    1. 將程序/腳本字段設置為以下路徑:

      C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe

    2. 在“新增引數”欄位中,設定下列項目: E:\PostgresBackupScripts\backup.ps1

      Replicating add arguments.png
  8. 相應地設置觸發和計時。

    Replicating set triggers.png
  9. 無論使用者是否已登入並儲存密碼,設定工作執行即可。

    Replicating task scheduler.png
  10. 在測試伺服器上,檢查檔案是否可還原。這個測試應該成為你日常工作的一部分。

以下是restore命令的示例:

C:\PostgreSQL\bin\pg_restore.exe -c -v -U dbadmin -d briefcam -F t e:\PostgresBackups\db_briefcam-20211122T122052Z.tar

參數會執-c行刪除與建立。如需其他選項,請參閱:

“C:\PostgreSQL\bin\pg_restore.exe --help” 

修復後,還原為主伺服器

如果您是因為主服務器出現問題而使用輔助服務器,本節將介紹在問題解決後如何還原為主服務器。

注意

以下過程的詳細信息可能因主服務器所遭遇的故障類型而異。要考慮最嚴重的情況(主服務器絕對崩潰),以下步驟包括全新安裝。

  1. 從頭開始安裝作業系統。

  2. 在目前主伺服器的“主伺服器上的步驟”區段中執行步驟。

  3. 考慮到重新安裝的服務器現在從技術上講是“次要”實例,在服務器上執行下面各節中所述的所有操作:

  4. 停止用作主服務器的服務器上的PostgreSQL服務。

  5. 驗證系BriefCam統是否正常工作。

  6. 執行步驟,在用作主服務器的服務器上創建複製副本。