Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For version 5.0.0, we do not have OKTA authentication in place. This will be coming ASAP.


The

...

New Stuff

Version 5 of Open-AudIT. Wow, what a ride. Underneath the skin, it is huge. We have upgraded the underlying framework and brought the code itself up to current best practices. As a result, we now install on current Redhat, Debian, and Ubuntu and we need a minimum of PHP 7.4. Hence, the following are the officially supported distributions: Redhat 8/9, Debian 11/12, and Ubuntu 20.04/22.04. We also deprecated the omkd daemon and associated Perl framework. So now there is a single interface and a single website. Obviously, this makes for less code. Which means fewer errors. And less work. All in all, I'm very happy with the result. Party popper

...

This is not difficult. Perform the below steps to upgrade. The 'from' and 'to' distributions really don't matter. You are free to go from (say) Centos 7 to Debian 12.

On your new server, install a new distribution of your choice (from our new list of supported ones as above). You will need SSH on this machine.

On your new server, install Open-AudiT v5.0.0 as per a regular fresh install.

On your new server, verify it is working (you can get to the GUI and log in).

On your original Open-AudIT server, take a backup of the database.

Note - you may need to substitute your MySQL root user password if it is not the default).

Note #2- The log entries in the database will be deleted (but you still have them on your original Open-AudIT server).

Code Block
mysql -u root -popenauditrootuserpassword -e "DELETE FROM oa_user_sessions; DELETE FROM logs;"
mysqldump -u root -popenauditrootuserpassword --extended-insert=FALSE --routines openaudit > /tmp/openaudit.sql

On your new server, copy the database backup from the original server along with a couple of other directories. Run the below (obviously substitute the items in CAPITAL letters).

Code Block
scp YOUR_USERNAME@ORIGINAL_OPEN_AUDIT_SERVER:/tmp/openaudit.sql /usr/local/open-audit/
scp YOUR_USERNAME@ORIGINAL_OPEN_AUDIT_SERVER:/var/www/html/open-audit/custom_images/* /usr/local/open-audit/public/custom_images/
scp YOUR_USERNAME@ORIGINAL_OPEN_AUDIT_SERVER:/usr/local/open-audit/code_igniter/application/attachments/* /usr/local/open-audit/app/Attachments/

On your new server, restore the database.

Code Block
cd /usr/local/open-audit
mysql -u root -popenauditrootuserpassword -e "DROP DATABSE openaudit; CREATE DATABASE openaudit;"
mysql -u root -popenauditrootuserpassword openaudit < openaudit.sql

On your new server, log in. You should be asked to upgrade the database. Obviously, please do so.

On your new server, if you're happy, delete the database backup.

...