TeamForge 7.1 Administration Guide | Contents | 2 Contents TeamForge system administrator how-tos.............................................................6 Install CollabNet TeamForge 7.1........................................................................................................................6 Plan your CollabNet TeamForge 7.1 installation.....................................................................................6 Set up networking for your TeamForge server........................................................................................7 Install CollabNet TeamForge 7.1 on Red Hat/CentOS............................................................................7 Install CollabNet TeamForge 7.1 on SuSE............................................................................................58 Install TeamForge on VMware Player or VMware ESXi................................................................... 107 Upgrade to TeamForge 7.1.............................................................................................................................. 111 Plan your upgrade to TeamForge 7.1.................................................................................................. 111 Upgrade to TeamForge 7.1 on Red Hat/CentOS................................................................................. 112 Upgrade to TeamForge 7.1 on SuSE................................................................................................... 182 Upgrade to CollabNet TeamForge 7.1 on a virtual machine...............................................................251 Is my TeamForge site "dedicated" or "advanced?"............................................................................. 253 Enable reporting while upgrading from TeamForge 6.1.1 to 7.1........................................................ 254 Troubleshooting: Upgrade PostgreSQL manually............................................................................... 254 Install a different build of TeamForge 7.1...........................................................................................255 Maintain your TeamForge 7.1 site...................................................................................................................256 Upgrade PostgreSQL using PGTurant................................................................................................. 256 Upgrade CLI reports to the latest version on Red Hat, CentOS or SUSE...........................................258 Install Indexer on a separate server..................................................................................................... 258 Supply your TeamForge license key from Teamforge user interface..................................................260 Supply your CollabNet TeamForge license key as a text file............................................................. 260 Support CollabNet TeamForge System Administrators.......................................................................261 Protect your CollabNet TeamForge site...............................................................................................270 Get information about a CollabNet TeamForge site............................................................................276 Rebuild runtime without the install directory...................................................................................... 276 Turn on site-wide reporting..................................................................................................................277 Synchronize TeamForge source control integrations...........................................................................277 Provide more than one source control server...................................................................................... 278 Upgrade Subversion on RedHat or CentOS.........................................................................................278 Upgrade Subversion on SuSE.............................................................................................................. 279 Change the scmviewer password......................................................................................................... 279 Change your site's domain name..........................................................................................................280 Specify DNS servers.............................................................................................................................281 Optimize PostgreSQL with vacuum.....................................................................................................281 Change the location of a log file......................................................................................................... 281 Change the logging level on your site................................................................................................. 281 Raise the logging visibility of selected database requests................................................................... 282 Rotate TeamForge log files..................................................................................................................283 Schedule data extraction for reporting................................................................................................. 283 Removing users from monitoring objects............................................................................................ 284 Back up and restore CollabNet TeamForge data................................................................................. 284 Move the datamart to a separate box...................................................................................................286 Integrate TeamForge 7.1 with other tools........................................................................................................288 Integrated application example: Pebble................................................................................................288 Set up Black Duck Code Sight............................................................................................................ 289 Set up Review Board............................................................................................................................305 Set up Git..............................................................................................................................................316 A preface to the TeamForge-Orchestrate integration...........................................................................317 | Contents | 3 Frequently asked questions about administrating a TeamForge site.............. 318 TeamForge installation/upgrade FAQs.............................................................................................................318 TeamForge 7.1 installation/upgrade FAQs.......................................................................................... 318 Users invoked via su command in TeamForge....................................................................................319 Do I need an advanced TeamForge installation?.................................................................................319 How many servers do I need to run a CollabNet TeamForge site?.....................................................320 What are the right PostgreSQL settings for my site?......................................................................... 321 How does TeamForge handle third-party applications?...................................................................... 321 Should I upgrade to TeamForge 7.1 on a new box?........................................................................... 322 Should I move my TeamForge database to its own server?................................................................323 Should I move my source control application to its own server?........................................................323 Is it possible to change artifact prefixes in TeamForge?..................................................................... 323 Can I run other java applications in the same JBoss instance as CollabNet Team Forge?.................. 323 What does it mean to run CollabNet TeamForge on a virtual machine?.............................................324 Who is responsible for applying OS updates to the underlying VMware image?............................... 324 What is a patch?................................................................................................................................... 324 Why do I get a URL "not found" or "moved permanently" error after applying a patch/upgrade?..... 324 Why does the the Yum installer display a warning message on Centos 6?.........................................325 Why am I getting a Yum repository filename conflict?...................................................................... 325 When do I run the initial load job?..................................................................................................... 325 Common errors in TeamForge......................................................................................................................... 326 Troubleshooting VMware errors.......................................................................................................... 326 Troubleshooting database/datamart/ETL errors................................................................................... 327 Troubleshooting JBoss errors..............................................................................................................