How To Install or Upgrade Open-AudIT (Linux)

Open-AudIT can be downloaded, installed, configured and discovering devices in under 10 minutes.

NOTE - These instructions are in beta until 5.3.0 is released (particularly the dependencies).

In short, run the installer and it will take care of everything for you.

Downloading & Installing


Go to open-audit.org and download the latest version. Supply your name, email and company and download the binary.

Run “sudo ./OAE-Linux-x86_64-release_5.2.2.run” and the installer will take care of the dependencies for you.

Log on to Open-AudIT and you should see a splash screen informing you that you do not have a license – but Opmantek will give you a 20 device license for free. Just fill out the form and your 20 device license will be activated.

All you need to do now is add some credentials, add a discovery and run it. Done!

Once you have installed Open-AudIT, hop over to our Getting Started page for more helpful information.


Upgrading

Upgrading is essentially the same as installing.

Just run the installer as per above and when you log on to the web interface, you will be directed to the database schema upgrade screen.

Run this and your schema will be upgraded and you can then continue to use Open-AudIT as normal.

Don't forget we have release notes available for every version so you'll know exactly what has changed.


Database Creation

Open-AudIT requires a database to store its information in. If you ever need to manually create this database, the commands to do so are below. You should have already set a root password. If you have not, the default root password set by an Open-AudIT installation is openauditrootuserpassword.

NOTE - Running the installer will take care of this for you.

Create the database.

mysql -u root -p -e "CREATE DATABASE openaudit;"

Create the database user.

mysql -u root -p -e "CREATE USER openaudit@localhost IDENTIFIED BY 'openauditpassword';"

Give the user access tot he database.

mysql -u root -p -e "GRANT ALL PRIVILEGES ON openaudit.* TO openaudit@localhost IDENTIFIED BY 'openauditpassword'; FLUSH PRIVILEGES;"

Populate the database schema.

mysql -u root -p openaudit -e "/usr/local/open-audit/other/open-audit.sql"



Dependencies

Open-AudIT relies on dependencies to function. These dependencies are based on the distribution and version you are using. They are below.

NOTE - Running the installer will take care of these for you.

Redhat 8

subscription-manager repos --enable=rhel-8-server-optional-rpms

dnf -y install @php:8.0 httpd

dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

/usr/bin/crb enable

dnf -y upgrade

dnf install -y curl httpd ipmitool libnsl libsodium libsodium-devel logrotate make mariadb-server net-snmp nmap perl-Crypt-CBC perl-Time-ParseDate php-cli php-devel php-intl php-ldap php-mbstring php-mysqlnd php-pear php-process php-snmp php-xml samba-client screen sshpass wget zip

pecl channel-update pecl.php.net

pecl install libsodium

echo 'extension=sodium.so' > /etc/php.d/20-sodium.ini

systemctl enable php-fpm

systemctl enable httpd

systemctl enable mariadb

chmod u+s /usr/bin/nmap

Redhat 9

subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms

subscription-manager repos --enable=rhel-9-server-optional-rpms

dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

/usr/bin/crb enable

dnf -y upgrade

yum install -y curl httpd ipmitool libnsl libsodium logrotate mariadb-server net-snmp nmap perl-Crypt-CBC perl-Time-ParseDate php php-cli php-intl php-json php-ldap php-mbstring php-mysqlnd php-process php-snmp php-sodium php-xml samba-client screen sshpass wget zip

systemctl enable php-fpm

systemctl enable httpd

systemctl enable mariadb

chmod u+s /usr/bin/nmap

Debian 11 / 12

apt-get update -qq

apt-get -yq -o Dpkg::Options::=--force-confdef -o Dpkg::Options::=--force-confold install mariadb-server apache2 apache2-utils libapache2-mod-php openssh-client php php-cli php-curl php-intl php-ldap php-mbstring php-mysql php-snmp php-xml nmap zip wget curl sshpass screen smbclient logrotate ipmitool snmp libcrypt-cbc-perl

systemctl restart apache2

systemctl restart mysql

chmod u+s /usr/bin/nmap

dpkg-statoverride --update --add root root 4755 /usr/bin/nmap


Ubuntu 20.04 / 22.04 / 24.04

apt-get update -qq

apt-get mariadb-server apache2 apache2-utils libapache2-mod-php openssh-client php php-cli php-curl php-intl php-ldap php-mbstring php-mysql php-snmp php-xml nmap zip wget curl sshpass screen smbclient logrotate ipmitool snmp libcrypt-cbc-perl

systemctl restart apache2

systemctl restart mysql

chmod u+s /usr/bin/nmap

dpkg-statoverride --update --add root root 4755 /usr/bin/nmap