Home

• Getting Started :
• CLI options
• Sample Usage CLI
• Syntax of devices list
• Syntax of package list file
• Logs

Getting Started :

(1) Get Python and install

wget http://python.org/ftp/python/2.7.5/Python-2.7.5.tgz
tar -xvf Python-2.7.5.tgz 
cd Python-2.7.5/
cd Modules/
cd zlib/
./configure  --prefix=/usr/local
make 
sudo make install 
cd ..
./configure  --prefix=/usr/local
make
sudo make install

(2) get setup tool if don’t have

wget https://bootstrap.pypa.io/ez_setup.py
sudo python ez_setup.py  install

(3) Get Pexpect

wget https://pypi.python.org/packages/source/p/pexpect/pexpect-3.2.tar.gz
tar -xzvf pexpect-3.2.tar.gz 
cd pexpect-3.2/
sudo python setup.py install

(4) If you do not have git :

sudo apt-get install git   OR
yum install git

(5) Get AU code

git clone git://git.code.sf.net/p/acceleratedupgrade/code acceleratedupgrade-code
cd acceleratedupgrade-code/
python  install -d release
Note:"release" is directory where AUT will be installed , use release/accelerated_upgrade for 
      execution

CLI options

./release/accelerated_upgrade --help 
Usage: accelerated_upgrade [options]
Options:
-h, --help            show this help message and exit
--url=telnet|ssh://[user:pass@]a.b.c.d[:port]
                    The device url to run this tool against. --url
                    telnet://cisco:cisco@1.2.3.4:2004
--urls=TextFile       Text file containing one URL per line
-r URL, --repository=URL
                    url where packages are stored[Mandatory]
-f FILE, --pkg_file_list=FILE
                    File which contains list of packages [Mandatory]
-c FILE               File which contains list of commands to backup
--pre-upgrade         Run only Pre upgrade checks
--post-upgrade        Run only Post-upgrade checks, Note : Plugins which
                    depend on data collected during pre upgrade checks to
                    verify will fail , but execution will not be blocked
--upgrade             do an upgrade without running pre and post upgrade
                    checks

--logdir=DIR          Logs any communication into the directory with the
                    given name. Each filename consists of the hostname
                    with ".log" appended. Errors are written to a separate
                    file, where the filename consists of the hostname with
                    ".log.error" appended.
--outdir=DIR          Store the configuration and commands output into given
                    directory name. Each filename consists ofof the
                    hostname with datetime stamp
--delete-logs         Delete logs of successful operations when done.
--overwrite-logs      Instructs AU to overwrite existing logfiles. The
                    default is to append the output if a log already
                    exists.
--verbose=NUM         Print out debug information about the job queue. NUM
                    is a number between 0 (min) and 5 (max). Default is 0.
--device-verbose=NUM  Print out debug information about the device activity.
                    NUM is a number between 0 (min) and 5 (max). Default
                    is 0.
--session-log         Log device sesssion information to the file in logdir
--ignore-errors       Ignore plugin errors. By default if execution of any
                    plugin fails the device is excluded from further
                    processing
--max-threads=NUM     Maximum concurrent threads running per plugin. Default
                    is 1

Sample Usage CLI

release/accelerated_upgrade --urls=devices.txt -f pkglist.txt --pre-upgrade

Syntax of devices list

A text file with following URL syntax (square bracces contains optional parameters)
    <Protocol>://<User>[:Password]@<device address>[:port]
e.g.:
ssh://skewat@gsr-india04-lnx 
telnet://cisco@172.28.98.3

Syntax of package list file

A text file with following URL syntax (square bracces contains optional parameters)
(1) First line : ftp://<username>[:Password]@172.20.168.195//<Path>
(2) Followed by list of package one per line

e.g: cat pkglist.txt
ftp://myname:mypasswordo@172.120.108.185//home/some/path/
asr9k-mpls-px.pie-5.1.1
asr9k-asr901-nV-px.pie-5.1.2
asr9k-asr9000v-nV-px.pie-5.1.2
asr9k-asr903-nV-px.pie-5.1.2

Logs

By default all logs will be in "aulogs" dir. This dir will be present from where the AUT was executed.

Project Members:

• Gilbert Ramirez
• Om Prakash Maurya
• Prasad S R (admin)
• Raja Krishnan
• Shivappa Yaragatti (admin)
• Suryakant (admin)
• Toru Okatsu
• bhanu mulagapaka (admin)

[Shivappa Yaragatti]

Please refer following links for more information

Frequently Asked Questions