Upgrades

From DreamFactory
Jump to: navigation, search
(Notes and Prerequisites)
(Upgrade the System)
Line 12: Line 12:
  
 
== Upgrade the System ==
 
== Upgrade the System ==
 +
# Open the Git Shell
 
# Navigate to the install directory
 
# Navigate to the install directory
#* <source lang="bash">$ cd /opt/dreamfactory</source>
+
#* <source lang="bash">$ cd /c/Bitnami/dreamfactory-2.3.1-0/apps/dreamfactory/htdocs</source>
 
# Stash and changes tracked by git
 
# Stash and changes tracked by git
 
#* <source lang="bash">$ git stash</source>
 
#* <source lang="bash">$ git stash</source>
Line 20: Line 21:
 
#* <source lang="bash">$ git pull origin master</source>
 
#* <source lang="bash">$ git pull origin master</source>
 
# Update composer
 
# Update composer
#* <source lang="bash">$ composer self-update</source>
+
#* <source lang="bash">$ ../../../php/php composer.phar self-update</source>
 
# User composer to get dependencies
 
# User composer to get dependencies
#* '''Note for commercial users:''' Copy your commercial license files into the working directory before running this command.
+
#* '''Note for commercial users:''' Copy your commercial license files into the working directory (<code>C:\Bitnami\dreamfactory-2.3.1-0\apps\dreamfactory\htdocs\</code>) before running this command.
#* <source lang="bash">$ composer install --no-dev</source>
+
#* <source lang="bash">$ ../../../php/php composer.phar install --no-dev</source>
 
# Migrate the system data
 
# Migrate the system data
#* <source lang="bash">$ php artisan migrate --seed</source>
+
#* <source lang="bash">$ ../../../php/php artisan migrate --seed</source>
#* <source lang="bash">$ php artisan dreamfactory:service-type-migrate</source>
+
#* <source lang="bash">$ ../../../php/php artisan dreamfactory:service-type-migrate</source>
# Reset permissions
+
#* <source lang="bash">$ sudo chown -R www-data:dfuser storage/ bootstrap/cache/</source>
+
#* <source lang="bash">$ sudo chmod -R 2775 storage/ bootstrap/cache/</source>
+
 
# Clear caches
 
# Clear caches
#* <source lang="bash">$ php artisan config:clear</source>
+
#* <source lang="bash">$ ../../../php/php artisan config:clear</source>
#* <source lang="bash">$ php artisan cache:clear</source>
+
#* <source lang="bash">$ ../../../php/php artisan cache:clear</source>
 
# Log in to your instance in the browser (you may need to refresh/clear browser cache.) Go to the Config tab and confirm the instance was upgraded.
 
# Log in to your instance in the browser (you may need to refresh/clear browser cache.) Go to the Config tab and confirm the instance was upgraded.

Revision as of 16:58, 19 January 2017

Upgrading DreamFactory involves getting the required code via git and composer and then using the Laravel artisan command migrate system data and settings.

Notes and Prerequisites

  1. Windows users need to have Git shell for these procedures, such as Git for Windows
  2. In these instructions, we will assume that your instance is installed at C:\Bitnami\dreamfactory-2.3.1-0\ (/c/Bitnami/dreamfactory-2.3.1-0/ in the Git shell.) Anywhere you see this path substitute your own install path.
  3. PHP
    • You can add the path to your PHP executable to the system PATH variable to make calling your php easier.
      • The path is C:\Bitnami\dreamfactory-2.3.1-0\php\
    • These instructions will assume you have NOT done this and will instead include the full path to the executable (../../../php/php...)
    • If you have added PHP to the system PATH you may replace every instance of ../../../php/php with just php.

Upgrade the System

  1. Open the Git Shell
  2. Navigate to the install directory
    • $ cd /c/Bitnami/dreamfactory-2.3.1-0/apps/dreamfactory/htdocs
  3. Stash and changes tracked by git
    • $ git stash
  4. Get the latest code
    • $ git checkout master
    • $ git pull origin master
  5. Update composer
    • $ ../../../php/php composer.phar self-update
  6. User composer to get dependencies
    • Note for commercial users: Copy your commercial license files into the working directory (C:\Bitnami\dreamfactory-2.3.1-0\apps\dreamfactory\htdocs\) before running this command.
    • $ ../../../php/php composer.phar install --no-dev
  7. Migrate the system data
    • $ ../../../php/php artisan migrate --seed
    • $ ../../../php/php artisan dreamfactory:service-type-migrate
  8. Clear caches
    • $ ../../../php/php artisan config:clear
    • $ ../../../php/php artisan cache:clear
  9. Log in to your instance in the browser (you may need to refresh/clear browser cache.) Go to the Config tab and confirm the instance was upgraded.