Upgrading

From ControlTier

These are the steps needed to upgrade to a new ControlTier point release.

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.6.1/pkgs/ctl-3.6.1/lib/extensions/commander/jars/core-seed-3.6.1.jar)
5. Load the new seed jar from the installer using either ProjectBuilder or Workbench for each project:
   • Option 1: ProjectBuilder: Run the load-library command:

     ctl -m ProjectBuilder -c load-library -- -jar /path/to/core-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. If you are using the elements library, also similarly load the new seed for that library (e.g. ControlTier-3.6.1/pkgs/ctl-3.6.1/lib/extensions/commander/jars/elements-seed-3.6.1.jar).
7. Replace the old seed in the WebDAV with the new one:

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

8. On all clients run ctl-project "install" action. Do it via ctl-exec:

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

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

v • d • e User Guide Introduction User Guide · ControlTier · Getting started · Architecture · Presentations · Screencasts Projects Projects overview · Creating a project · Bulk Node registration · View resources · View events Command execution Command execution · Running ad hoc commands · Running defined commands · Dispatcher options  · CTL Center · Creating jobs · Running jobs Examples Replace your SSH loop script  · Automate deployment with Jobs  · Automate deployment with ctl-exec · Scripters cookbook

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

v • d • e Modeler Guide Introduction Modeler Guide · Concepts · Modeler Getting started · Model-driven approach · CTL architecture · Model-driven command dispatching · File share Resource modeling Resource Model · Graphical resource editor · Graphical type editor · ProjectBuilder · Core Type Guide  · Type modeling · Attributes · Constraints Module development Module Development Guide · Modules · First type module · Workflow command · Command options Examples Creating packages · Mock Unix Service Example  · Mock Site Example  · Service Package Deployment Example  · Windows service  · Windows site  · Windows deployment · Builder Simple Example  · Continuous Deployment Example with Tomcat · Dukes Bank J2EE examples

v • d • e Reference Ant tasks Ant support · Command Dispatcher Tasks · Resource model Tasks  · Utility Tasks · Condition types · Ant types Command-line utilities ctl · ctl-archive · ctl-check · ctl-project · ctl-exec · ctl-extension · ctl-setup · install · server-setup · ctl-jobs · ctl-queue · ctl-run XML Acls-v10.xml · Job-v20.xml · Project-v10.xml · Type-v10.xml  · Aclpolicy APIs Reportcenter Query API · ctl-dispatch · commander · common