Tech Note 0001
Identifying Software Versions
What version codes mean and where to find them
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:
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.
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:
V 20210112 09:18:29.306 servedat 1.19.1 "December 2020" DEI  (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.
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.
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
|Jan||12||2021||Clarify meaning of "Production"|
|Aug||09||2010||Added name fields|
|Jun||03||2010||Added P vs T|
|Jul||16||2009||Updated Package Format|
|Oct||31||2007||New -v Format|