        OBSERVATION MANAGER 1.321
=========================================== 
    http://observation.sourceforge.net/

A) Licence     
ObservationManager is distributed under the
Apache Software Licence 2.0. Please
see LICENSE-2.0.txt for details.            

B) Authors
Please see CREDITS file for authors

C) Legal issues and acknowledgments
Please see NOTICE.txt file
 
D) OSI
This software is OSI Certified Open Source Software.
OSI Certified is a certification mark of the Open Source Initiative.

    
1) Requirements
---------------------
ObservationManager can run on all operating 
systems that provide a Java Runtime 
Environment Version 1.4 or higher (1.6 or higher is recommended).
ObservationManager is tested from us on
- Linux (Mandrake, SuSE)
- Microsoft Windows 7
both with Suns Java Runtime Environment 1.4, 1.5 (5.0), 1.6 (6.0) and 7.

Getting the Java Runtime Environment 7:
Please goto:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Download:
Java Runtime Environment (JRE) 7 <latest update>


2) Installation with all available extensions (ONE BIG FILE)
---------------------------------------------
- Download the observationManager{VERSION}-complete.zip
file from the projects page. (Package: ObservationManager_All_In_One)
- Unpack the observationManager{VERSION}-complete.zip 
file. 

That's it. This will install Observation Manager
with the following extensions:
- Solar System
- DeepSky
- Variable Stars
- Imaging
- Skychart/Cartes du Ciel


3) Installation using extensions (SEVERAL SMALL FILES)
---------------------------------------------
If you've already performed an installation in 
step 2, you should NOT do this step, too.
If you've downloaded and unpacked the 
observationManager{VERSION}-complete.zip file, 
(step 2) you've already all extensions installed.

This installation procedure here is intended for users
that do NOT want to make use of ALL extensions listed
in step 2.

- Download the observationManager{VERSION}.zip 
file from the projects page. (Package: ObservationManager)
- Unpack the observationManager{VERSION}.zip file

This was your base installation. You could
already run Observation Manager with that. However
until now, you're not having any extension installed.
Here's how you install extensions:
- Download all desired extensions from the project page
(Package(s): ObservationManager_Ext_{SOMETHING}
The downloaded files will be named e.g.:
extDeepSky0.8.ome, extSolarSystem0.8.ome  or something
like that)
- Start Observation Manager
- Goto Menu "Extensions"->"Install"
- Select the downloaded extensions and click OK
- After successful extension installation a restart of Observation Manager 
  is required


4) Starting
---------------------
- WINDOWS:
Goto folder /observationManager and call obs.bat
- LINUX:
Goto folder /observationManager and call obs.sh (requires execute permissions)
- MAC:
Goto folder /observationManager and call obs.command (requires execute permissions)
or 
Goto folder /observationManager and unzip the file obs4Mac.zip
This will create an application called obs in the /observationManager
folder which can be executed by double-click



5) Configuration File
---------------------
With 0.415 we introduced a small persistent configuration file for
Observation Manager. By default this file gets stored in the 
users home directory.
- WINDOWS (default):
C:\Documents and Settings\{USERNAME}\.observationManager\config
- UNIX/LINUX (default):
~/.observationManager/config

If you want to store/load the configfile from a different location,
please pass the following startup parameters:
obs.bat "config={SOMEHWHERE}"  (Windows)   (MIND THE QUOTES!)
obs.sh config={SOMEHWHERE}   (Linux)


6) Troubleshooting
---------------------
If you run into problems, please contact us via 
the projects page.
Please send a detailed description, containing 
the problem, your OM Version, OS, Java Version.
Also if you're running into some Java exceptions
please attach the corresponding log file to your 
message. The log file can be found at:
{YOUR_INSTALL_PATH}/observationManager/log


7) Version
---------------------
The ObservationManager version number is a 
combination of the application version 
itself (e.g.) 0.9 and the version of the 
used OAL XML schema (e.g. 2.1).
The the first part reflects the OM application
version, while the second part reflects the
contained XML version.

8) Log file
---------------------
Since version 1.020 Observation Manager will store its log file
in the users home directory.
- WINDOWS (default):
C:\Documents and Settings\{USERNAME}\.observationManager\log\obs.log
- UNIX/LINUX (default):
~/.observationManager/log/obs.log

If you want to store the log file in a different location,
please pass the following startup parameters:
obs.bat "log={SOMEHWHERE}"  (Windows)   (MIND THE QUOTES!)
obs.sh log={SOMEHWHERE}   (Linux)