The Will Will Web

記載著 Will 在網路世界的學習心得與技術分享

CollabNet Subversion Edge 安裝筆記 (4):自訂版本庫範本

昨天在研究 CollabNet Subversion Edge 如何自訂版本庫範本 (Repository Template),照著介面來設定、查了線上文件,其中有種範本的格式文件都說支援,但我怎樣設定就是不成功,雖然最後找到官方論壇有解決方法,但不是很方便,我便利用 WinMerge 找出真正無法設定成功的主因,特此筆記一下。

我們每次建立版本庫 (Repository) 時,都要重複的建立基本目錄架構、設定版本庫的 hooks 指令檔,這項任務在 CollabNet Subversion Edge 的管理介面就可以用 自訂版本庫範本 (Repository Template) 的方式來完成,對版本庫管理作業來說非常的方便,省去了許多功夫。

如果你已經正確設定 Repository Template 話,在建立版本庫時就會看到以下畫面:

如果要自訂版本庫,可以參考下圖來建立新的範本:

然而,建立 Repository Template 時是有說明範本檔的格式支援以下三種格式:

  • A valid template file can be formatted as a dump file or a zip archive of a single dump file.
  • Alternatively, it may be a zip archive containing the contents of a repository, in which case the template could also include hook scripts.

如果覺得說明的不夠清楚,可以再到線上文件查詢(含圖),網址如下:
CollabNet Subversion Edge User Guide > Manage repositories > Create a repository template

  • A repository dump file
  • Zipped archive of a repository dump file
  • Zipped archive of the contents of a repository: this should contain the entire repository (including the db and hooks folders), not just a checkout of some portion of the repository

前兩種格式很簡單,就是把版本庫 dump 出來就可以當成範本來上傳,但這並無法滿足我的需求,我需要的是連 hooks 指令檔都當成範本的一部份,這時必須要選擇用三種格式當成範本才行。

我依照文件說明,把整份 Repository 壓縮起來上傳(如下圖示),建立範本的過程沒有問題,有問題的地方在於建立版本庫的時候,即便我選用了我上傳的範本,建立版本庫後,完全都沒有套用成功!

我得到的錯誤記錄如下:

The loading of the dump file or archive into repository 'TestProject' failed.

Exception:
Type: com.collabnet.svnedge.RepoLoadException
Stacktrace:
com.collabnet.svnedge.console.SvnRepoService.loadDumpFile(SvnRepoService.groovy:933)
com.collabnet.svnedge.console.SvnRepoService$loadDumpFile$0.callCurrent(Unknown Source)
com.collabnet.svnedge.console.SvnRepoService.loadDumpFile(SvnRepoService.groovy:883)
com.collabnet.svnedge.console.SvnRepoService$loadDumpFile.call(Unknown Source)
com.collabnet.svnedge.admin.RepoLoadJob.execute(RepoLoadJob.groovy:47)
org.quartz.core.JobRunShell.run(JobRunShell.java:199)
org.quartz.simpl.SimpleThreadPool$WorkerThread.run(SimpleThreadPool.java:546)

幾經苦惱之下到論壇查詢問題解答,所幸還是讓我找到 RE: Problem using repository templates 這一篇討論,透過 Hot Backup (Hotcopy) 的方式也可以取得一份完整可用的範本,不過透過備份的方式來取得範本步驟有點繁複,相關說明可參考:Schedule repository backups

我為了釐清真像,選擇用 WinMerge 去比對我自己壓縮的版本與透過 CollabNet Subversion Edge 線上執行 Hotcopy 的版本,結果發現,我自己對目錄進行壓縮的檔案裡多了一個檔案,位於 db\write-lock

只要把這個 write-lock 檔案從壓縮檔中刪除,就可以順利變成一份在 CollabNet Subversion Edge 裡可使用的版本庫範本了!

後來我也發現,原來在 svnadmin 工具裡也有個 hotcopy 指令可用,我只要利用這個指令也可以製造出一份有效的版本庫範本檔案,而透過指令來執行備份也是我認為比較好的方法,相關說明請參考 svnadmin hotcopy 文件說明。

 

相關連結