Creating a project

From ControlTier

This page describes how to create a ControlTier project. A project is a logical group of nodes, packages, services, and processes that interact with one another.

ControlTier server setup

Option 1: Create a project via Workbench

Login to Workbench.

Go to the Admin page and push the "Create Project" button.

This will bring you to the create project form:

Fill in the form, giving the project name and description. Note, do not use spaces for the project name.

Push the "Create" button and you will be redirected to the progress page:

Once the project is created the browser will direct you to the home page.

Option 2: Create a project via the command line

On the ControlTier server, run ctl-project "create" action to create the project (substituting "MyProject" with your new project name) :

ctl-project -p MyProject -a create

As projects have become obsolete, in 3.6.0 this becomes:

ctl-project -p MyProject -a create

Running the ctl-project create action on the server will create the project, ensure the CTL depot for the new project has been initialized, and register the admin host to the new project.

Note:

• This command might take a while to complete due to the project being created and initialized and can take 3-10 minutes depending on the speed of the server processor(s). See the next section #Confirming_the_completion_in_the_log to watch the progress in the log file.

Confirming the completion in the log

You can view the progress by watching the "$JETTY_HOME/logs/workbench.log" file (see ControlTier server logs).

.
.
.
2009-03-27 14:57:46,834 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Begin: project creation: MyProject
2009-03-27 14:57:46,835 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Begin: project model initialization: MyProject
2009-03-27 14:57:47,006 [Thread-46] INFO  com.controltier.log.common - Create new Project: MyProject
2009-03-27 14:57:47,012 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Done: project model initialization: MyProject
2009-03-27 14:57:47,012 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Begin: extract seed archive: MyProject
2009-03-27 14:57:47,118 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Done: extract seed archive: MyProject
2009-03-27 14:57:47,124 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Begin: install seed archive: MyProject
2009-03-27 14:59:14,986 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Begin: stage all modules: MyProject
2009-03-27 14:59:18,682 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Done: stage all modules: MyProject
2009-03-27 14:59:18,682 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Done: install seed archive: MyProject
2009-03-27 14:59:18,683 [Thread-46] WARN  com.networkgps.itnav.projects.Store - Done: project creation: MyProject

Watch for the final messages to confirm the project is done being created and populated: "Done: project creation: MyProject".

ControlTier client setup

On each of the clients where you want run commands for a given project use ctl-project. The ctl-project command will setup that client to have a local project workspace where modules and resource data are maintained. The command will also register that client as a Node to the project.

The basic command usage is this: ctl-project -p <project> -a create

Here's an example that sets up this client for the "MyProject" project:

ctl-project -p MyProject -a create

• If you have many hosts to register see: Bulk Node registration.

When the client registers itself in the specified project, you will see it show up as a new Node in the Node Manager UI of Workbench. Also, on the server using ctl-exec you can list information for a registered node:

ctl-exec -p <project> -v -I <client host>

Here's an example that lists the info for the node, centos2, in the project "demo":

ctl-exec -p demo -v -I centos2
centos:
   hostname: centos2
   os-arch: i386
   os-family: unix
   os-name: Linux
   os-version: 2.6.9-34.EL
   tags: []

See more about using ctl-exec to list node info here: ctl-exec listing mode.