Tech Note 0001

Identifying Software Versions

What version codes mean and where to find them

Current Versions

Because we are constantly striving to improve our products, it is important to keep track of which version of each product you have.  This is especially true when you are requesting technical support or looking to upgrade to the latest revision.  The latest release version for each DEI end-user software package is shown below:

ExpeDat
1.19C
SyncDat
1.6A
Tunnel
1.1S
MTP SDK
4.3.3

Package versus Component

Each MTP/IP application consists of many components.  These may include executables, installers, documentation, and sample configuration files.  The overall collection of these things is called a "package".  Whenever any component changes, the package version is updated.  As a result, the version label of a package may be different from the version labels of the individual components.

Package versions take the form of "9.9Z".  That is, two numbers and a letter.

Component versions take the form of "9.9.9".  That is, three numbers.

Package versions are important when you are downloading an application for installation because they help identify whether you have the latest download.  But when you are requesting technical support, it is the component version that is necessary.  This is because, over time, components from different packages may become mixed and it is vital to know exactly which component is involved.

Finding Component Versions

All DEI software will display its version label when you click the "Opt", "Help", or "?" button, or when you add " ‑v " to the command line.  For example:

prompt# servedat -v
(C)2020 Data Expedition, Inc.(R) US Pat. 7158479,7313627,7404003,7630315
servedat - 1.19.1 December 2020 - DEI, DOC-2.3.5 MTP-osx-4.3.2 3577
00000001: ExpeDat-1.19B Data Expedition Inc., DataExpedition.com

The version output contains many important pieces of information, some of which describe the software and some of which describe the person or company who purchased the software.

 Component Version 
The name of the software component and its version label.
 Build Code 
A serial number indicating when the software was produced.
 Customer ID 
The customer identification number for this license.
 Package Version 
The name and release version of the application package.
 License Name 
A description of the person or company licensing the software.  Customers may specify their own description at the time of purchase.
 Label 
A description of an individual component license or configuration.  Customers may specify a label for each server, typically short descriptive text which may be displayed to client users.  For trial software, the label usually shows the expiration date.

Server software will also display its full component identification as part of its diagnostic output each time it is started.  This output may be displayed on the console or recorded in a log file.  For example:

prompt# servedat
V 20210112 09:18:29.306 servedat 1.19.1 "December 2020" DEI [4198] (8080)
C 20210112 09:18:29.307 (C)2020 Data Expedition, Inc.(R) US Pat. 7158479,7313627,7404003,7630315
C 20210112 09:18:29.307 servedat - 1.19.1 December 2020 - DEI, DOC-2.3.5 MTP-osx-4.3.2 3577
C 20210112 09:18:29.308 00000001: ExpeDat-1.19B Data Expedition Inc., DataExpedition.com

MTP and DOC software development kits return version information using the MTP_Get_Info() function.  The MTP version alone is returned via the mtpversion parameter, while the text strings describing complete version information are returned via the mtp_info_t structure.

Whenever you request technical support, please copy all lines of version text.

Production versus Trial

Most distribution package names end with either 'P' or 'T' to indicate whether they are licensed for production use or a limited trial.  These are often referred to as "Production" and "Trial" packages, respectively.

expedat-win32-1.19C-P.zip

Software contained in "P" packages is licensed for use in production and will run continuously or until the end of its term, but may require a license code.

expedat-win32-1.19C-T.zip

Software contained in "T" packages is licensed for trial use only and will run for a limited time period, but usually does not require a license code.

Tech Note History

Jan122021Clarify meaning of "Production"
Mar222017SDK Versions
Feb232015Updated Examples
Sep042013Updated Examples
Mar042013Updated Examples
Sep262012Current Versions
Apr042012Updated Examples
May112011Build Code
May042011Updated Examples
Dec022010Updated Examples
Aug092010Added name fields
Jun152010Updated Examples
Jun032010Added P vs T
Jul162009Updated Package Format
Nov182008Updated Examples
Oct312007New -v Format
Feb122007Updated