Start your new CollabNet SourceForge Enterprise 5.1 site

Launch CollabNet SourceForge Enterprise 5.1 along with all the associated services.

Set up the initial, or "bootstrap," data.
- ./bootstrap-data.sh -d <SITE_DIR>
Important: If your site uses a PostgreSQL database, you must authorize the bootstrapping utility to delete the <SITE_DIR>/var directory that was created when you installed PostgreSQL.
Create the runtime environment.
- ./install.sh -V -r -d <SITE_DIR>
Update your Apache configuration.
1. Back up your existing /etc/httpd/conf/httpd.conf file.
2. Review the new httpd.conf.cn_new that was created by the install process. The httpd.conf.cn_new file is an Apache server configuration file that combines your existing Apache configuration with directives specific to CollabNet SourceForge Enterprise 5.1.
3. When you are satisfied that httpd.conf.cn_new meets all your networking requirements, rename it to httpd.conf.
Note: If you have a separate SCM server, repeat this step on that server.
If SELinux is running, modify it to allow the services that CollabNet SourceForge Enterprise 5.1 requires.
1. Enable Apache (running on port 80) to proxy traffic to JBoss (running on port 8080).
  - setsebool -P httpd_can_network_connect 1
  Note: If you are installing on CentOS 4.6, skip this step.
2. Change the context for your local Subversion repository.
  - chcon -R -h -t httpd_sys_content_t /svnroot
3. Change the context for your local CVS repository, if you have one.
  - chcon -R -h -t httpd_sys_content_t /cvsroot
4. Change the context of the Subversion repository that handles the branding (look and feel) of your site.
  - chcon -R -h -t httpd_sys_content_t /sf-svnroot
  - chcon -R -h -t httpd_sys_content_t <SITE_DIR>/var/overrides
Start the application services.
- /etc/init.d/collabnet start all
Note: On CentOS 4 or Red Hat Enterprise Linux 4, you may get the following error at startup: Starting httpd: Syntax error on line 6 of /etc/httpd/conf.d/auth_pgsql.conf: Cannot load /etc/httpd/modules/mod_auth_pgsql.so into server: libpq.so.3: cannot open shared object file: No such file or directory [FAILED]
This can result from clearing out some conflicting rpm packages. Fix it by creating this symlink:
- ln -s /usr/lib/libpq.so.4 /usr/lib/libpq.so.3
Log into the site and verify that things are working.
- By default, the URL to log into is the machine name of the server on which your site is installed. If you provided a value for the DOMAIN variable in the site-options.conf file, then go to that domain to log in.
- The initial administrator username is admin and the password is admin. You are required to change the password the first time you log in.
- It's a good idea to stop CollabNet SourceForge Enterprise 5.1 and reboot the machine to make sure all services come up at startup.
Check that the value for Licensed Number of Users on the License Keys page matches the actual number of licensed users in your contract.

Important: Do not delete the csfe-install directory that you created to contain the installer. You may need it for future maintenance or upgrades.

Parent topic: Install CollabNet SourceForge Enterprise 5.1

Previous topic: Set up the database

Next topic: Supply your CollabNet SourceForge Enterprise 5.1 license key

Related reference

collabnet