Changing promotion level / state by command line

Promoting files and threads

There are occasionally situations where users may wish to promote a version of a file to a different blessing. The following command will do that...

# razor -c promote -f <file> -v <ver> -s <state> \
-g <group> [[-i <issue>[:<issue group]>] ...]

<state> is the new state you want to promote to. Threads may also be promoted via the command line. The only difference between file promotions and thread promotions is that the group name must have "##Threads" appended to its name.

It is also possible to associate any number of issues to the above activity. To do so, simply put "-i <issue[:<issue group>]>" flag pairs onto the command line. The <issue> can be in either its fully annotated form (i.e. I..1-234) or as a simple integer value. Use ":<issue group>" to specify issues from other than the default issues group. You may have as many -i flag pairs as necessary.

Promoting issue states

Similarly, it is possible to advance an issue to a different state via command line...

# razor -c promote_issue -f <issue> -s <state> \
-g <issue group>

<state> is the new state you want to promote to. The normal rules governing permissions and notifications will be enforced by the program.

This operation will be treated as a modify and will execute any modify before or after scripts that may be configured in the Actions file. The RAZOR_ACTION environment variable available to these scripts will be set to PROMOTE_BEFORE and PROMOTE_AFTER.¹

¹ See "Writing Your Own Shell Scripts" on page 219.