Skip to content
This repository was archived by the owner on Nov 25, 2020. It is now read-only.

Installation & Upgrading

Jump to bottom
maxfierke edited this page Jan 18, 2013 · 13 revisions

Deployment on a Local, VPS, Cloud, or Dedicated host

Installation

  1. Run php app/check.php and resolve any errors before doing ANYTHING else.
  2. Run app/config/parameters.yml.dist app/config/parameters.yml
    • app.name holds the application branding that is displayed to the user. You can change it to anything. E.g. CSOM ITSS sets this to "Lab Scheduler".
    • admin_email is the email address of the default admin account. This address should be set to whatever the email address of who ever the admin will be (probably you).
    • secret is used for CSRF validation. Set this to some random characters. An ideal value would be a random sha256 hash.
  3. Run php composer.phar install
  4. Run php app/console doctrine:database:create
  5. Run php app/console doctrine:migrations:diff to diff the current database.
  6. Run php app/console doctrine:migrations:migrate to update database schema to current schema with mapping and everything.
  7. Run php app/console doctrine:fixtures:load to bootstrap the application with some needed information (groups) and a default admin account with the username admin and the password admin.
  8. Navigate to the OpenSkedge installation in a browser, login as the bootstrapped admin and change the password.
  9. Add employees, areas, positions, and schedule periods and get to scheduling!

Upgrading

  1. Run git pull to fetch the latest changes to OpenSkedge. If you've made changes to OpenSkedge, you'll either want to stash them or commit them and use git pull --rebase.
  2. Run php composer.phar update
  3. Run php app/console doctrine:migrations:diff to diff the current database schema with the schema defined by the latest version of OpenSkedge.
  4. Run by using php app/console doctrine:migrations:migrate. NOTE: This should be pretty safe but if issues occur, you should be able to roll back by migrating down. That said, it's probably best to test the migration on your development server before pushing it to production. Read more about using migrations at the Doctrine project's docs.

Deployment on Pagoda Box

Pagoda Box is a PaaS provider that allows the creation of scalable instances of web applications.

OpenSkedge supports the use of the PaaS provider Pagoda Box and I have included a Boxfile and a Boxfile.install for the creation of OpenSkedge instances.

Due Pagoda Box's read-only nature, there are few environmental variables that need to be set:

SYMFONY__BRANDING__NAME should contain the desired name for the application branding. (Default: "OpenSkedge") SYMFONY__ADMIN__EMAIL should contain the email address of the default administrative user (Default: "[email protected]")

parameters:secret is set to an insecure secret. This needs to be changed. secret is used for CSRF validation. Set this to some random characters. An ideal value would be a random sha256 hash. Edit the app/config/parameters.yml file in your Pagoda Box application repository.

Suggested Reading for more information: http://help.pagodabox.com/customer/portal/articles/175128-symfony2

Clone this wiki locally