Start CollabNet SourceForge Enterprise 5.0

Use the collabnet script to launch CollabNet SourceForge Enterprise 5.0 along with all the associated services.

  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.0.
  3. When you are satisfied that httpd.conf.cn_new meets all your networking requirements, rename it to httpd.conf.
  4. Start the Apache web server.
    • /etc/init.d/httpd start
  5. Run the collabnet start command on all the machines in your group.
    • /etc/init.d/collabnet start
    Note: The first time you start a new site that has been migrated from an earlier version of SourceForge, startup may take a long time. This is due to data migration that must take place before the site launches. The length of the pause depends on the number and size of projects on the old site.
    Tip: On CentOS 4 or RHEL4, 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]

    To work around this, symlink to an existing .so file, like this:

    • sudo ln -s /usr/lib/libpq.so.4 /usr/lib/libpq.so.3

    Ignore this if you are running CollabNet SourceForge Enterprise 5.0 in VMware Player.

  6. 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 CollabNet SourceForge Enterprise 5.0 is installed.
    • If you provided a value for the DOMAIN option 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.
    Tip: As part of your verification steps, it's a good idea to stop CollabNet SourceForge Enterprise 5.0 and reboot the machine to make sure all services come up at startup.
  7. Advise your site's users to refresh their browser cache the first time they log into the new site. Use language like this:
    "Welcome to your newly upgraded CollabNet SourceForge Enterprise 5.0 site. This release comes with a brand new look and feel designed to make your experience more productive and intuitive. To make sure you are able to view all the new UI elements, please start by pressing Ctrl-F5 to refresh your browser."
    Tip: You can use your site's Project News feature to do this. See Post a news item.
Related reference
collabnet