Staging files from the UNIX command line. (using the 'push' program)


To use the 'push' program to stage files, you will have to log into one of the UNIX machines (usually cp.pathfinder.com) using telnet.

To 'Stage a file' means to test a file and copy it from development (the cp.pathfinder.com machine) into production (the web servers).
Generally you receive an email confirmation for your stage.

To 'Stage delete a file' means to remove the file from production only (no files on cp.pathfinder.com will be affected).

Some Useful Examples

Action DescriptionCommand to enter at UNIX prompt
Stage a file (in my current directory)
push index.html
Stage a file (in the 'help' subdirectory of my current directory)
push help/index.html
Stage a file (giving full path to the file including the content root '/www')
push /www/help/index.html
Same as above but no need to specify the content root (/www)
push -U /help/index.html
Stage delete a file (in my current directory)
push -R index.html
Stage delete a file, ignoring errors which may be reported
push -i -R index.html
Stage a file and view the output from the stager
push -s index.html
Stage multiple files which match a file specification; here, all html files in the current directory. (You should first test which files will be matched with the command 'ls *.html')
push *.html
Stage a file and send email only if errors occur.
push -O SENDEMAIL=ERROR index.html
Using multiple options at once (delete from production, view output, send mail only if an error occurs, and content root not specified) push -R -s -O SENDEMAIL=ERROR -U /help/index.html
To display push options (type push alone)
push

Push Usage/Options

usage: push opts [--] files ...
       push opts -f filelist-file
       push opts -l push-state-file

where opts is one or more of:

  -Ddebugopt   - Debug-options
  -L logfile   - Logfile where to log debug-output to

  -z target    - What target we should stage to
  -h host      - Host to which we should connect (Stager)
  -p port      - The port to connect to on the staging host
  -O stageopt  - Staging options (see below)
  -s           - Keep the connection and output staging result
  -U           - File(s) specified is relative to content-root
  -i           - [root] Ignore phase 1 errors
  -m           - Stage from the production-master to the servers
  -{r|R}       - Enable removal of files.  Put a '+', or a '-' character
                 in front of each filename to indicate if you want to add (+)
                 or delete (-) the particular file.  If there is no '+' or '-'
                 character, the default is to either add the file (-r), or
                 delete it (-R).

  --           - Indicates the end of options (so a filenames can't be
                 parsed as option in case they start with a dash).

Batch mode options:
  -e           - Only send back an email if the staging fails
  -F emailaddr - [root] email-address to send back reply to
  -S service   - [root] Kerberos service to use
  -u username  - [root] Stage as this user

  where stageopt is one of the following:

    STRICT=[PHASE1|PHASE2] - Set strictness level
    MOUSEOVER
    EXT_TARGET
    SENDEMAIL=[ALWAYS|ERROR|NEVER]

See http://cp.pathfinder.com:8080/private/production/style/stager.html, for detailed information on how the stager works.

Email stager@pathfinder.com with questions and staging requests.