Upgrading

From ControlTier

These are the steps needed to upgrade to a new ControlTier point release, for example from 3.4.6 to 3.4.8.

This will not work if you are upgrading major versions. This procedure is for point releases only.

Upgrade procedure

1. Shut down all ControlTier processes. Things will break if you do not shut all the processes down.
   • Make sure there are no ctl commands running on the clients
   • Shut down the server: jetty.sh stop
2. Run the installer against both server and clients.
3. Start the server. Watch the logs and make sure the server started properly. You can also use jetty.sh check (Check status)
4. Locate the controltier-seed.jar archive from the installer directory: (e.g. ControlTier-3.4.5/pkgs/ctl-1.4.5/lib/extensions/commander/jars/controltier-seed-3.4.5.jar)
5. Load the new seed jar from the installer using either ProjectBuilder or Workbench into each project:
   • Option 1: ProjectBuilder: Run the load-library command:

     ctl -m ProjectBuilder -c load-library -- -jar /path/to/controltier-seed-3.x.x.jar

     OR
   • Option 2: Workbench: Go to the Admin page (eg, http://strongbad:8080/itnav/do/menu/Admin) and press the "Import Seed" button and upload the jar file. Check the box "Restage all submodules of imported modules after import".
6. Replace the old seed in the WebDAV with the new one:

   ctl -p anyProject -m davutil -c put -- -file /path/to/controltier-seed-3.x.x.jar -overwrite -url dav://seeds/controltier-seed.jar

7. On all clients run ctl-depot "install" action. Do it via ctl-exec:

   • ctl-exec -p project -- ctl-depot -p project -a install

   • Optionally, you can do a clean re-creation of the CTL depots running through ctl-depot (remove, create, install) to get a new baseline.

v • d • e User Guide Introduction ControlTier · Getting started · Architecture · Concepts · Presentations · Screencasts Projects Projects overview · Creating a project · ProjectBuilder · Bulk Node registration Command dispatcher About · Running scripts · Running defined commands  · Dispatcher options · Creating jobs · Scripters cookbook Packages Creating packages · WebDAV · Dav:// prefix · Davutil Event logging Reportcenter Resource model About · Graphical resource editor · Type modeling · Graphical type editor · Attributes · Constraints · Type-v10.xml · Core Type Guide Workflows Workflow Development Guide · First type module

v • d • e Installation Requirements System requirements · Supported browsers · Dependencies · Environment Installers Download · RPM installers · ZIP installer · Graphical installer · Windows installation · Upgrading · Migration Configuration Authorization · SSH configuration · Managing users Server Startup and shutdown · Logs · Server landing page

v • d • e Examples Scripting Replace your SSH loop script  · Scripted appserver war deployment example Services Mock Unix Service Example  · Mock Site Example  · Service Package Deployment Example  · Windows service  · Windows site  · Windows deployment Builders Builder Simple Example  · Continuous Deployment Example with Tomcat J2EE Dukes Bank J2EE examples

v • d • e Reference Ant Tasks · Types Command-line utilities ctl · ctl-archive · ctl-check · ctl-depot · ctl-exec · ctl-extension · ctl-setup · install · server-setup XML Acls-v10.xml · Job-v10.xml · Project-v10.xml · Type-v10.xml APIs Reportcenter Query API · ctl-dispatch · common