tax report!
[freeside.git] / rt / README.Oracle
1 In order to install RT with Oracle, the database must first be
2 prepared.  Ports of RT to other databases will automatically create
3 the RT schema.  This is not done for Oracle because most sites wishing
4 to deploy RT on Oracle will have choose to make specific configuration
5 of the RT user, for example to select the appropriate tablespace or to
6 set up a resource profile.  The RT user must have appropriate
7 privileges similar to the resource and connect roles and must have the
8 "query rewrite" system privilege.
9   Here is an example of commands to create an RT user called "RT" with
10 a password of "rt".
11
12   create user rt identified by rt default tablespace users temporary
13     tablespace temp;
14   grant resource, connect, query rewrite to rt;
15
16
17 RT should not run its schema creation as the Oracle DBA; instead the
18 schema creation should be run as the RT user.  To accomplish this set
19 the --with-rt-dba configuration parameter to the RT user, not to the
20 Oracle DBA.  As an example, the following might be appropriate to
21 configure RT for the example.com Oracle database.
22
23   ./configure --prefix /usr/local/rt --with-db-type=Oracle \
24         --with-db-dba=rt --with-db-database=example.com \
25     --with-db-rt-user=rt \
26         --with-db-rt-pass=rt 
27
28
29 As with all databases it is important to analyze the Schema and get
30 current statistics after any significant dataset change.  Oracle's
31 cost-based optimizer can provide particularly bad performance when the
32 schema statistics are significantly inaccurate.  To analyze the schema
33 of a user called rt, execute the following from withing Sqlplus.
34
35   execute dbms_utility.analyze_schema( 'RT', 'estimate');
36
37