VMWare Appliance

The OForge appliance has all the components setup and ready to go. The following is a brief description of the image layout and how to keep it up to date.

Installing

• Install VMWare Server
• Download the lastest VMware image from our site.
• Unpack the VMware image. You can use  7-zip if you don't have a decent shell.

  $ tar xfj oforge-appliance.tar.bz2
  

• Open VMWare Server Console
• Select Open.. from the File menu
• Press the Browse button
• Select the unpacked oforge-appliance directory
• Click ok
• Start VM

Logging In

The login is root/password. You can log in through the vmware console, or with ssh.

Layout

/etc/
  conf.d/
    apache2                     - apache startup configuration
    net                         - guest network settings
    hostname                    - guest hostname
    clock                       - control timezone
  apache2/
    htpasswd/oforge-staff       - internal oforge users
    vhosts.d/
      oforge.inc                - configuration that belongs to all oforge vhosts
      oforge.conf               - oforge apache config
  subversion/config             - set nostore passwords so multiple users can use the oforge account
  layman/layman.cfg             - oforge overlay is defined here
  svnpolicies/svnpolicies.conf  - svnpolicies trac plugin configuration
  mail/                         - alias for oforge
  postfix/                      - postfix configuration, please review and change domain
  make.conf                     - please review mirrors for your location
/usr/local/mailman/             - mailman installation
/var/trac-oforge/               - the trac install
  bin/
  oforge-admin                  - create projects
  oforge-projects-upgrade       - upgrade all projects
  oforge-wiki-export            - export project wiki
  update-irc-search             - update irc logs search, should be run from cron
  refresh_svn_policies_symlinks - if you change policies by hand, run this script to update hooks
  conf/
    trac.ini                    - site-wide configuration
    trac.ini.oforge             - base configuration
  cgi-bin/
    oforge-auth.wsgi            - check external user permissions for projects
    trac-index.*                - index all projects
    trac.wsgi                   - trac entry point
  htdocs/                       - trac htdocs
  htdocs.oforge/                - oforge htdocs
/var/oforge/
  docroot/                      - apache docroot
  share/                        - symlink to trac 
  svn/                          - project repos
  trac/                         - trac projects
/var/oforgetools                
  oforgetools/
    settings.py                 - oforgetools base configuration
    settings_local.py           - oforgetools configuration

Permissions

See OForgePermissions for more details about user types. Internal users are stored in /etc/apache2/htpasswd/oforge-staff. External users are stored in the project trac directories passwd file. You should delete any existing users for security.

# htpasswd2 -b /etc/apache2/htpasswd/oforge-staff siteuser siteuserpasswd
# htpasswd2 -b /var/oforge/trac/testproject/passwd projectuser projectuserpasswd

To make someone a site-wide admin, add them to the oforge admins list.

# /usr/share/trac/conf/trac.ini
[oforge]
admins = user