RT#42393: Verification cust_pay_pending handling in history & report
[freeside.git] / rt / README.Oracle
1 On RT 3.8.2 and later, RT deployment for Oracle databases is very
2 straightforward.
3
4 You don't need to configure Oracle beforehand. During installation
5 a user is created and all RT's objects are created in his schema.
6 The user is created with the following parameters:
7
8     CREATE USER <DatabaseUser> IDENTIFIED BY <DatabasePassword>
9         DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP
10         QUOTA UNLIMITED ON USERS
11
12 And the user is also granted 'CONNECT' and 'RESOURCE'. It's up to you
13 to do decide how to manage users, change quotas, table spaces, etc.
14
15 RT has an option $DatabaseName which is used to define the SID of
16 the Oracle database. You don't have to set up the TWO_TASK environment
17 variable or any helper files for establishing connections.
18
19 Example:
20
21     ./configure \
22         --with-db-type=Oracle \
23         --with-db-database=XE \
24         --with-db-host=192.168.0.1 \
25         --with-db-dba=system \
26         --with-db-rt-user=rtdb1 \
27         --with-db-rt-pass=rtdb1secret \
28         ... other configure options ...
29
30 That should be enough to get you started on Oracle, but to complete
31 installation you must follow the general instructions in the README file.
32
33 As with all databases it is important to analyze the schema and get
34 current statistics after every significant dataset change.  Oracle's
35 cost-based optimizer can provide particularly bad performance when the
36 schema statistics are inaccurate.  To analyze the schema of the user
37 called RT, execute the following from within sqlplus:
38
39   execute dbms_utility.analyze_schema( 'RT', 'estimate');
40