SynApp2 Installation - Oracle

    Short Instructions - Oracle Database 10g Express Edition (only)

        Recursively copy (untar or unzip) the SynApp2 distribution files onto your web server
        Un-comment (delete the 2 slashes at the start of) the line in: '_config_/engine.inc.php' - e.g. $engine = ENGINE_OCI;
        Point your browser to: http://<host>/synapp2/
        Login [with a valid Oracle Database Login Username]
            The SynApp2 welcome page appears.

    Detailed Instructions

        Verify that your web server, PHP and Oracle are up and running.
        Verify that PHP safe mode is: off
        Create a SynApp2 applications directory on your development server.
            The result should be:
                <host>/synapp2/
        Verify that your web server process has write access to: <host>/synapp2/
        Recursively copy (untar or unzip) 'index.html' and the directories: '_config_', '_shared_' and 'synapp2' (to the SynApp2 applications directory).
            You should then have:
                <host>/synapp2/index.html
                <host>/synapp2/_config_
                <host>/synapp2/_shared_
                <host>/synapp2/synapp2
        Enable Oracle as the database engine.
            Un-comment (delete the 2 slashes at the start of) the line in: '_config_/engine.inc.php' - e.g. $engine = ENGINE_OCI;
        Only the Oracle Database 10g Express Edition has been tried.
            To work with a different instance, you will likely need to modify the
            service name in the following line (look in '_shared_/dbx.php'),
            by replacing 'XE' with a value that works for you. Check 'tnsnames.ora' on your server for clues.
                @oci_connect($u, $p, "{$h}/XE"))) // TODO: Express Edition only!
        (It seems we used some php5 oci function names, so you'll need to change some names in dbx.php if you're running php4. Error messages will guide you. Sorry about that.)
        Point your browser to: http://<host>/synapp2/
            The SynApp2 login invitation appears.
        Login [with a valid Oracle Database Login Username]
            The SynApp2 welcome page appears.

Troubleshooting

    If you cannot login:
        Do you have an Oracle Database Login Username (and associated schema)?
            Make one or get one.
        Append: &show_response=1 to the login URL (causing the page to reload).
            http://<host>/synapp2/_shared_/login.htm?appid=synapp2&show_response=1
        Examine the <debug_msg> elements (in the pop-up window) for clues.
    If you're still having difficulty:
        Stop.
        Browse or search the SynApp2 Support Forums: http://www.synapp2.org/forum
            If you can't find an answer, register and post a question.

Copyright (c) 2007 - 2009 Richard Howell. All rights reserved.
http://www.synapp2.org
$Id: synapp2.install.Oracle.txt,v 1.1 2009/08/27 22:51:32 richard Exp $