CollabNet TeamForge 5.2 System Administrator Guide 2009 CollabNet Inc. CollabNet TeamForge 5.2 | TOC | 3 Contents Legal fine print......................................................................................................................7 CollabNet, Inc. Trademark and Logos.....................................................................................................7 Chapter 1: Set up a CollabNet TeamForge 5.2 site ......................................9 Install a dedicated CollabNet TeamForge 5.2 site..................................................................................10 Set up hardware for CollabNet TeamForge 5.2 .........................................................................10 Get CollabNet TeamForge 5.2 ...................................................................................................10 Configure your CollabNet TeamForge 5.2 site..........................................................................11 Install the CollabNet TeamForge 5.2 application.......................................................................12 Supply your TeamForge license key..........................................................................................12 Install an advanced CollabNet TeamForge 5.2 site ...............................................................................12 Set up hardware for an advanced CollabNet TeamForge 5.2 installation .................................13 Get CollabNet TeamForge 5.2 ...................................................................................................13 Configure your CollabNet TeamForge 5.2 site..........................................................................14 Install the CollabNet TeamForge 5.2 application.......................................................................15 Set up the database for your CollabNet TeamForge 5.2 site......................................................16 Start your new TeamForge site...................................................................................................18 Supply your TeamForge license key..........................................................................................18 Install CollabNet TeamForge 5.2 without Internet access......................................................................19 Install CollabNet TeamForge 5.2 on a virtual machine..........................................................................20 Get CollabNet TeamForge 5.2 ...................................................................................................20 Configure CollabNet TeamForge 5.2 ........................................................................................21 Supply your TeamForge license key..........................................................................................22 Upgrade a CollabNet SourceForge Enterprise 5.1 site to CollabNet TeamForge 5.2 ...........................22 Uninstall CollabNet TeamForge 5.1...........................................................................................23 Get CollabNet TeamForge 5.2 ...................................................................................................23 Get the CollabNet TeamForge 5.2 update package....................................................................23 Install the CollabNet TeamForge 5.2 application.......................................................................24 Finish your upgrade....................................................................................................................25 Upgrade a CollabNet SourceForge Enterprise 5.1 site to CollabNet TeamForge 5.2 on a virtual machine.26 Get the CollabNet TeamForge 5.2 upgrade package..................................................................26 Update CollabNet TeamForge 5.2 .............................................................................................26 Start CollabNet TeamForge 5.2 .................................................................................................27 Upgrade to TeamForge 5.2 without Internet access...............................................................................27 Install a different build of the same release............................................................................................28 Chapter 2: Support CollabNet TeamForge users........................................31 Authenticate users with LDAP...............................................................................................................32 Set up LDAP integration for the CollabNet TeamForge 5.2 server............................................32 Set up LDAP for a source control integration server.................................................................33 Modify the application policy....................................................................................................36 4 | CollabNet TeamForge 5.2 | TOC Let users see what's in a project template..............................................................................................36 Chapter 3: Grow your CollabNet TeamForge installation.........................37 Set up Subversion on its own server.......................................................................................................38 Set up the database for your CollabNet TeamForge 5.2 site on a separate server..................................38 Set up a PostgreSQL database on its own server.......................................................................39 Set up an Oracle database on its own server..............................................................................39 Chapter 4: Protect your CollabNet TeamForge site...................................41 Set up SELinux.......................................................................................................................................42 Protect Apache with SSL........................................................................................................................42 Set up Apache for SSL encryption.............................................................................................42 Generate Apache SSL certificates..............................................................................................43 Prevent HTTPS cracking............................................................................................................43 Protect integrations with SSL.................................................................................................................44 Set up SSH tunneling.............................................................................................................................45 Chapter 5: Maintain your CollabNet TeamForge installation...................47 Monitor services on your site.................................................................................................................48 Get information about a CollabNet TeamForge 5.2 site.........................................................................48 Patch CollabNet TeamForge 5.2 ............................................................................................................48 Go to an arbitrary patch level.....................................................................................................49 Revert a patch upgrade or downgrade........................................................................................49 Remove a patch..........................................................................................................................50 Troubleshoot patches..................................................................................................................50 Specify DNS servers..............................................................................................................................51 Optimize PostgreSQL with vacuum.......................................................................................................51 Change the location of a log file............................................................................................................52 Back up and restore CollabNet TeamForge 5.2 data..............................................................................52 Back up CollabNet TeamForge 5.2 data.....................................................................................52 Restore backed-up CollabNet TeamForge 5.2 data....................................................................53 Back up a PostgreSQL database.................................................................................................53 Restore a PostgreSQL database..................................................................................................53 Appendix A: Frequently asked questions about CollabNet TeamForge system administration.55 What does it take to install CollabNet TeamForge 5.2?.........................................................................56 Do I need an advanced TeamForge 5.2 install?..........................................................................56 How many servers do I need to run a CollabNet TeamForge 5.2 site?......................................56 Which application runs on which server?..................................................................................57 How does CollabNet TeamForge 5.2 handle third-party applications?......................................57 Which ports should I keep open?...............................................................................................58