Upgrading Dreamfactory within Gold

Upgrade Procedure

Once you're in your DreamFactory Gold instance, you'll need access to /var/www/launchpad.

First, we will upgrade the DreamFactory "Base" installation for all of your Gold instances. Navigate to /var/www/launchpad

1. • If you're updating to the latest version, you'll checkout the master tag. If you're moving to a specific version number, you'll checkout that version number as the tag.

   • $ git checkout master

   • If you have unsaved changes, you'll receive a message indicating which files have changes in them. You will need to stash the changes.
     • You must do this step BEFORE checkout if you have made changes to or replaced any files in the main DreamFactory repo (such as changes to composer.json.)

     • $ git stash

     • Repeat the checkout step.
2. Pull the latest from git (again, using the appropriate tag -- master or version number).

   • $ git pull origin master

   • $ sudo chmod -R 2775 storage/ bootstrap/cache/

3. Use Composer to update all the vendor repos.

   • $ composer install --no-dev

4. Migrate the database.

   • $ php artisan migrate --seed

5. If upgrading from DreamFactory 2.0 or 2.1 to DreamFactory 2.2 or higher, migrate the old service types to the new ones (add the --pretend option to see what it will change).

   • $ php artisan dreamfactory:service-type-migrate

6. Clear the application cache.

   • $ php artisan cache:clear

Now that the base launchpad directory has been upgraded, you still will need to perform some of these actions on your DreamFactory instances. This is done by a process we call "encapsulation". It basically mounts an individual instance to a temporary location so you can perform actions from the shell on it.
Now change your directory to /var/www/console

$ cd /var/www/console

Create the encapsulation

$ sudo php artisan dfe:capsule <instance-name>

You will receive a directory location based on your Gold install setup to navigate to. This is the encapu