RunningOnOracle

This is version 7. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

1. Create the Oracle Database schema account that will hold the default application tables. This can be done by your Oracle DBA. (You can choose a different user (schema) name and password, just modify the subsequent instructions accordingly.)

CREATE USER APPFUSE IDENTIFIED BY APPFUSE; GRANT CONNECT TO APPFUSE; GRANT RESOURCE TO APPFUSE;

1. Obtain the Oracle JDBC driver appropriate for your database and JDK version. (Oracle's license agreement will be shown just be downloading, make sure you read and understand it.)

NOTE: According to the Oracle JDBC Driver README , classes12.jar is for JDK1.2 & 1.3, ojdbc14.jar is for JDK 1.4. The instructions here assume you will be using ojdbc14.jar, modify the instructions below accordingly if otherwise.

1. In your {AppFuse home}/lib directory, add an "oracle" directory and place the ojdbc14.jar in it.

1. Next, the build.properties file needs to be updated to switch from a MySQL to an Oracle database. This can be done in two ways:

1. 1. If most of your work is in Oracle, update the build.properties file in the

1. 1. If most of your work is not in Oracle, you can ignore the build.properties file

Whether you edit one or both files, here is a idea of what the database entries should look like for Oracle (modify the various fields as appropriate for your system):

database.jar=${lib.dir}/oracle/ojdbc14.jar database.type=oracle database.name=appfuse database.host=localhost

hibernate.dialect=net.sf.hibernate.dialect.Oracle9Dialect database.driver_class=oracle.jdbc.driver.OracleDriver database.url=jdbc:oracle:thin:@localhost:1521:myDB database.username=appfuse database.password=appfuse

1. Run "ant new -Dapp.name=myappname -Ddb.name=appfuse" as normal to generate your new web application directory.

1. Reconfigure the build.properties file in the new "myappname" directory, following the instructions above. You will either need to update a few of the elements or all of them, depending on whether or not you decided to modify the main build.properties in the AppFuse distribution.

1. Run "ant setup" within your new web app directory to compile and deploy your new application on Tomcat.

1. Start tomcat and bring up the application: http://localhost:8080/myappname

NOTE: The Oracle database server may be configured to occupy port 8080 with its own servlet container. This may cause port conflicts if you are running Tomcat on the same machine. It is very difficult to turn off the Oracle container (I was not successful in doing so.) If you run into this problem, you may wish to shut off the Oracle instance, start Tomcat (so it will occupy port 8080), and then restart the Oracle database.

1. To test that database accesses are working properly, edit one of the profiles within the sample application and change the country listed. Then, within Oracle SQL*Plus, log in as "appfuse" user and issue this command:

select username, country from app_user;

If everything is working correctly, you should see that the country value has changed for the profile that you edited.