Creating and Deploying a SmartSite Test26 Release

Creating a Smartsite-test26 Release

Creating the tag

Please make sure any changes are done to the patch area before a tag is created

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
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

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"

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"

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"

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.

The next two steps need to occur on the headnode of the cluster as the deploy user

Staging the Config Files

The cfg.pl script in the building section needs the properties file to be available so this section should be done first

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

Building the Tag

cd src
Cleanup any old tags, we should retain the current tag plus one back
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..
cd rsmart_XYZ
run configure script:
```
 scripts/cfg.pl 
```
cd src/cle
Cleanout the tomcat staging directory, run:
```
~/config-staging/tomcatclean.sh
```
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
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

This should be run on each node from the headnode to each of the other nodes

Shutdown sakai

 ~/bin/stop.sh

Check that sakai is down by
```
 ps -ef | grep sakai| grep java 
```

Stage tag:
```
~/config-staging/setup-sakai-node.sh
```

Start Sakai:

```
 cd $CATALINA_HOME/logs 
```
```
~/bin/start.sh ; tail -f catalina.out
```

Check the log as it starts

After Deployment Tasks

Once Sakai is started do the following:

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
Send email to ucd-sakai-dev@smartsite.ucdavis.edu, ucd-sakai-qaqc@smartsite.ucdavis.edu that a new tag is deployed.