#
#    $Id: INSTALL,v 1.10.2.2 2004/03/15 06:57:11 theatrus Exp $
#

IRM 1.4.X RELEASE INSTALL INSTRCUTIONS
---------------------------------------------

IRM 1.4.0 Special Information -- IMPORTANT
-----------------------------
The new frontpage allows a guest user to easily look through the FAQ and
to enter a new work request.  This works perfectly under fresh installs
(unless you decide to change the password on the guest account), but 
will not necessarily work if you are upgrading from an older version of
IRM.  To get the front page to work properly, make sure that there is a 
user named "IRMConnect" with the password "irmconnect".


IRM 1.4.0 Special Information -- IMPORTANT
-----------------------------
The software section of IRM is undergoing major changes at this time.
Do NOT upgrade to this version of IRM if you depend on the data in 
your software tables, part of the upgrade process includes deleting 
some of the information in the software tables.  In later versions
of IRM, conversion scripts will be included in order to populate
the new style database with your information.


If Things Go Wrong
------------------

Before we start, its important that you know what to do if things
go wrong.  First, check the FAQ (in this directory), if that doesn't
help, go to the webpage, subscribe to irm-discuss, and ask there.


Requirements
------------

To run IRM, you will need the following.

- Webserver:  Apache is recomended, but others can work.  www.apache.org

- PHP: You will need at least PHP 4.2.x with the following functions enabled.
	+ MySQL 
	+ If you are interested in SNMP support, SNMP
	+ If you are interested in LDAP support, LDAP compiled in to PHP
	
If you are interested in SNMP support, you will also need UCD SNMP installed
ucd-snmp.ucdavis.edu

If you have any problems installing any of these packages, or you 
have installed them, and IRM is just not working, I suggest trying this link:

NOTE: This is probably outdated by now :(

http://www.linuxguruz.org/index.html?state=PHPTips&topic=PHP402

Many systems have packages for the above, but many of them are not
configured correctly (PHP in Apache has no MySQL support although
MySQL is installed - common on RedHat systems).  I recommend
building everything from source for a server anyway.  

Installing
----------
By now you probably have already extracted IRM by gzip and tar.  Make sure 
that everything in the IRM directory gets placed where the webserver can find 
it.  Next edit the file include/config.inc.php with your favorite text editor 
(vi, emacs, notepad, etc...).  The file is documented if you need it.  All
useful configutation options live in this file.  Pay attention to the PREFIX
and UPREFIX variables.

Next Setup the Database *** This is new for versions 1.4.x ***:

New Install: Create a database named 'irm'. You can do this with the mysqladmin command,
	     or numerous other tools you may use to administrate your MySQL install.
	     You need not create any tables, just the database.

Point your web browser to setup.php within your IRM install.  For example, if
you installed IRM at http://www.schoenefeld.org/irm, point your web browser
to http://www.schoenefeld.org/irm/setup.php and follow the instructions on the
page.  After you complete this step, be sure to remove the setup.php file for security reasons.

***** IF SETUP.PHP DOESN'T SEEM TO DO ANYTHING, SEE ITEM 2 IN THE FAQ ******

You are almost there!  Open your web browser to the irm directory, log in with 
'Admin' as the user and 'admin' as the password.  Next, click on the "Setup"
link at the top of the page, then click on "Configure IRM" in order
to configure IRM to suit your needs.

Upgrades:

* Note: Upgrades only really work between 1.4 releases. If you're trying to move
	an older install to 1.4, please seek help in the mailing list.

Point your web browser to setup.php within your IRM install.  For example, if
you installed IRM at http://www.schoenefeld.org/irm, point your web browser
to http://www.schoenefeld.org/irm/setup.php and select your current IRM version
from the dropdown box.  After you complete this step, be sure to remove the 
setup.php file for security reasons, or at least chmod 000 it.

You are almost there!  Open your web browser and point it to your new irm 
installation.  Log in as a user with admin privelages (by default this is
"Admin" with password "admin". Note usernames are case sensitive in IRM). Next, click on the 
"Setup" link at the top of the page, then click on "Configure IRM" in order
to configure IRM to suit your needs.

You can always check for updates: http://www.stackworks.net/irm/


Keith Schoenefeld & Yann Ramin
keith-p@schoenefeld.org
atrus@atrustrivalie.org
