Upgrading an existing installation

Before starting, it is essential to take a backup of your database and ensure that this backup is usable. The upgrade process may need to make changes to the structure of your database.

Also, if you have made any changes to the WaypointHR source files, you should take a copy of these before continuing.

Option 1 - Keep your existing database settings

Database settings are kept in conf/installation_settings.php. The distribution files for WaypointHR do not include this file. Therefore you should be able to uncompress the zip or tar.gz file to your existing directory without losing your connection settings. (You may wish to take a copy of your installation_settings.php file first, particularly if you intend to delete the existing WaypointHR files.)

The next time you log in, you will be prompted to verify the database (if required). This process automatically updates the database schema to reflect any changes required by the new version. (For example, new tables, additional columns, additional indexes etc.) The database update process is automatic, but you should always have a backup of your database before continuing.

Option 2 - Fresh installation

If WaypointHR cannot find an existing installation_settings.php file in the /conf directory, you will be prompted to follow the installation wizard (as for a new installation).

Simply enter the current settings for the existing database.

When asked for database details, enter your existing database server, schema and username/password details. (You do not need to enter the user details for the create permission.) A new configuration file will be created, and your existing database will be verified and updated if required. Again, a backup is essential.

Any comments or suggestions?

If you have any ideas for improving this page, please post your feedback in our community support forums.

Need additional support?

You can post your question in our forums, or please contact us for professional support and assistance.