post-install.py

Run the post-install.py script to perform TeamForge post installation/upgrade actions. For example, run this script for setting up CLI reports, integrating Gerrit SCM with TeamForge, integrating SVN and CVS, and so on. This script is intelligent enough to identify the list of post installation actions required based on the TeamForge applications that are configured and running locally.

post-install.py [-D|--debug] [-c|--component <teamforge component>] [-r|--reconfigure] [-g |--group]

Option	Description
-D\|--debug	Use this option to enable debug mode. Enabling the debug mode displays all the back-end debug messages on the console.
-c\|--component	Use this option to run the post installation action for a specific TeamForge component. By default, if this parameter is not specified, all the post installation/upgrade actions for all relevant TeamForge components running on the server are performed. Valid values: app, etl, database, datamart, subversion, cvs, gerrit and codesearch.
-g \|--group	Run post installation for a specific application group. Valid values: clireports, reporting, codesearch, scm, projecttemplates and fixpermissions.
-r\|--reconfigure	To reconfigure the post installation with default credentials.
-O \|--option	The post-install.py script prompts for input for items such as TeamForge admin user name, password, etc. Use this option to pass such parameters as command line arguments so that you are not prompted for the same later. Valid values: teamforge-tf.siteadmin.username=<USERNAME> teamforge-tf.siteadmin.passwd.secure=<PASSWORD> gerrit-tf.gerritdb.passwd.secure=<PASSWORD>
-h\|--help	Use this option to display help information about post-install.py.

Usage examples

Run the following command with no arguments to run the all post installation actions based on TeamForge applications that are configured in the current server.
./post-install.py
Run the following command to run post installation actions specific to Black Duck Code Sight.
./post-install.py -c codesearch
Run the following command to reconfigure Gerrit integration.
./post-install.py -c gerrit -r
Run the following command to run post installation actions specific to SCM integrations such as Subversion, CVS or GIT relevant to the context.
./post-install.py -g scm

Manually create SCM integration in case your integration server uses self-signed (or wildcard) certificates

If your integration server uses self-signed (or wildcard) certificates, the post-install.pyscript may fail to create SCM integration. In such case, you may have to manually create the SCM integration using the TeamForge Admin > Integrations > SCM Integrations UI. The following message is shown when you run the post-install.py script on integration servers that use self-signed (or wildcard) certificates.

Please create SVN integration through TeamForge Admin UI if your integration server uses self signed certificate. Failed.

Troubleshooting

See Post install fails for GIT. What should I do? for more information.