Lanifex DMO Readme
==================

DMO is the Database of Managed Objects.  It is a tool
for security consulting and IT inventory management.
It provides an object-relational interface on top
of MySQL, with a Web interface.

DMO is based on LFXlib, a powerful library that 
supports user rights, groups, access controls and
much more.  LFXlib is also a product of Lanifex.

Copyright (C) 2001-2005 CSO Lanifex GmbH
License: GNU Public License v2.
Version: 2.2 Beta, 29 November 2005
Homepage: http://www.lanifex.com

This software is free for non-commercial use, however 
we do expect a license fee for commercial use.
Please see the documentation for details of this,
and our offer for commercial support and updates.

This software is available from Sourceforge, at
the address http://dmo.sourceforge.net

Installation
============
Prerequisites: 
a) download and install XAMPP from 
http://www.apachefriends.org/en/xampp-linux.html
Make sure you note all the passwords you will need.
b) download and install GraphViz from 
http://www.graphviz.org.
c) download and install pdflib from
http://www.pdflib.com

This package includes Apache, MySQL and PHP4 in an easily
installed package.  If you prefer, you can use the software
which comes with your distribution, but we didn't provide
RPM or DEB packages.

In summary, how to install (you'll need root access):

1) Enable PHP4 (it won't work with PHP5)
   In XAMPP, use this command: 
   # /opt/lampp/lampp php4

2) Set memory_limit = 32M in php.ini

3) Add MultiViews to the Options in httpd.conf:
   Options Indexes FollowSymLinks MultiViews

4) Copy directories LFXlib/ and dmo_new/ into
   /opt/lampp/htdocs/ along with the file htaccess, 
   which should be renamed to .htaccess

   # cp -rv LFXlib /opt/lampp/htdocs/
   # cp -rv dmo_new /opt/lampp/htdocs/
   # cp -rv docs /opt/lampp/htdocs/
   # cp -v htaccess /opt/lampp/htdocs/.htaccess

   Make directories in /opt/lampp/data, owned by
   nobody with group nogroup, e.g.

   # mkdir /opt/lampp/data/DMO_files/
   # mkdir /opt/lampp/data/LFX_files/
   # chown -R nobody /opt/lampp/data/

5) Copy files from ./etc into /opt/lampp/etc/LFX/ 
   (make this too), then edit them to change the 
   user name and passwords to match your MySQL 
   database.  Also check paths to your htdocs folder.

   # mkdir /opt/lampp/etc/LFX
   # cp etc/* /opt/lampp/etc/LFX

6) Restart Apache:
   # /opt/lampp/lampp restart

7) Load database with the files in ./sql directory.
   The user name is "root" and password is "secret".

   This will create databases dmo_new and lfxlib, e.g.
   # /opt/lampp/bin/mysql -u root -p < lfxlib.sql
   # /opt/lampp/bin/mysql -u root -p < dmo_new.sql

8) Connect to http://localhost/dmo_new/, and login
   with user "admin", password "secret".
   Change your password as soon as possible!

For details, please look in ./docs/DMO/book1.html

Update
======
To update to a new version, two steps are required.
First, copy the files as follows:

   # cp -rv LFXlib /opt/lampp/htdocs/
   # cp -rv dmo_new /opt/lampp/htdocs/
   # cp -rv docs /opt/lampp/htdocs/

To upgrade the database, check the folder "sql",
for scripts labelled "_upgrade".  For example,

   # cd sql
   # /opt/lampp/bin/mysql -u root -p  < dmo_new_upgrade.sql

This will retain all data, but alter the tables by
adding new columns as required.


Release Notes
=============
Release 2.3 beta, 30 November 2005

Small bug fixes, with a database change.  Please use 
the command to update the database as shown above.
------

Release 2.2 beta, 28 November 2005

This has an update on documentation.  It also includes a 
new feature to prepare graphs of dependencies and instance
children, based on the software GraphViz (see the site
http://www.graphviz.org) which should be also installed 
as a prerequsite for this capability.

Upgrade process for 2.2 beta: just copy the dmo_new
over the old directory, replacing old files.  There
are no database changes in this release.
------

Release 2.1 beta, 22 November 2005

This release now supports Windows, using XAMPP for Windows.
Please see the Windows_Readme.txt for details.

Documentation has been updated with new information.
------
Release 2.0 beta, 19 November 2005

This release is the first public release since two
years.  The software has undergone major changes,
and has a great increase of functionality.  This is a
modified version of the commercial package, with some
critical functionality (related to automated scanning)
disabled.  It is now much easier to use and install.

Note that this release does not include PDFLIB, which
is required to support generation of PDF files.
You may download this separately from http://www.pdflib.com.
It is not included due to the license requirements.

This package has been tested with XAMPP from ApacheFriends,
but will work with other distributions.  

------
Release 1.91 beta, August 2003

This was a release of basic code, but was difficult
to install and use.  

------
Release 1.90 alpha, July 2003

First public release.