
==================================================
  install instructions for mindflip.org OIA.
--------------------------------------------------


=-=-=-=-=-=-=-=-=-=
INTRO:
=-=-=-=-=-=-=-=-=-=

These instructions, like the Perl code that makes up the OIA, 
are not prefect. Hell, they probably stink. If you can write 
better installation instructions for us please do and email 
them to us. Installing is a 4 Step process. Just follow the 
instructions step for step and you should have your OIA up 
and running on no time.



=-=-=-=-=-=-=-=-=-=
STEP #1:
=-=-=-=-=-=-=-=-=-=

Install ActiveState perl on your computer. You can find it at:

http://www.activestate.com/Products/Download/Get.plex?id=ActivePerl



=-=-=-=-=-=-=-=-=-=
STEP #2:
=-=-=-=-=-=-=-=-=-=

Unzip the OIA10.zip zip file you downloaded into which ever folder 
you like, we suggest "c:\oia10".

If you don't already have it download: 
http://OIA.mindflip.org/oia10.zip



=-=-=-=-=-=-=-=-=-=
STEP #3:
=-=-=-=-=-=-=-=-=-=

Run the following commands from the command line to install the 
necessary perl modules:

NOTE: To get to a command line click start then run then type
command in the box and hit enter.


ppm set confirm no
ppm install Net-AIM
ppm install Finance-YahooQuote
ppm set confirm yes



=-=-=-=-=-=-=-=-=-=
STEP #4:
=-=-=-=-=-=-=-=-=-=

Edit these files which, if you used our example dir above, are 
now located in the "c:\oia10\data" folder:

------------------------------------------
It is mandatory that you edit these files:
------------------------------------------
-----------------
name_and_pass.txt
-----------------
You should replace the example name and password with the 
name and password for your OIA.

-----------------
admins.txt
-----------------
You should replace the example admin name with the SN 
which you will use to admin the OIA.


------------------------------------
It is option, but you may also edit:
------------------------------------
-----------------
users.txt
-----------------
If you like, replace the example users with the SN's of people who 
you would like to be able to use your OIA even when it's closed.

-----------------
profile.txt
-----------------
If you like, replace the example profile with a customized one 
of your own.

-----------------
default_response.txt
-----------------
If you like, replace the example default response with one of 
your own.

-----------------
my_buddies.txt 
-----------------
If you like, replace the example buddies with your own buddies. 

-----------------
qanda.txt
-----------------
if you like, replace, edit or add to the example questions and 
answers with your own.

-----------------
oia_status.txt
-----------------
if you like, you can manually set the status of the OIA to 
open ( 0 ) or closed ( 1 ). this can be changed using the 
openOIA and closseOIA commands as admin.

-----------------
ban_buddies.txt
-----------------
if you like, replace the example buddies with any buddies you 
never want to be able to IM your OIA. 



=-=-=-=-=-=-=-=-=-=
Running the OIA
=-=-=-=-=-=-=-=-=-=

Now all you need to do to run your OIA is double-click on the 
oia.pl file located, using out example, in the c:\OIA dir.



END 7/24/02 - Orb
