Oracle DB

From DreamFactory
Jump to: navigation, search
(Manual Install from Github on Linux)
m (Changed a typo in php5-fpm restart command.)
Line 61: Line 61:
 
*Restart your web service service
 
*Restart your web service service
 
**<source lang=bash>$ sudo service apache2 restart</source>  or
 
**<source lang=bash>$ sudo service apache2 restart</source>  or
**<source lang=bash>$ sudo service php5-fmp restart && sudo service nginx restart</source>
+
**<source lang=bash>$ sudo service php5-fpm restart && sudo service nginx restart</source>

Revision as of 16:48, 7 June 2016

Drivers

Bitnami Windows Install

Note: These instructions are applicable for DreamFactory 2.1.0-4 and older. Starting in DreamFactory 2.1.1 you will need to use Oracle Instant Client 12

  • Download the Oracle Instant Client here
    • You will need to download the appropriate version for your version of Oracle (i.e Instant Client 11 goes with Oracle 11g server.)
    • Since the Windows Bitnami stack is only 32-bit you need to download the 32-bit instant client
    • You will also need an Oracle login for this (free registration.)
  • Extract the zip file to your preferred location, such as C:\instantclient_11_2
  • Edit the php.ini file (C:\Bitnami\dreamfactory-x.x.x-x\php\php.ini)
    • Uncomment (remove the semicolon) from the line that says
      ;extension=php_oci8_11g.dll
    • For Oracle Instant Client 12, the line will be denoted with a comment indicating it requires uncommenting
      ;extension=php_oci8_12c.dll  ; Use with Oracle Database 12c Instant Client
  • Edit your PATH variable.
    • Go to Control Panel->System->Advanced System Settings
    • Click on Environment Variables
    • Under System variables, double click on Path.
    • At the end of the Variable value, add the path to the instant client directory (see above.) Use a semicolon to separate this new entry from the current last entry.
      ;C:\instantclient_11_2
  • Restart the system

Linux

Bitnami Linux Install

Note: These instructions are applicable for DreamFactory 2.1.0-4 and older. Starting in DreamFactory 2.1.1 you will need to use Oracle Instant Client 12

  • Download the Oracle Instant Client here
    • You will need to download the appropriate version for your version of Oracle (i.e Instant Client 11 goes with Oracle 11g server.)
    • You will also need an Oracle login for this (free registration.)
  • Extract the zip file to your preferred location, such as ~/instantclient_11_2
  • Edit the php.ini file (~/dreamfactory-x.x.x-x/php/php.ini)
    • Uncomment (remove the semicolon) from the line that says
      ;extension=oci8.so
  • Edit the setenv.sh file ( ~/dreamfactory-2.0.2-0/scripts/build-setenv.sh )
    • Add the following to the end of the file, just before the line that says . /home/user/dreamfactory-2.0.2-0/scripts/build-setenv.sh
LD_LIBRARY_PATH=/home/bitnami/instantclient_11_2:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH

Manual Install from Github on Linux

These instructions are Ubuntu/Debian based
Note: If you are use a newer version of the Instant Client you will want to modify these instructions accordingly (for example instant_client_12_1)

  • Download the Oracle Instant Client here
    • Get both the basic client and the sdk (two files)
    • You will need to download the appropriate version for your version of Oracle (i.e Instant Client 11 goes with Oracle 11g server.)
    • You will also need an Oracle login for this (free registration.)
  • Extract the instant client basic zip file to your preferred location, such as /opt/instantclient_11_2
  • Extract the sdk zip to the same location. There should be a sdk folder inside the main instantclient_11_2 folder
  • Make a symlink from libclntsh.so.11.1 to libclntsh.so
    • $ sudo ln -s /opt/instantclient_11_2/libclntsh.so.11.1 /opt/instantclient_11_2/libclntsh.so
  • Ensure that you have the php-pear and php5-dev packages installed on your system
    • $ sudo apt-get install php-pear php5-dev
  • Use PECL to install the oci8 so file.
    • If using php 5.5 or 5.6:
    • $ sudo pecl install oci8-2.0.11
    • if using php 7:
    • $ sudo pecl install oci8
    • You will be asked for the type of install and location of library. Use instantclient and the location where you extracted the files above. ex: "instantclient,/opt/instantclient_11_2"
    • If the the install generates any errors it will fail you. You will need to troubleshoot based on the error reported.
  • Create a module file for your oci8 installation.
    • $ sudo touch /etc/php5/mods-available/oci8.ini
  • Edit the file you just created in your preferred text editor.
    • There is a single line in the file it looks like this:
    • extension=oci8.so
  • Enable the php extension
    • $ sudo php5enmod oci8
  • Restart your web service service
    • $ sudo service apache2 restart
      or
    • $ sudo service php5-fpm restart && sudo service nginx restart