您可以利用各種設定來配置管理主控台。在
頁面上尋找這些設定。當您按一下
時,系統會顯示設定清單。按一下系統設定的名稱,即可顯示設定的編輯畫面。畫面包含下列按鈕:
下表說明可用的設定。
設定 |
說明 |
---|---|
帳戶鎖定消除時間 |
預設值:60 分鐘。在此段時間之後,系統會捨棄前次失敗的登入嘗試。如果設為負值,則不會捨棄失敗的登入。 |
帳戶鎖定嘗試次數上限 |
預設值:3。鎖定帳戶之前容許的連續嘗試登入失敗次數。如果設為 0,則會停用帳戶鎖定。 |
帳戶鎖定重設計時器 |
預設值:120 分鐘。下限:5 分鐘。 允許使用者在鎖定之後嘗試再次登入所需的時間。如果設為負值,鎖定將永不到期。
註: 管理者必須重設使用者,使用者才能再次登入。
|
警示電子郵件限制 |
設定系統在指定的分鐘數內傳送的警示電子郵件數目上限。例如,10/60 這個值將上限設為每小時 10 個訊息。預設值 0/0 表示警示電子郵件訊息數目沒有限制。 |
套用列入的步驟儲存器環境 |
預設值:否。如果為「是」,則會套用包含列入步驟之專案或程式庫的環境。
註: 在 Java 引擎上不受支援。
|
最後套用伺服器環境 |
預設值:否。如果為「是」,則會在最後時才套用步驟的伺服器環境。伺服器環境是在步驟環境或專案環境之後套用。這只有在指定環境時才適用。
註: 在 Java 引擎上不受支援。
|
審核字串長度上限 |
預設值:128 個字元。 控制可以為詳細變更記錄的資訊量。如果字串值超出此字元數,則會儲存加密雜湊,而非原始值。加密雜湊可節省儲存空間。若為包含機密性資訊(如密碼)的欄位,則無論字串長度為何,都會使用加密雜湊。 |
審核原則 |
決定審核記載量。
|
自動登出分鐘數 |
系統會自動登出閒置使用者。此設定指定在系統登出使用者之前必須經過的閒置時間分鐘數。當設為 0 時,系統不會自動登出使用者。 |
AutoClean 錯誤日誌天數 AutoClean 資訊日誌天數 AutoClean 警告日誌天數 |
這些值表示每一個項目種類留在審核日誌中的最大天數。會自動刪除較舊的項目。如果值為 0,則系統永不會刪除該種類的項目。字串值在求值後為 0(代表整數),可讓您使用 Never 之類的值來代替 0。 |
建置取消檢查頻率 |
指定系統檢查建置取消要求的頻率(以秒為單位)。 |
主控台埠 |
Web 伺服器用來接聽 Build Forge 要求的埠號。 |
主控台 URL |
Web 伺服器用來接聽 Build Forge 要求的 URL。 如果主控台在非 80 的埠上執行,則必須設定此值。如果設定此值,則會將預設的主控台 URL 置換為此值。它會採用 protocol://hostname[:port] 格式。範例:http://myHost:81。 |
失敗時繼續進行步驟部分 |
決定同一步驟中多個指令部分的執行行為。當設為預設值 No 時,步驟中失敗的指令部分會導致步驟失敗。設為 Yes 時,失敗的指令部分不會導致步驟失敗。您可以執行步驟中的其他指令部分。如需指令部分的相關資訊,請參閱資訊中心主題「系統如何將步驟分割成幾個部分」(開發 > 使用步驟 > 控制執行流程)。 |
建立缺少的路徑 |
預設值:否。如果為「是」,則系統會建立專案的路徑(如果該路徑尚未存在的話)。 |
資料庫大小臨界值 |
資料庫大小達到此臨界值時,主控台就會傳送通知。
記住: 當逼近臨界值時,使用者介面效能會降到最低。執行資料庫清理或增加臨界值大小可以還原效能。
預設值:2G。 註: 在 Java 引擎上不受支援。
|
資料庫大小臨界值通知 |
資料庫大小達到臨界值時,要傳送電子郵件的目標使用者名稱或通知群組。如果利用使用者名稱,則會使用該使用者的電子郵件欄位中的位址。請參閱 。
註: 在 Java 引擎上不受支援。
|
設定一次日期 |
決定 .date 指令值是每個工作設定一次,還是每個步驟設定一次。此行為取決於所指派的值,如下所示:
當您在電子郵件通知(例如 .email 指令或通知範本)中使用包含 .date 的環境變數時,請輸入是。電子郵件中所使用的環境變數即會使用引擎的時區。 |
預設代理程式連接埠 |
設定用來建立代理程式連線的預設埠號。 |
預設匯入類別 |
如果匯入的專案沒有定義類別,或者有不存在的類別,就會使用這個類別。 預設值:正式作業 |
摘要演算法 |
訊息摘要的演算法。代理程式配置中也有對應的 digest_algorithm 設定。有效值為 SHA1 和 SHA2。 預設演算法:SHA1 註: 當您使用「安全雜湊演算法 2」(SHA2) 在「管理主控台」與代理程式中啟用密碼加密時,請更新密碼加密內容檔 bfpwcrypt.conf。
附註:Perl 引擎在訊息摘要中不支援「安全雜湊演算法 2」(SHA2)。SHA2 摘要支援適用於 Build Forge 8.0 及 Build Forge Agent 8.0 的 Java MJC。 若配置內容檔 bfpwcrypt.conf 中未啟用密碼加密,請使用下列步驟為 SHA2 啟用密碼加密:
|
摘要演算法(續) |
附註(續):若已在配置內容檔 bfpwcrypt.conf 中啟用密碼加密,請使用下列步驟,為 SHA2 重新啟用密碼加密:
|
啟用快速啟動 |
預設值:否。所有專案都會顯示下列圖示:![]() ![]() 註: 只會檢查為專案定義的變數。不會檢查為專案中步驟所定義的變數。另請參閱啟動工作時變更專案變數。
如果設為是,「專案」頁面會檢查專案的所有環境,以判斷是否有任何變數設為必須變更類型。下列圖示表示適合立即啟動的專案: |
強迫執行限制 |
預設值:否。如果為是,則系統會啟動專案的排程建置,但前提是這樣啟動不違反專案的執行限制設定。如果為否,系統會忽略專案對排程建置的執行限制設定。 |
匯入預設安全存取群組 |
當使用安全存取來匯入設定是設為 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。否則,系統無法執行足夠的處理程序來支援執行佇列。
註: 在 Java 引擎上不受支援。
|
最大列入深度 |
控制系統容許的專案列入層數,以避免專案的巢狀無限地增加。預設值是 32。如果此值設為 0,則系統會使用 32。當系統達到列入限制時,就不會執行超出此限制的列入專案。步驟不會插入到內含專案中。訊息會寫入系統訊息清單中:已放棄列入。
註: 在 Java 引擎上不受支援。
|
可同時進行的伺服器測試數上限 |
指定一次可以執行的伺服器測試數。視系統資源而定,一次執行太多伺服器測試會嚴重減緩或鎖定主控台。 |
同時執行的清除數上限 |
控制可同時執行多少清除。您可以清除任意數量的建置。不過,如果建置數量超出同時執行的清除數上限欄位中的值,則會同時刪除建置。預設值:20。 |
重新整理次數上限 |
自動重新整理網頁的次數上限。預設值:50。 |
形成鏈接時置換類別 |
決定系統是否將鏈結專案類別取代為其呼叫端的類別。預設值 Y 會使系統置換鏈結專案類別,並改用呼叫端類別。 |
密碼到期天數 |
指出在此天數之前,有設定密碼到期的使用者必須變更其密碼。當時間到期,使用者需要在下次登入時變更其密碼。 |
密碼格式 |
使用以句點隔開的六欄位格式字串,來指定使用者密碼的需求:
例如:5.2.u1.l1.n1.s1。 前兩個欄位指定下列項目:
其餘欄位指定字元類型及頻率需求。每一個欄位都包含一種類型和一個號碼。
其類型如下所示:
範例:字串 5.2.u1.l1.n1.s1 表示下列密碼需求:
例如,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,表示會以第二順位處理鏈結專案環境,並且會置換步驟伺服器環境。
註: 在 Java 引擎上不受支援。
|
伺服器讀取逾時 |
在系統停止嘗試讀取代理程式之前等待的時間(秒)。
註: 在 8.0 中新增的功能。僅用於 Java 主要工作控制器。
|
伺服器重試次數 |
設定當找到符合所有選取元條件的伺服器時,系統在停止並放棄步驟之前,嘗試將步驟配置至伺服器的次數。 |
伺服器寫入逾時 |
在系統停止嘗試寫入代理程式之前等待的時間(秒)。
註: 在 8.0 中新增的功能。僅用於 Java 主要工作控制器。
|
伺服器測試頻率 |
與已啟用的伺服器數目一起用於決定測試及重新整理伺服器資訊清單資料的頻率。預設值是 120 分鐘或 2 小時。值 0 表示您不需要檢查伺服器。 在這些檢查期間,系統會聯絡所有已啟用的伺服器來驗證:
執行伺服器測試的速率下限是每分鐘一台伺服器。如果伺服器數目大於此設定,該速率會增加。 系統會在該段間隔內平均分散這些測試活動。例如:
手動測試伺服器從主控台開始,優先順序高於自動化測試。 伺服器收集器的複雜度會影響傳輸量。執行許多手動指令以收集資料的收集器,可能需要超過一分鐘來完成資料收集。 |
伺服器使用連接逾時值 |
註: 在 Java 引擎上不受支援。
指出在建立代理程式連線之後,在連線失敗之前,管理主控台等待連線開啟的秒數上限。如果在達到逾時期間之前發生 Socket 錯誤或程式碼失敗,連線也可能會失敗。 指出連至代理程式之現有連線的逾時值。代理程式的設計是每 15 秒聯絡管理主控台一次。如果在逾時期間內未聯絡到,代理程式可能已停止,或者可能是發生網路通訊問題。如果超過此值,步驟會失敗。 |
伺服器等待時間 |
設定檢查以判定伺服器是否變成可用的間隔秒數。 註: 在 8.0 版中新增的功能。僅用於 Java 主要工作控制器。
|
服務層級鑑別 Servlet URL |
當設定此項時,會將程式化方式建構的 URL 置換為服務層級鑑別 Servlet。 如果您使用別名或非預設埠,則必須使用下列格式來更新這項設定:http://server:port/jas/AuthServlet |
SMTP 伺服器 |
設定在傳送電子郵件通知時要作為 SMTP 伺服器的電腦。 預設值為 localhost。 |
堆疊 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。支援下列電子郵件位址格式:
其中使用者名稱 是電子郵件使用者名稱。 名稱 是任意字串,通常是某形式的給定名稱。 若要傳送至多個位址,請以逗點 (,) 或分號 (;) 區隔它們。 |
系統警示來源 |
當系統傳送警示電子郵件訊息時,它會使用此設定中定義的位址作為傳送者。 預設值為 root@localhost。支援下列電子郵件位址格式:
其中使用者名稱 是電子郵件使用者名稱。 名稱 是任意字串,通常是某形式的給定名稱。 |
全系統登入訊息 |
可讓您定義要顯示在登入表單上方的訊息。 |
全系統使用者訊息 |
可讓您定義要顯示在每一頁頂端的訊息,它就位於導覽按鈕的下面。 |
標籤:日期格式 |
定義用來顯示 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 變數時,這些行數會顯示在通知中。 |
終止執行緒 |
決定含執行緒作業的步驟何時失敗。相同專案中的所有其他作用中執行緒區塊都會停止。 |
追蹤代理程式資料鏈結 |
指出是否對主控台與代理程式之間的通訊啟用詳細追蹤。 預設值:否 |
使用 Java 主要工作控制器作為工作執行引擎 |
設為是時,系統會使用 Java 主要工作控制器來執行主要工作控制器專案。無法啟動 Perl 引擎專案。新建的專案預設為使用主要工作控制器,而不是 Perl 引擎。 設為否時,系統只會使用 Perl 引擎來執行 Perl 引擎專案。 |