mkauffman

Upgrade Your DVM

Blog Post created by mkauffman on Dec 28, 2016

Scott Hurrey mentioned this the other day during our Technical Office hours... You can upgrade a 3000.x DVM using the same installer package that you use for a self-hosted system. This blog post will show you how easy that is, after a brief plug for our office hours. If you've not attended, office hours a great way to get answers to your questions and to network with other developers. The schedule is at the bottom of the page here: Blackboard Learn Developers

 

Here's what you do to upgrade your DVM. You will do all of your work as the vagrant user. Do not use root or bbuser.

  1. Stop Learn
  2. Download the installer for the version you want to upgrade to from Behind the Blackboard. Note this only works for Q2 2016 and later.
    1. For this example, I upgraded my DVM from 3000.1.1 to 3000.1.3 (Q2 2016 CU1 to Q2 2016 CU3)
  3. As the vagrant user, create the recommended installation directories.
    1. mkdir /usr/local/bbinstaller
    2. mkdir /usr/local/bbinstaller/3000_1_3/
  4. Create an installer.properties file. I've placed the full text for one that works for a DVM below.
    1. Place the installer.properties file in the /usr/local/bbinstaller directory.
  5. Make a copy of the license file. You MUST do this because the install will mess everything up if the installer.properties is pointing to a license file inside the blackboard directory that is being upgraded.
    1. cp /usr/local/blackboard/config/license/blackboard-license.xml /usr/local/blackboard-license-copy.xml
    2. chown vagrant /usr/local/blackboard-license-copy.xml
  6. Move the downloaded .zip installer file to the /usr/local/bbinstaller/3000_1_3/ directory
    1. The trick here is that on the DVM the /vagrant directory is the same directory as the host directory where you ran the vagrant up and vagrant ssh command. You place the .zip installer file into that directory, then on the DVM guest you can move it from into the installation directory.
  7. cd /usr/local/bbinstaller/3000_1_3/
  8. unzip learn-installer-3000.1.3-rel.70+214db31.zip
  9. Run the upgrade
    1. ./installer.sh -c /usr/local/bbinstaller/installer.properties
  10. Run PushConfig, which will also start the server.
      1. cd /usr/local/blackboard/tools/admin
      2. ./PushConfigUpdates.sh

 

That's it! Below are the contents of the installer.properties file that works for upgrading a DVM:

 

# DVM installer.properties for upgrade. First attempt was from Q2 2016 CU1 to CU3.

# Kauffman 2016.12.28

bbconfig.basedir=/usr/local/blackboard

bbconfig.java.home=/usr/lib/jvm/java-8-oracle

 

# cp /usr/local/blackboard/config/license/blackboard-license.xml /usr/local/blackboard-license-copy.xml

# chown bbuser /usr/local/blackboard-license-copy.xml

bbconfig.file.license=/usr/local/blackboard-license-copy.xml

 

##         these properties should not be modified manually        ##

antargs.default.vi.db.name=BBLEARN

antargs.default.vi.stats.db.name=BBLEARN_stats

 

# just like the Windows upgrade, the Linux upgrade fails if you don't have these 3 dummy antarg lines

antargs.default.users.administrator.password=passworddoesnotmatter

antargs.default.users.integration.password=passworddoesnotmatter

antargs.default.users.rootadmin.password=passworddoesnotmatter

 

############## properties listed here can be modified ###############

antargs.default.vi.db.password=postgres

antargs.default.vi.stats.db.password=postgres

antargs.default.vi.report.user.password=password

Outcomes