Creating a Smartsite-test26 Release

Creating the tag

1. Determine the name
   • Tag names are usually the base rsmart tag followed by an "a" and a number. So the first tag we create based on rsmart tag 2.6.2.8 would be rsmart_2.6.2.8_a1
2. Update sakai properties. The base properties are located in https://svn.ucdavis.edu/svn/ucd-sakai/sakai-properties/branches/rsmart-sakai-properties, update the version.service in local.properties.base
3. Run svn copy for main tag

   • svn copy https://svn.ucdavis.edu/svn/ucd-sakai/rsmart/trunk https://svn.ucdavis.edu/svn/ucd-sakai/rsmart/tags/rsmart_XYZ -m "Initial cut of tag rsmart_XYZ"

4. Run svn copy for properties tag

   • svn copy https://svn.ucdavis.edu/svn/ucd-sakai/sakai-properties/branches/rsmart-sakai-properties https://svn.ucdavis.edu/svn/ucd-sakai/sakai-properties/tags/rsmart_XYZ -m "Initial cut of tag rsmart_XYZ"

5. Run svn copy for patches tag

   • svn copy https://svn.ucdavis.edu/svn/ucd-sakai/patches/branches/rsmart_2-6-x/ https://svn.ucdavis.edu/svn/ucd-sakai/patches/tags/rsmart_XYZ -m "Initial cut of tag rsmart_XYZ"

6. Change externals
   • Run

     svn propedit svn:externals https://svn.ucdavis.edu/svn/ucd-sakai/rsmart/tags/rsmart_XYZ

     • Change src to point to proper rsmart tag
     • Change patches to point to proper patches tag
     • Add GB2 tag if necessary. The line will look like:

       gradebook2 https://source.sakaiproject.org/contrib/gradebook2/tags/1.2.0-a5/sakai-2.6.1

   • On commit, make the commit text reflect what the tag was created with.

Staging the Config Files

1. cd ~/config-staging
2. mv sakai.properties sakai.properties.previous
3. mv local.properties.base local.properties.base.previous
4. svn export https://svn.ucdavis.edu/svn/ucd-sakai/sakai-properties/tags/rsmart_XYZ/sakai.properties
5. svn export https://svn.ucdavis.edu/svn/ucd-sakai/sakai-properties/tags/rsmart_XYZ/local.properties.base

Building the Tag

1. cd src
2. Cleanup any old tags, we should retain the current tag plus one back
3. Checkout tag:

   svn co https://svn.ucdavis.edu/svn/ucd-sakai/rsmart/tags/rsmart_XYZ | tee ~/checkout.log

   • You will have to have the rsmart svn password. The user is ucdavis.
   • This will take awhile..
4. cd rsmart_XYZ
5. run configure script:

   scripts/cfg.pl

6. cd src/cle
7. Cleanout the tomcat staging directory, run:

   ~/config-staging/tomcatclean.sh

8. Check the build alias:
   1. alias mvnrsmart
   2. Check the -D options vs what you normally run. If its not up to date change ~/config-staging/aliases, ~/manual-test26-deploy/aliases, ~/.aliases
9. Build sakai run:

   mvnrsmart | tee ~/build.out

   • This will take awhile.
   • If anything goes wrong, you will need to troubleshoot the problem.

Deploying the Tag

1. Shutdown sakai

   ~/bin/stop.sh

   • Check that sakai is down by

     ps -ef | grep sakai| grep java

2. Stage tag:

   ~/config-staging/setup-sakai-node.sh

3. Start Sakai:

   1. cd $CATALINA_HOME/logs

   2. ~/bin/start.sh ; tail -f catalina.out

• Check the log as it starts

After Deployment Tasks

Once Sakai is started do the following:

1. Update the MOTD in the admin tool to reflect the current tag and gb version if applicable. Place any special notes(changes/patches to the code base) in the MOTD entry
2. Send email to ucd-sakai-dev@smartsite.ucdavis.edu, ucd-sakai-qaqc@smartsite.ucdavis.edu that a new tag is deployed.