系統配置設定

您可以利用各種設定來配置「管理主控台」。您可以在管理 > 系統頁面上,找到這些設定。

當您按一下管理 > 系統時,系統會顯示設定清單。按一下系統設定的名稱,即可顯示設定的編輯畫面。

註: 如果系統設定採用數值,「管理主控台」會接受由一或多個整數(0 到 9)所組成的任何值。但不支援數值分組字元,如逗點 (,)、小數點 (.) 以及其他非整數分隔字元。

畫面包含下列按鈕:

下表說明可用的設定。

設定

說明

帳戶鎖定消除時間 預設值:60 分鐘。在此段時間之後,系統會捨棄前次失敗的登入嘗試。如果設定為負值,則不會捨棄失敗的登入。
帳戶鎖定嘗試次數上限 預設值:3。鎖定帳戶之前需要達到的連續失敗的登入嘗試次數。如果為 0,則會停用帳戶鎖定。
帳戶鎖定重設計時器 預設值:120 分鐘。下限:5 分鐘。允許使用者在鎖定之後嘗試再次登入所需的時間。如果設定為負值,鎖定將永不到期:管理者必須重設使用者,才能容許使用者嘗試再次登入。
警示電子郵件限制 設定系統在指定的分鐘數內傳送的警示電子郵件數目上限。例如,10/60 這個值將上限設為每小時 10 個郵件。預設值是 0/0,系統將它解譯成沒有郵件限制。
套用列入的步驟儲存器環境 預設值:否。如果為「是」,則會套用包含列入步驟之專案或程式庫的環境。
最後套用伺服器環境 預設值:否。如果為「是」,則會留待最後再套用步驟的伺服器環境。伺服器環境是在步驟環境或專案環境之後套用(如果這兩個環境都有指定的話)。
審核字串長度上限 預設值:128(個字元)。控制可以為 DETAILED 變更記錄的資訊量。如果字串值超出此字元數,則會儲存加密雜湊(而非原始值)以節省儲存空間。若為包含機密性資訊(如密碼)的欄位,則無論字串長度為何,皆會使用加密雜湊。
審核原則 決定執行審核記載的數量。
NONE
不記錄審核資訊。
SECURITY
僅記錄安全相關資訊。範例:建立存取群組及使用者階段作業活動。
BASIC
此為預設值。如果存在無效的「審核原則」值,則也會使用此值。僅會記錄最少的資訊,如使用者、物件類型、UUID 及動作。
DETAILED
記錄哪些內容已變更的相關詳細資訊,包含舊值及新值。並非所有物件皆可提供此資訊。對於無法提供此資訊的物件,BRIEF 與 DETAILED 原則之間沒有任何差異。「審核字串長度上限」系統配置設定,可用於限制儲存的資料數量。

自動登出分鐘數

系統可自動登出閒置的使用者。 此設定指定在系統登出使用者之前必須經過的閒置時間分鐘數。 當此設定為 0 時,系統不會自動登出使用者。

AutoClean 審核日誌天數

AutoClean 錯誤日誌天數

AutoClean 資訊日誌天數

AutoClean 警告日誌天數

這些值設定每一種項目可留在審核日誌中的最大天數;會自動刪除舊的項目。 如果此值為 0,則系統不會刪除該種類的項目。因為字串值在求值後會為 0(代表整數),您可以使用 "Never" 之類的值來代替 0。

建置取消檢查頻率

指定系統檢查建置取消要求的頻率,以兩次檢查之間的秒數來表示。

主控台埠

Web 伺服器用來接聽 Build Forge 要求的埠號。

主控台 URL

Web 伺服器用來接聽 Build Forge 要求的 URL。

如果主控台在非 80 的連接埠上執行,就必須設定此值。 如果設定了,就會將預設的主控台 URL 置換為此值。它會採用 <protocol>://<hostname>[:<port>] 格式。範例:http://myHost:81

失敗時繼續進行步驟部分 決定同一步驟中多個指令部分的執行行為。設定為預設值「否」時,步驟中的失敗指令部分會導致該步驟失敗。設定為「是」時,失敗指令部分不會導致該步驟失敗。您可以執行步驟中的其他指令部分。關於指令部分,請參閱知識中心的「系統如何將步驟分割成幾個部分」(開發 > 使用步驟 > 控制執行流程 > 步驟如何執行)。
建立缺少的路徑 預設值:否。如果為「是」,則會建立專案的路徑(如果還沒有建立該路徑的話)。
資料庫大小臨界值 主控台在傳送通知時資料庫大小的臨界值。預設值:2G。

請注意,當逼近臨界值時,使用者介面效能會變差。執行資料庫清理或增加臨界值大小可以還原效能。

資料庫大小臨界值通知 達到「資料庫大小臨界值」時,電子郵件所要送往的「使用者名稱」或「通知群組」。如果用了「使用者名稱」,也會一併使用該使用者「電子郵件」欄位中的位址。請參閱「管理 > 使用者」。
設定一次日期 決定 .date 指令值是每個工作設定一次,還是每個步驟設定一次。此行為取決於所指派的值,如下所示:
  • No:此為預設值。.date 指令值會在每一個步驟設定一次。每個步驟均會使用代理程式機器的時區,對 .date 值重新求值。代理程式會提供值。重新啟動後仍會保持 .date 值。對這些值重新求值的方式,與起始執行時完全相同。在使用相同變數的每個步驟中,相同變數可能會有不同的值,因為會針對每個步驟重新解譯 .date 值。
  • Yes:目前的 .date 指令值會在每個工作設定一次。此日期值是使用引擎主機的時區(而非代理程式的時區)產生的。重新啟動後仍會保持 .date 值。

當您在電子郵件通知(例如 .email 指令或通知範本)中使用包含 .date 的環境變數時,請使用 Yes。電子郵件中所使用的環境變數即會使用引擎的時區。

預設代理程式連接埠 設定用來建立代理程式連線的預設埠號。
預設匯入類別 如果匯入的專案沒有定義類別,或者它所定義的類別不存在,就會使用這個類別。 預設值:Production。
停用 XML 訊息饋送的鑑別 決定是否要鑑別 RSS 資訊來源。
啟用快速啟動 預設值是「否」:所有專案都會顯示下列圖示:「快速啟動」圖示。當您按一下專案時,會檢查專案所有併入的變數,找出類型為「必須變更」的變數。如果專案不含「必須變更」變數,就會啟動該專案。如果專案包含「必須變更」變數,就不會啟動該專案,並且會出現一個說明原因的對話框,而圖示則會變更為如下圖示:「快速啟動」已停用圖示
註: 只會檢查為專案定義的變數。不會檢查為專案中步驟所定義的變數。另請參閱啟動工作時變更專案變數

如果設為「是」,「專案」頁面會檢查頁面上所有專案的所有環境,以判斷是否有任何類型為「必須變更」的變數。適合立即啟動的專案用這個圖示來表示:「快速啟動」圖示。在 7.1.1.1 版之前,這是預設行為。

強迫執行限制 預設值:否。如果為「是」,則系統會在其啟動不違反專案的執行限制設定的情況下,啟動專案的排程建置。如果為「否」,系統會忽略專案對排程建置的執行限制設定。

匯入預設安全存取群組

使用安全存取匯入設定為 Y 時,指定所匯入專案的預設存取群組。

匯入不安全預設存取群組 使用安全存取匯入設定為 N 時,指定所匯入專案的預設存取群組。唯有當匯入檔案缺少存取群組時,才會使用預設群組。

使用安全存取進行匯入

當設定為 Y 時,系統會指派之前設定所列出的預設存取群組給匯入的資料物件。 這樣會置換您所匯入的 XML 檔中指定的任何存取群組,因此,使用者無法藉由匯入資料來置換安全性。 若設定為 N,系統將允許使用所匯入檔案中的任何存取群組設定。

繼承標籤

若設定為「是」,會使透過鏈接而啟動的工作使用與其呼叫端相同的工作標籤。 如果專案 MasterProject 的 BUILD_15 呼叫專案 ComponentProject,則 ComponentProject 該次執行的工作標籤(及工作目錄名稱)會變成 BUILD_15。
註: 被呼叫的專案一律繼承呼叫端的原始標籤;如果呼叫端的標籤在執行期間變更,則(比方說)因為 .retag 指令的結果,被呼叫的專案仍會獲得呼叫端開始時的標籤。

無效相對目錄字元

設定的字元若使用於專案名稱中,將被系統變更為底線。

LASTRUN 格式

使用對 .date 指令定義的日期格式,輸入 BF_LASTRUN 環境變數的格式值(請參閱.date)。

授權伺服器

授權伺服器主機名稱。它是在安裝期間設定的。範例:myhost.mycompany.com。 此值可包含埠號。範例:myhost.mycompany.com:80。若要變更授權伺服器,請參閱變更「管理主控台」的授權伺服器

鏈結除錯模式

當設為「是」時,已定義配接器鏈結的工作會執行鏈結測試,而不是執行相關聯的專案。工作輸出包含單一步驟,其中含有配接器的輸出。當您進行配接器介面的疑難排解時,這個資料很有用。

註: 您可以將配接器鏈結的「狀態」設為「除錯」,來設定個別配接器鏈結的除錯功能。該狀態的優先順序高於「鏈結除錯模式」設定。

鏈結手動工作

決定在您手動快速啟動專案,而不是從排程器執行時,系統是否透過配接器鏈結來執行配接器。

鏈結檢查可能會在工作的 BOM 中產生其他輸出。

如果設為 N,就不會在工作執行時,檢查或執行鏈結。

主控台處理程序數目上限

設定主控台一次可執行的處理程序數目上限。 使用它作為對主控台活動的一般節流控制。系統會在資料庫中儲存每一個處理程序的 ID,並在啟動新的外部處理程序之前檢查總計,以管理處理程序。確定此值至少比執行佇列大小設定大 5;否則,系統將無法執行足夠的處理程序來支援執行佇列。

最大列入深度

控制系統容許的專案內嵌層數,使專案的巢狀不會無限地增加。 預設值是 32。 如果此值設定為 0,則系統使用 32。當系統達到列入限制時,就不會執行超出此限制的列入專案,且其步驟不會插入到包含它的專案中。此時系統訊息清單中會寫入下列訊息:「已放棄列入。」

可同時進行的伺服器測試數上限

指定一次可以執行的伺服器測試數目。 視系統資源而定,一次執行太多伺服器測試會嚴重減緩或鎖定主控台。

同時執行的清除數上限

控制可同時執行多少清除。您可以清除任意數量的建置,但同時刪除的建置數量不會超過「同時清除數上限」中的值。預設值:20

重新整理次數上限 自動重新整理網頁的次數上限。 預設值:50

形成鏈接時置換類別

決定系統是否會將該鏈接專案的類別,換成其呼叫端的類別。預設值 Y,會使系統置換該鏈結專案的類別,並改用呼叫端的類別。

密碼到期天數

設定天數,在此天數之前,有設定密碼到期的使用者必須變更其密碼。 當此時間一到,相關使用者需要在下次登入時變更其密碼。

密碼格式

使用以句點隔開的六欄位格式字串,來指定使用者密碼的需求:
length.char_types.upper.lower.numeric.special

範例如下所示:5.2.u1.l1.n1.s1。下面將說明本範例。

前兩個欄位指定下列項目:

  • 密碼長度下限(字元)
  • 在其餘四個欄位中使用的字元類型數下限(1 到 4 的整數)

其餘欄位指定字元類型及頻率需求。每一個欄位都包含一種類型和一個號碼。

  • 類型:u(大寫)、l(小寫)、n(數字)或 s(特殊)其中之一。大寫字元(U、L、N、S)表示該字元為必要字元。小寫(u、l、n、s)表示該字元為選用字元。
  • 數字:如果是必要數字,則代表這類型的必要字元數。 如果是選用數字,則代表這類型的必要字元數(如果有使用其中任何一項的話)。

其類型如下所示:

  • U 或 u 代表大寫字元。這包含在各自的語言環境中被視為字母,但並非小寫的所有字元。具體來說,就是包含下列的字元:大寫、標題字首大寫,或單一大小寫語言(如中文)中的任何字母。
  • L 或 l 代表小寫字元。這包含在各自的語言環境中被視為小寫的所有字元。
  • N 或 n 代表數字字元。這包含在各自的語言環境中被視為數字的任何字元。
  • S 或 s 代表特殊字元。不符合上述三個種類的任何字元。包括所有不是字母,也不是數字的字元。

範例:字串 5.2.u1.l1.n1.s1 代表下列密碼需求:

  • 至少具備 5 個字元長
  • 至少必須含有四個種類(大寫、小寫、數字、特殊字元)其中兩種的字元。
  • 對於每一種類型而言,該類型的一個字元代表符合需求的一個項目。

例如,abC1x 和 Abc2% 就是合格的密碼。

暫停 Build Forge 引擎

若設定為 Y,系統會完成目前工作,然後暫停引擎。 將它設為 N,即可回到正常作業。

公用主機名稱

設定之後,系統就會以這項設定值,取代通知範本中 CONSOLEHOST 變數的伺服器主機名稱。

清除檢查時間

設定系統檢查要清除之工作的頻率,以兩次檢查之間的分鐘表示。

QuickReport 公用目錄 公用報告設計的檔案系統位置。

在 7.1 中,請使用此系統設定來指定公用報告的完整位置。您的報告設計必須位於這個目錄中,才會自動移轉它們。

在舊版中,預設檔案位置 (../../reports/public) 是相對於應用程式伺服器的安裝目錄,例如:<bfinstall>/Apache/tomcat/webapps/quickReport。

QuickReport 暫時目錄 在 7.1 中,請使用此目錄在與服務層元件相同的主機上,指定一個完整的目錄。服務層會使用這個工作目錄,來列出已順利移轉至資料庫的報告設計。

在舊版中,在將「快速報告」的報告設計儲存至檔案系統上的公用或專用目錄之前,會先使用這個目錄來暫時儲存它們。

QuickReport 使用者目錄 專用報告設計的檔案系統位置。

在 7.1 中,請使用此系統設定來指定專用報告的完整位置。您的報告設計必須位於這個目錄中,才會自動移轉它們。

在舊版中,專用報告的預設檔案位置 (../../reports/users) 是相對於應用程式伺服器的安裝目錄,例如:<bfinstall>/Apache/tomcat/webapps/quickReport。

重新載入語言套件 預設值:否。如果設為「是」,主控台會在重新啟動時重新載入其語言套件,並且將此值重設為「否」。從 7.0.1 版開始不再需要此設定。

重設配接器範本

使用此設定來重設配接器範本(將更新版的變更複製到配置中)。 如果要使用它,請將此值設定為「是」,然後等一分鐘。系統會重設範本,然後將此值設回「否」。

重設伺服器工作計數

請使用這個設定(是),將所有伺服器的工作計數 (BF_JOBS) 同時重設為零。當執行資訊清單檢查間隔時,就會進行重設。(預設時間是每隔 10 秒)。

當所有伺服器的 BF_JOBS 全部重設之後,重設伺服器工作計數值會就回到「否」(預設值)。

重新啟動報告移轉 預設值:否。在 7.1 中,如果您想直接啟動移轉,而不要重新啟動服務層元件,請將這個值設為「是」。
執行鏈的鏈結 控制已啟動的鏈專案是否也會啟動任何連接的配接器鏈結。

執行佇列大小

此值會限制系統同時執行的工作數目。 當佇列中的執行數目大於或等於這個數字時,系統便會停止將「等待」佇列的執行移到「執行」佇列,直到工作數目降到此值以下為止。 如果您變更「執行佇列大小」,請檢查「主控台處理程序數目上限」設定,它應該比「執行佇列大小」至少大 5。

儲存開始環境

控制專案的手動起始頁上的"儲存環境"勾選框的預設值。當此設定為 Y 時,該勾選框預設為已勾選;否則,該勾選框預設為不勾選。 勾選"儲存環境"勾選框之後,會使您在起始頁上對環境變數所做的變更,儲存到資料庫的環境記錄中,讓未來的執行數目預設為那些值。

鏈接前的伺服器環境

決定系統是要在步驟內設定鏈專案的專案環境之前 (Y) 還是之後 (N),設定步驟的伺服器環境。在第二個環境中處理的變數會置換第一個環境中的這些變數。預設值為 Y,表示鏈專案的環境會排在第二順位處理,並且會置換步驟的伺服器環境。

伺服器重試次數

設定當找到符合所有選取條件的伺服器時,系統在放棄並結束步驟之前,嘗試將步驟配置至伺服器的次數。

伺服器測試頻率

與已啟用的伺服器數目一起用於決定測試及重新整理伺服器資訊清單資料的頻率。預設值是 120 分鐘(2 小時)。值為 0 表示不檢查伺服器。

在這些檢查期間,系統會聯絡所有已啟用的伺服器來驗證:

  • 仍可抵達伺服器
  • 伺服器的登入資訊是正確的
  • 伺服器的資訊清單資料是最新資料

執行伺服器測試的速率下限是每分鐘一台伺服器。如果伺服器數目比此設定大很多,該速率會增加。

系統會在該段間隔內平均分散這些測試活動。範例:

  • 您擁有 120 台伺服器且間隔設為 120 分鐘。系統會嘗試每分鐘測試 1 台伺服器(120 台伺服器/120 分鐘)。
  • 您擁有 12,000 台伺服器且間隔設為 1200 分鐘。系統會嘗試每分鐘測試 10 台伺服器。
  • 您擁有 10 台伺服器且間隔設為 120 分鐘。每分鐘會檢查 1 台伺服器。在此範例情節中的更新間隔期間,每台伺服器會被檢查 12 次。

從主控台啟動的手動伺服器測試,其優先順序高於這些自動化測試。

伺服器收集器的複雜度會影響傳輸量。執行許多手動指令以收集資料的收集器,可能需要超過一分鐘來完成資料收集。

伺服器使用連接逾時值

設定在建立代理程式連線之後,在步驟失敗之前,「管理主控台」等待連線開啟的秒數。

設定連至代理程式之現有連線的逾時值。代理程式的設計是每 15 秒聯絡「管理主控台」一次。如果在逾時期間內未聯絡到,代理程式可能已停止,或者可能是網路發生通訊問題。如果超過這個值,步驟即會失敗。

服務層級鑑別 Servlet URL

當設定此項時,會將程式化方式建構的 URL 置換為服務層級鑑別 Servlet。

如果您使用別名或非預設埠,則必須使用下列格式來更新這項設定:http://server:port/rbf-services/AuthServlet

SMTP 伺服器

設定在傳送電子郵件通知時要作為 SMTP 伺服器的電腦。

預設值是 localhost。

SSO 遠端使用者 預設值:否。如果設為「是」,則可讓單一登入遠端使用者透過標準 Web 伺服器鑑別進行連線。

堆疊 BuildForge 環境變數

系統通常會把下傳至鏈接專案的 BF_ 變數名稱變更為 BF_CALLER_;當鏈接深度不止一層時,此設定將決定系統是否會堆疊名稱。 預設值為 N。當此設定變更為 Y,從深入呼叫端專案兩層所衍生的 BF_TAG 變數會接收 BF_CALLER_CALLER_TAG 名稱。

步驟重試數上限 控制如果第一次嘗試失敗,步驟會嘗試連接代理程式的次數。如果步驟在指定的重試次數內未連接成功,步驟就會失敗。

在本端儲存使用者鑑別

決定系統是否快取 LDAP/Active Directory 使用者鑑別資訊(加密格式)。預設值是「是」。唯有當您使用 LDAP/Active Directory 鑑別時,此系統才相關。若此設定為「是」,系統會快取加密格式的使用者鑑別資訊,並可將其與 _USE_BFCREDS 和 _USE_BFCREDS_DOMAIN 特殊變數(會將使用者鑑別套用至伺服器)搭配使用。您可以將此值變更為「否」,選擇關閉快取;然而,如果您這麼做,登入伺服器時,系統將無法使用 _USE_BFCREDS 和 _USE_BFCREDS_DOMAIN 特殊 變數來使用該使用者的認證。

系統警示電子郵件

系統會傳送警示電子郵件訊息到此設定所定義的位址。

預設值是 root@localhost。系統支援下列電子郵件位址格式。使用者名稱 是電子郵件使用者名稱。名稱 是任意字串,通常是某形式的給定名稱。
使用者名稱@host.com
名稱 使用者名稱@host.com
名稱 "<使用者名稱@host.com>"
名稱 <使用者名稱@host.com>
名稱 "使用者名稱@host.com"

若要傳送至多個位址,請以逗點 (,) 或分號 (;) 區隔它們。

系統警示來源

當系統傳送警示電子郵件訊息時,它會使用此設定中定義的位址作為傳送者。

預設值是 root@localhost。系統支援下列電子郵件位址格式。使用者名稱 是電子郵件使用者名稱。名稱 是任意字串,通常是某形式的給定名稱。
使用者名稱@host.com
名稱 使用者名稱@host.com
名稱 "<使用者名稱@host.com>"
名稱 <使用者名稱@host.com>
名稱 "使用者名稱@host.com"

全系統登入訊息

可讓您定義要顯示在登入表單上方的訊息。

全系統使用者訊息

可讓您定義要顯示在每一頁頂端的訊息,它就位於導覽按鈕的下面。

標籤:日期格式

定義用來顯示 BF_D 標籤變數之日期的格式。使用 y、m 和 d 字元作為年、月、日的變數,以顯示所要的格式和所要的任何特殊字元作為分隔符號。 例如,若日期為 2005 年 9 月 21 日:

格式字串....輸出

ymd...050921

m/d/y...09/21/05

標籤:時間格式

定義用來顯示 BF_T 標籤變數日期的格式。它的作用就如同「標籤:日期格式」設定,不過是使用 h、m 和 s 等字元來分別代表小時、分鐘和秒。h:m:s 設定會產生此種輸出:12:53:42。

郵件範本的結尾日誌數量

設定日誌結尾的行數,當通知範本中使用 TAILNORMALLOG 變數時,這些行數會顯示在通知中。

終止執行緒 決定當含有執行緒作業的步驟失敗時,相同專案中所有其他作用中的執行緒區塊是否會停止。

意見