Buildix

Due to some of the big changes in Buildix 2.1, care needs to be taken when upgrading from 2.0. As always before trying anything big, please make sure you have good backups of your data before trying this.

Upgrade Steps (all as root)

• Run the command: aptitude update
• Run the command: aptitude dist-upgrade
• During the install process, you will be prompted about replacing certain files. They are:
  • /etc/apache2/sites-available/buildix - you should select Y to install the maintainers version
  • /etc/buildix/htpasswd - you should select N to keep your current version.
  • /var/lib/mingle/config/auth_config.yml - you should select Y to install the maintainers version

Passwords

One of the security changes for 2.1 has been that we now store passwords in the /etc/buildix/htpasswd file as SHA hashes instead of the old crypt format. Apache and everything will still work with the old passwords, but we recommend you update existing users passwords using the user manager as soon as possible. Even if you don’t change the password, saving it will write it in the new format.

Mingle

To use the new Mingle API, Buildix needs to have the username and password of a Mingle admin user. If you upgrade, it will try and use the username/password combination of admin/admin, which probably does not match your Mingle installation. To fix this, you need to make sure that the username and password values in your /etc/buildix/buildix.conf file under the [mingle] section match a valid admin account in Mingle. If you don’t want to use Mingle, set mingle=False in the [modules] section of that config file. Note that you also need to connect to your Mingle URL and finish the upgrade process there before you can create new projects.

Ubuntu 7.04

If you’re still running on Ubuntu 7.04 you might have a problem with SSL. If you are getting a connection refused error, you need to do is edit the /etc/apache2/ports.conf file and add a new line reading Listen 443 and then restart Apache.