Tutorial: Checking for Updates and Updating Tranalyzer to a New Version

Checking for an Update

In order to check whether a new version of Tranalyzer2 is available, you can simply use the t2update alias or the setup.sh -C option:

$ t2update
Tranalyzer2 0.8.8lmw3 is already the latest version available!
$

Alternatively, if t2_aliases are not available, you can replace the previous command with:

$ cd /home/user/tranalyzer2
$ ./setup.sh -C
Tranalyzer2 0.8.8lmw3 is already the latest version available!
$

That was easy! We have the latest version and no update is available.

Updating to the Latest Version

Now what if there was a new version available? Let’s assume we are currently using an older version…

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do?
...

We now have several options. Let’s try them all, starting by the end!

t2update - Do Nothing

Do nothing (exit) simply aborts the update process. This is the default option if the answer is not recognised, e.g., if the Enter key was typed.

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do?
$

t2update - See the ChangeLog

See the ChangeLog can be used to review the content of the update. Important changes, such as new features and bug fixes, are listed.

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do? 4

ChangeLog for Tranalyzer2 version 0.8.8lmw3 (June 2020)

    * Tranalyzer2:
        * Updated subnet files

    * dnsDecode:
        * New DNS_WHO configuration flag to add geo info to DNS A and AAA records
        * Added type and class of query

    * nFrstPkts:
        * Bugfix in absolute time computation (NFRST_IAT=2)

    * macRecorder:
        * Updated manuf.txt

    * sslDecode:
        * Updated sslblacklist.[ct]sv

    * t2conf:
        * Added --gui option

    * tawk:
        * Added t2whois() function
        * Added passivedns() function (loaded with tawk -e)

Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do?
$

t2update - Download

Download can be used to fetch the latest version of Tranalyzer2. The output folder default to one level above the location of the setup.sh script, but can be changed before the download is started.

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do? 3
Choose output folder (type enter to use '/home/user'):
--2020-05-13 11:07:53--  https://tranalyzer.com/download/tranalyzer/tranalyzer2-0.8.8lmw3.tar.gz
Connecting to https://tranalyzer.com... connected.
HTTP request sent, awaiting response... 200 OK
Length: 0 [application/octet-stream]
Saving to: ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’

/home/user/tranalyzer2-0.     [ <=>                ]       0  --.-KB/s    in 0s

2020-05-13 11:07:53 (0.00 B/s) - ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’ saved [0/0]

Successfully downloaded 'tranalyzer2-0.8.8lmw3.tar.gz'
$ ls /home/user/tranalyzer2-0.8.8lmw3.tar.gz
tranalyzer2-0.8.8lmw3.tar.gz
$

t2update - Download and Extract

Download and extract can be used to fetch the latest version of Tranalyzer2 and extract it under the appropriate name including the version, i.e, tranalyzer2-0.8.8lmw3. The output folder default to one level above the location of the setup.sh script, but can be changed before the download is started. If the destination folder already exists, you will be prompted for confirmation.

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmw3 is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do? 2
Choose output folder (type enter to use '/home/user'):
--2020-05-13 11:07:53--  https://tranalyzer.com/download/tranalyzer/tranalyzer2-0.8.8lmw3.tar.gz
Connecting to https://tranalyzer.com... connected.
HTTP request sent, awaiting response... 200 OK
Length: 0 [application/octet-stream]
Saving to: ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’

/home/user/tranalyzer2-0.     [ <=>                ]       0  --.-KB/s    in 0s

2020-05-13 11:07:53 (0.00 B/s) - ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’ saved [0/0]

Successfully downloaded 'tranalyzer2-0.8.8lmw3.tar.gz'

'/home/user/tranalyzer2-0.8.8lmw3.tar.gz' successfully extracted under '/home/user/tranalyzer2-0.8.8lmw3'
$ ls /home/user/tranalyzer2-0.8.8lmw3
ChangeLog   autogen.sh  plugins     setup.sh    tranalyzer2
README.md   doc         scripts     tests       utils
$

t2update - Download and Overwrite

Download and overwrite can be used to fetch the latest version of Tranalyzer2 and extract it under the name used by the current version thus overwritting it. The output folder default to one level above the location of the setup.sh script, but can be changed before the download is started. If the destination folder already exists, you will be prompted for confirmation and given the opportunity to specify a different name.

$ t2update
Tranalyzer2 Tarantula version 0.8.8lmwg is out!
    1: Download and overwrite current version
    2: Download and extract under 'tranalyzer2-0.8.8lmw3'
    3: Download
    4: See the ChangeLog
    *: Do nothing (exit) [default]
What do you want to do? 1
Choose output folder (type enter to use '/home/user'):
--2020-05-13 11:07:53--  https://tranalyzer.com/download/tranalyzer/tranalyzer2-0.8.8lmw3.tar.gz
Connecting to https://tranalyzer.com... connected.
HTTP request sent, awaiting response... 200 OK
Length: 0 [application/octet-stream]
Saving to: ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’

/home/user/tranalyzer2-0.     [ <=>                ]       0  --.-KB/s    in 0s

2020-05-13 11:07:53 (0.00 B/s) - ‘/home/user/tranalyzer2-0.8.8lmw3.tar.gz’ saved [0/0]

Successfully downloaded 'tranalyzer2-0.8.8lmw3.tar.gz'

'/home/user/tranalyzer2-0.8.8lmw3.tar.gz' successfully extracted under '/home/user/tranalyzer2'
$ ls /home/user/tranalyzer2
ChangeLog   autogen.sh  plugins     setup.sh    tranalyzer2
README.md   doc         scripts     tests       utils
$