Open-AudIT

Hi,

As I proposed in a previous topic, I would like to compile a user's guide for OAv2.

I started with simple copy and paste what I think is important.

Any comment & help welcome!

Open AudIT User's guide

1) What is Open AudIT v2 and what does it do ?

Open-AudIT is an application to tell you exactly what is on your network, how it is configured and when it changes. Open-AudIT will run on Windows and Linux systems. Essentially, Open-AudIT is a database of information, that can be queried via a web interface. Data about the network is inserted via a Bash Script (Linux) or VBScript (Windows). The entire application is written in php, bash and vbscript. These are all 'scripting' languages - no compiling and human readable source code. Making changes and customisations is both quick and easy.

Windows PCs can be queried for hardware, software, operating system settings, security settings, IIS settings, services, users & groups and much more. Linux systems can be queried for a similar amount of information. Network devices (printers, switches, routers, etc) can have data recorded such as IP-Address, MAC Address, open ports, serial number, etc, etc. Output is available in PDF, CSV and webpages. There are export options for Dia and Inkscape.

Open-AudIT can be configured to scan your network and devices automatically. A daily scan is recommended for systems, with network scans every couple of hours. That way, you can be assured of being notified if something changes (day to day) on a PC, or even sooner, if something "new" appears on your network.


2) Installation guide.


Download OAv2_beta3_with_xampplite.zip from here
Download OAv2_beta5.zip from here
Download the most recent audit script from here

Extract contents of OAv2_beta3_with_xampplite.zip file to C drive so that you have C:\xampplite

Make sure to use C:\xampplite or you will need to change file paths in several places in the config. I won't detail that here.

Edit c:\xampplite\phpMyAdmin\config.inc.php and change 

Code:
$cfg['Servers'][$i]['password']             = '';
to
$cfg['Servers'][$i]['password']             = 'password';


Run setup_xampp.bat in root of xampplite directory and choose option 1 to start XAMPP Control Panel

In control panel click Start button for MySQL
In control panel click Start button for Apache

Start web browser and go to http://localhost/

You should get the OpenAudit login page.

Login with Username: admin and Password: password

Select Help menu then About

Upgrade your database schema by clicking the "upgrade" link in the text that says "You should upgrade your database."

Open your web browser to http://localhost/phpmyadmin

Select oav2 database in menu on left

Select oa_group_column table on left

Click the X delete icon on each row of data in the right pane with a group_id = 0

In control panel click Stop button for Apache

Delete all files and directories in C:\xampplite\OAv2
Delete all files and directories in C:\xampplite\htdocs

Extract contents of OAv2_beta5.zip somewhere

Copy contents of extracted beta5 to c:\xampplite\OAv2
Copy contents of c:\xampplite\OAv2\www to c:\xampplite\htdocs

Rename downloaded audit script to audit_windows.vbs

Copy renamed audit script to c:\xampplite\OAv2\other overwriting original

In control panel click Start button for Apache

Start web browser and go to http://localhost/ 

You should get the OpenAudit login page or if already logged in the main page

Login with Username: admin and Password: password

Select Help menu then About

Upgrade your database schema by clicking the "upgrade" link in the text that says "You should upgrade your database."

Open c:\xampplite\OAv2\other\audit_windows.vbs in a text editor

Change submit_online = "n" to submit_online = "y"

Change url = "http://localhost/index.php/system" to url = "http://servername/index.php/system"

Change skip_software = "y" to skip_software = "n"

Start a cmd prompt and run "cscript audit_windows.vbs"

After the audit completes and uploads check the OA web interface to see if the system shows up

In the cmd prompt run "cscript audit_domain.vbs"


3) Configuration guide.



4) Open AudIT how to's .

A lot of those steps go away if the xammplite version gets updated to beta6 (or later) and the data problems get cleaned up. Since the xammplite version is supposed to be the "it just works" version I think we should reduce the complexity of the install first.

Maybe if I created an updated xammplite version Mark could post that. I'm not sure how much control/trust he want to seed to others.

[quote]A lot of those steps go away if the xammplite version gets updated to beta6

_________________
Support and Development hours available from [url=https://opmantek.com]Opmantek[/url].
Please consider a purchase to help make Open-AudIT better for everyone.

Hi !

Ok it's just an easy copy/paste that I've made for now.

I'll wait for a stable version of OAv2 to help writing a documentation. But my english is not so good so, be indulgent please...

I think I will translate it to french when I finished.

When do you think there will be a stable version of OAv2 ?