By using Oracle you can benefit from features in Oracle infrastructure such as backup, restore and high availability.
For Artifactory to run with Oracle you must create a dedicated Oracle database instance and then configure Artifactory to use it as described in the following sections.
Before You Continue
Before proceeding with the steps below, please make sure you have read and followed the steps described in Configuring the Database.
Upgrading the Database?
To avoid a regression of performance while upgrading the Oracle database (as a result of changes in the execution plans), make sure to preserve the optimizer's behavior from the previous version. For more details, please refer to Oracle documentation on Influencing the Optimizer.
Creating the Artifactory Oracle Database
Supported Oracle Versions
Artifactory supports Oracle v10g and above.
You can choose between two configurations to set up your Oracle Database
ilesystemThis configuration stores metadata in Oracle Database and artifact binary data is stored on the file system (under
$ARTIFACTORY_HOME/data/filestore). This option has the advantage of being very lightweight on the Oracle database.
Full DBThis configuration stores both metadata and BLOBs in Oracle Database. This option requires minimal maintenance and allows you to rely solely on Oracle for failover and backup procedures, since all data is in the database.
When using this option, make sure you have created a table space big enough to accommodate your binaries.
Artifactory creates all tables automatically first time it is run. When performing a software upgrade Artifactory may have to alter tables and indices, so make sure you grant the configured connection the appropriate user permissions to perform such actions.
With both of the above options (
Full DB and DB-Filesystem), it is recommended to create a dedicated table space and use
Reclaiming BLOB space
For efficiency, Artifactory uses a checksum to ensure that only one copy of any binary data is stored, however, you may want to reclaim deleted BLOB space from time to time by shrinking the BLOB table space as follows:
Configuring Artifactory to use Oracle
$ARTIFACTORY_HOME/etc/db.properties(If you do not have this file you can take it from the standalone zip distribution or directly from the JFrog domain). For a full explanation on the contents of this file please refer to The Bundled Storage Configurations.
- Adjust the connection definitions in the
$ARTIFACTORY_HOME/etc/db.propertiesfile to match the attributes of the Artifactory database you created.
You must configure the database URL and username/password to use. The schema and tables are created first time Artifactory is run using the new database.
Download the JDBC driver corresponding to your Oracle version from the JDBC/UCP Download Page and copy the
ojdbc6.jarfile into the server's shared lib directory.
$TOMCAT_HOME/libwhen installed as a service or
$ARTIFACTORY_HOME/tomcat/libin the standalone version.
Make sure your driver has the same permissions as the rest of the files in the shared lib directory.
- Start Artifactory.