Setting up InterSystems devstack - Appsembler

Help & How-to

Your comprehensive knowledge base for Open edX, Tahoe LMS, and Virtual Labs. Dive into in-depth documentation, tutorials, troubleshooting guides, and best practices to help with your integration of Appsembler's products.

Setting up InterSystems devstack

Setting up an ISC testing environment for Birch-based system

Bryan W ran into too many issues getting the ISC.git configuration to work, so we aren’t presently using all of the custom Vagrantfile/ansible configuration at
https://github.com/ISCLC/ISC/ (master). So for now (June 12, 2015), we are using the official Birch edx release for the Vagrant/VBox setup and configuration, not the github.com/Jazkarta/ISC setup.
As of September 21, 2015 ISC configuration is a directory under Appsembler’s configs repo. For the moment, use these two files to get the Ansible configuration extra vars and custom Python requirements:

server-vars.yml - https://github.com/noderabbit-team/edx-configs/blob/master/isc/dev/files/server-vars.yml
custom_requirements.txt - https://github.com/noderabbit-team/edx-configs/blob/master/isc/dev/files/custom_requirements.txt

Make sure you have the VBGuest plugin


vagrant plugin install vagrant-vbguest

Make a new directory for your Vagrant config and `cd` to it
Download the customized Devstack Vagrantfile from 


curl -L https://gist.github.com/bryanlandia/325c41474629d91e6d96 > Vagrantfile

Set an environment variable to specify that Vagrantfile downloads the box for Birch named release 
OPENEDX_RELEASE='named-release/birch.2'; export OPENEDX_RELEASE
I recommend setting an environment variable to use VBOX FS. 
VAGRANT_USE_VBOXFS='true'; export VAGRANT_USE_VBOXFS
Build your Vagrant/VBox vm with 
vagrant up
When this finishes 
vagrant ssh
Switch to our isc “fork” of edx-platform’s `named-release/birch.2` branch.  (I haven’t found a better way to do this yet) 
cd /edx/app/edxapp
rm -rf edx-platform
(you may have to  
sudo umount edx-platform
first)
Copy your server-vars.yml file to /edx/app/edx_ansible/server-vars.yml 
sudo chown edx-ansible:edx-ansible /edx/app/edx_ansible/server-vars.yml
Copy your custom_requirements.txt file to /edx/app/edxapp/custom_requirements.txt 
sudo chown edxapp:edxapp /edx/app/edxapp/custom_requirements.txt
Update the edx-platform repo from the server-vars file 
sudo /edx/bin/update edx-platform birch-learning-path
This should download the theme and create the `lms.env.json`, `lms.auth.json`, `cms.env.json`, and `cms.auth.json` files you need.  (Note the microsites are now a subfolder of the isc theme). However, as far as I can tell, the EDXAPP_ADDL_INSTALLED_APPS variable
in server-vars.yml does nothing.  Can’t find a default in the defaults.yml file for the edxapp role nor 
does a search through the configuration repo for that term yield any results. So…
Manually add to `/edx/app/edxapp/lms.env.json` and `/edx/app/edxapp/cms.env.json` files: 
"ADDL_INSTALLED_APPS": ["mentoring",
                        "edx_sga",
                        "edx_microsite_manager",
                        "launchcontainer", 
                        "flash"],
Start a server 
sudo su edxapp
source ~/edxapp_env
cd ./edx-platform
paver devstack lms