From Cerberus Helpdesk Wiki

Contents 1 Licensing Note 2 From Cerb2 or Cerb3 3 From Cerb4 3.1 Download 3.1.1 Subversion 3.1.2 GitHub 3.2 Database 3.3 Storage 3.4 Permissions 3.5 Pretty URLs 3.6 Upgrade 3.7 Security

Licensing Note

The license format has changed in Cerb5. You should contact support before you upgrade and get a new license to Cerb5 first; otherwise, you will be restricted to a single seat (one simultaneous worker).

From Cerb2 or Cerb3

If you're still running Cerb2 or Cerb3 then the Cerb5 upgrade process is the same as the Cerb4 process. This is required because the 4.x/5.x database is in an entirely different format. Read the instructions on upgrading from 2.x/3.x to Cerb4/5. You will need to install Cerb5 first.

From Cerb4

• The database is upgradeable (e.g. no tedious migration necessary).
• The filesystem is not upgradeable.
• The source code repositories (GitHub and Subversion) have moved.
• Make a backup!!

Download

• Download the Cerb5 files and install them in a new location.

Subversion

 svn co "https://github.com/wgm/cerb5.git/branches/stable" cerb5

GitHub

 git clone "http://github.com/wgm/cerb5.git" cerb5

Database

• Copy the following settings from /cerb4/framework.config.php to /cerb5/framework.config.php:

 APP_DB_DRIVER
 APP_DB_HOST
 APP_DB_DATABASE
 APP_DB_USER
 APP_DB_PASS'
 APP_DB_PCONNECT
 LANG_CHARSET_CODE
 DB_CHARSET_CODE

NOTE: If you haven't upgraded your Cerb4 database to UTF-8 yet, now would be a good time to do that.

Storage

• Move your custom plugins from /cerb4/plugins to /cerb5/storage/plugins (Move only any custom plugins you have developed. Do not move the default plugins.)
• Copy /cerb4/storage/attachments/* to /cerb5/storage/attachments (do not copy the hidden /storage/attachments/.svn directory)

You could use rsync to do this, since it has the nice -C option, which ignores any SVN or CVS files. (see man rsync)

For example:

[root@cerberus html]# rsync -aCv cerb4/storage/attachments/ cerb5/storage/attachments/

Permissions

• All the /cerb5 files should be readable by your webserver user.
• All the contents of the /cerb5/storage directory should be writeable by your webserver user.

Pretty URLs

• If you're running Apache with mod_rewrite enabled, simply copy the /cerb5/.htaccess-dist file to /cerb5/.htaccess and your helpdesk URLs should become prettier (i.e., /cerb5/index.php/tickets becomes /cerb5/tickets).

Upgrade

• Open http://www.example.com/cerb5/ in your web browser and the system will patch itself.

Security

• See: Security_Considerations