FinalBuilder Server © 2012 VSoft Technologies 2 FinalBuilder Server Table of Contents Foreword 0 Part I FinalBuilder Server 5 1 FinalB.u..i.l.d..e..r. .S..e..r.v..e..r. .O...v..e..r.v..i.e..w................................................................................................ 5 2 Installa..t.i.o..n............................................................................................................................. 5 Requirements .......................................................................................................................................................... 6 Installing FinalB..u...i.l.d..e..r.. .S..e...r.v..e...r. ................................................................................................................................ 6 Post Installati.o..n.. .C...o..n...f.i.g..u...r.a..t..i.o..n.. ........................................................................................................................... 10 Configuration. .a..n..d... .M...a..i.n..t..e..n..a..n...c..e.. ......................................................................................................................... 14 3 Gettin..g.. .S..t.a..r.t.e..d..................................................................................................................... 17 Logging In .......................................................................................................................................................... 18 Creating New . .U..s..e...r.s... ............................................................................................................................................. 18 Configuring th..e... .B..u..i.l.d... .S..e..r..v..e..r.. .............................................................................................................................. 19 Uploading a Fi.n..a..l.B...u..i.l.d..e...r. .P...r.o...j.e..c..t. ......................................................................................................................... 20 Adding a New. .P..r..o..j.e...c..t. ........................................................................................................................................... 21 Controlling a P...r.o...j.e..c..t. ............................................................................................................................................. 22 View the Build.. .L...o..g..s... ............................................................................................................................................. 23 4 Admin..i.s..t.r.a..t.i.o..n...................................................................................................................... 24 Build Server C..o..n...f.i.g..u...r.a..t..i.o..n.. .................................................................................................................................. 25 Configuring.. .a.. .M...a..il. .S..e..r..v..e..r.................................................................................................................................. 26 Web Site A..p..p..e..a..r.a..n..c..e........................................................................................................................................ 26 Global Proj.e..c..t. .S..e..t.t.i.n..g..s....................................................................................................................................... 27 Global Tem.p..l.a..t.e..s................................................................................................................................................ 28 Application. .L..o..g................................................................................................................................................... 29 Build Queu.e........................................................................................................................................................ 30 Management .S..e...r.v..e...r. .C...o..n...f.i.g..u...r.a..t..i.o..n.. ................................................................................................................... 31 Managing U..s..e..r..s................................................................................................................................................. 31 Adding a new St.a..n..d..a..r.d.. .U..s..e..r...................................................................................................................... 32 Adding a new Ac..t.i.v..e.. .D..i.r.e..c..t.o..r.y.. .U...s..e..r.......................................................................................................... 33 Editing Existing U.s..e..r.s................................................................................................................................... 35 Deleting Existing .U..s..e..r.s................................................................................................................................. 35 Managing R..o..l.e..s.. .&.. .P..e..r..m..i.s..s..i.o..n..s.......................................................................................................................... 35 Permissions Ove.r.v..i.e..w.................................................................................................................................. 36 Adding a new Ro..le....................................................................................................................................... 38 Assigning Roles .t.o.. .U..s..e..r.s............................................................................................................................. 39 Managing L..i.c..e..n..s..e..s............................................................................................................................................ 39 5 Advan..c..e..d.. .T..o..p..i.c..s................................................................................................................. 40 Understandin.g.. .t.h...e.. .B..u...i.l.d.. .Q...u..e..u...e.. ......................................................................................................................... 40 Configuring M..u..l.t..i.p..l.e.. .B...u..i.l.d.. .S...e..r..v..e..r..s.. ................................................................................................................... 43 Web Service A..P...I. .................................................................................................................................................... 44 C# Example......................................................................................................................................................... 46 VB.NET Ex.a..m...p..le................................................................................................................................................. 47 Part II Triggers Reference 50 1 Trigge..r.. .T..y.p..e..s....................................................................................................................... 50 Time Trigger .......................................................................................................................................................... 51 File Trigger .......................................................................................................................................................... 53 © 2012 VSoft Technologies Contents 3 Run Process T...r.i.g...g..e..r.. ............................................................................................................................................ 54 Script Based T..r..i.g..g...e..r..s.. .......................................................................................................................................... 57 Python Exa..m..p..l.e.................................................................................................................................................. 58 Pow erShe.ll. .E..x..a..m...p..le........................................................................................................................................... 59 Version Contr..o..l. .T...r.i.g...g..e..r..s.. .................................................................................................................................... 59 Accurev T.r.i.g..g..e..r................................................................................................................................................ 61 Bazaar Trig..g..e..r................................................................................................................................................... 62 CVS Trigge..r....................................................................................................................................................... 63 Excluding F..i.le..s.. .f..r.o..m... .S..o..u..r.c..e.. .C...o..n..t.r.o..l. .M..o..n..i.t.o..r.i.n..g................................................................................................. 64 Git Trigger......................................................................................................................................................... 65 Mercurial T.r..ig..g..e..r................................................................................................................................................ 67 Perforce T.r.i.g..g..e..r................................................................................................................................................ 69 Plastic SCM.. .T..r..ig..g..e..r...........................................................................................................................................