(and discovering What’s On Your Network in 10 minutes)
Open-AudIT can be downloaded, installed, configured and discovering devices in under 10 minutes.
The main points are:
- Go to Open-AudIT.org and download the latest version. Install Open-AudIT.
- Log on to Open-AudIT and fill out the form to receive a free 20 device license.
- Add some credentials.
- Add a Discovery.
- Run the Discovery.
- Done!
Installing
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.
| Table of Contents |
|---|
Downloading & Installing
...
Go to open-audit.org and and download the latest version. Supply your name, email and company email and company and download the binary.
Run “sudo ./OAE-Linux-x86_64-release_5.2.02.11.run”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 Professional 20 device license will be activated.
All you need to do now is add some credentials, add a discovery and run it. Done!A screencast is below. This was recorded on a fresh Ubuntu 16.04 install that already had apache and mysql installed, as well as any updates applied (simply to save time for the screencast). If apache and mysql were not installed, the installer would have installed them for us, as it does the other required packages. To come!
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.
...
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.
| Code Block |
|---|
mysql -u root -p -e "CREATE DATABASE openaudit;" |
Create the database user.
| Code Block |
|---|
mysql -u root -p -e "CREATE USER openaudit@localhost IDENTIFIED BY 'openauditpassword';" |
Give the user access tot he database.
| Code Block |
|---|
mysql -u root -p -e "GRANT ALL PRIVILEGES ON openaudit.* TO openaudit@localhost IDENTIFIED BY 'openauditpassword'; FLUSH PRIVILEGES;" |
Populate the database schema.
| Code Block |
|---|
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
| Code Block |
|---|
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
| Code Block |
|---|
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
| Code Block |
|---|
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
| Code Block |
|---|
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 |