![]() | Oracle support for FishEye/Crucible and Crucible was introduced in version 2.5.0. In order to migrate to Oracle, your instance must be currently running at least version 2.5. If you are running an older version, then you will be required to first upgrade FishEye/Crucible and then migrate. |
On this page:
Step 1. Install and Create a Oracle Database
- The JDBC drivers for Oracle are bundled with FishEye/Crucible. Skip to step 2 if this meets your needs. If you want to install a specific, different version of the bundled JDBC driver, download the download the Oracle JDBC driver
.jar
file from the Oracle website (hhttp://www.oracle.com/technetwork/database/features/jdbc/index-091264.html) and copy the.jar
file to yourFISHEYE_INST/lib
directory (create thelib/
directory if it doesn't already exist). Move the existing JDBC.jar
file to another location (and back it up). Restart FishEye/Crucible to have it pick up the new driver. - Because creating a database with Oracle is a complex process, we recommend speaking to your resident DBA for creation of a new database for usage with Crucible. We highly recommend installing Oracle with the
AL32UTF8
encoding otherwise you may see encoding issues in the product.
Step 2. Configure FishEye/Crucible to use Oracle, and Migrate Data
In order to migrate to a different database backend, you must create a backup of sql data, configure the database and finally import the data via a backup restoration process. This can be done from either the FishEye/Crucible administration console, which streamlines the process, or via the command line tool which FishEye/Crucible provides.
From FishEye/Crucible's Administration
- Navigate to the
Database
page in FishEye/Crucible's Administration console - Then click 'Test Connection' to verify that FishEye/Crucible can log in to the database:
- Select
Oracle
from the database type - Fill in the appropriate fields, replacing the host, port, database name, username and password as required
- Click on
Test Connection
to validate the values
Screenshot: Testing the Connection
If this fails, verify that you have the Oracle JDBC driver.jar
file in the classpath (by placing the.jar
file inFISHEYE_INST/lib
). Also, ensure that the database user can log in to the database from the machine that FishEye/Crucible is running on and that all the required privileges are present. - Click 'Save & Migrate Data' to start the migration process.
During the migration process (which will take several minutes, depending on the size of your database and network throughput), the product will be inaccessible to users and external API clients. Users will see a maintenance screen that informs them of the process. Should the migration fail for any reason, FishEye/Crucible will not switch to the new database and report on the encountered problems. Because the destination database may now contain some, but not yet all data, drop all tables, indexes and constraints before attempting a new migration.
Screenshot: Migrating the Database
From the command line
- Create a backup of the
sql
data from the FishEye/Crucible instance. Information on how to create a backup can be found at Backing Up and Restoring FishEye Data \ Backing Up and Restoring Crucible Data Run the following command from the
bin
directory inFISHEYE_INST
$ ./fisheyectl.sh restore --sql \ --file /path/to/backup.zip \ --dbtype oracle \ --jdbcurl jdbc:oracle:thin:@hostname:port:dbname \ --username crucible \ --password password
- When the import is complete, FishEye/Crucible can be started and will use Oracle.