Difference between revisions of "Installation"

From DXLog.net
Jump to navigation Jump to search
(Register your copy)
(Reset the software)
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Download the software==
 
==Download the software==
 +
 
DXLog.net is available for download at http://www.dxlog.net/sw
 
DXLog.net is available for download at http://www.dxlog.net/sw
 +
 +
DXLog is free of charge.
  
 
==Prerequisites==
 
==Prerequisites==
Line 6: Line 9:
 
DXLog.net is written using Microsoft Visual Studio C# and compiled for Microsoft .NET Framework 4.0.
 
DXLog.net is written using Microsoft Visual Studio C# and compiled for Microsoft .NET Framework 4.0.
  
It runs on any Windows version with Microsoft .NET Framework version 4.0.  
+
It runs on any Windows version with Microsoft .NET Framework version 4.0 but <b>the development team only verifies DXLog on Windows 10 and 11.</b>
  
 
Due to the need to support SSL v1.2 for secure communication with live scoreboards and to download <br>
 
Due to the need to support SSL v1.2 for secure communication with live scoreboards and to download <br>
Line 21: Line 24:
  
 
If you plan to use your PC's parallel LPT port for CW keying and other functions, you need to download<br>
 
If you plan to use your PC's parallel LPT port for CW keying and other functions, you need to download<br>
and install the DLLPORTIO.dll driver due to limitations in Windows.
+
and install the DLPORTIO.DLL driver due to limitations in Windows.
 
It can be downloaded from http://dxlog.net/sw/files/tools/port95nt.exe
 
It can be downloaded from http://dxlog.net/sw/files/tools/port95nt.exe
 +
 +
If you plan to use the contest recorder, an MP3 encoder must be installed. See the [[Menu_Windows#Contest_Recorder|Contest recorder section]] for more information.
  
 
As of version 2.1.1 DXLog.net is using SQLite database for data storage.<br>
 
As of version 2.1.1 DXLog.net is using SQLite database for data storage.<br>
On some WinOS Microsoft Visual C++ 2010 RTM Redistributable Package (x86 version) needs to be installed.<br>
+
On some Windows installations Microsoft Visual C++ 2010 RTM Redistributable Package (x86 version) needs to be installed.
 +
 
 
If this package is not found during installation, DXlog.net installer will warn you.<br>  
 
If this package is not found during installation, DXlog.net installer will warn you.<br>  
 
You can download and install this package from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 <br>
 
You can download and install this package from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555 <br>
  
 
==Install the software==
 
==Install the software==
 
+
DXlog must be installed in the Program Files folder.<br>
Software is installed by default into your PC systems Windows Program Files folder.<br>
 
 
For 32 bit Processor machines this is usually <tt>C:\Program Files\DXLog.net</tt>.<br>
 
For 32 bit Processor machines this is usually <tt>C:\Program Files\DXLog.net</tt>.<br>
 
For 64 bit processor machines this is usually <tt>C:\Program Files(x86)\DXLog.net</tt>.<br>
 
For 64 bit processor machines this is usually <tt>C:\Program Files(x86)\DXLog.net</tt>.<br>
<br>
 
Application configuration files as well contest and database definitions are copied to a hidden Windows folder called '''Application Data'''
 
during the first run of DXLog.net.<br>
 
It can be reached via the ''Files|Open configuration directory'' menu shortcut, the <tt>%AppData%</tt> system variable, or its direct location which is <tt>C:\Users\USERNAME\AppData\Roaming\DXLog.net</tt>
 
 
==Unregistered limitations==
 
 
All versions of DXLog.net can be used to evaluate software functionality with some limits.<br>
 
 
Unregistered version can be used without any limits for '''DXPeditions'''.<br>
 
 
[[image:unregistered.png]]
 
 
For all contests, an unregistered copy of DXLog.net will have following limitations:<br>
 
* DXLog.net will restart itself every 10-20 minutes
 
* Logging is limited to 100 QSO
 
* Log file cannot be exported (ADIF, EDI, Cabrillo etc.)
 
 
==Register your copy==
 
 
To register your copy of DXLog.net and unlock full version functionality goto http://www.dxlog.net/registration/<br>
 
From then main menu, click on the "Register" link and fill out the required information.<br>
 
 
[[image:registrationpage.png]]
 
 
After entering all the required detail, you will receive a registration on screen, Select this key and <br>
 
copy to the windows clipboard using CTRL-C shortcut.<br>
 
Open DXLog.net, go to the ''Help|Register'' drop down menu item and fill in the registration details:<br>
 
  
[[image:regdata.png]]
+
'''IMPORTANT''': Do not modify the installation folder proposed by the installer.
  
* First and second name, separated by space, as entered on the web page
+
Application configuration files as well contest and database definitions are copied to a hidden<br>
* callsign as entered on the web page
+
Windows folder called '''Application Data''' during the first run of DXLog.net.<br>
* license key from the web page, paste from windows clipboard using CTRL-V
+
It can be reached via the <code>Files|Open configuration directory</code> menu shortcut, the <tt>%AppData%</tt><br>
 +
system variable, or its direct location which is <tt>C:\Users\USERNAME\AppData\Roaming\DXLog.net</tt>
  
Enter the data with care, if it is not exactly the same as used in registration process, the registration process will fail.
+
'''Important''': To make a completely clean reinstall of DXLog:
 +
* Uninstall DXLog
 +
* Go to the application data folder by entering %appdata% in Windows explorer
 +
* Delete the DXLog.net folder
 +
* Install DXLog
  
[[image:restart.png]]
+
==Installing intermediate releases==
  
Once entered and accepted, restart DXLog.net and if your new to DXLog.net setup your first log by going to ''File|New''.
+
From time to time the development team will make intermediate releases available.<br>
 +
Such releases may not be of production quality and typically solves a particular problem.<br>
 +
If you do not suffer from this problem, and are not part of a testing activity you are not<br>
 +
recommended to install such releases.
  
[[image:DXL_ContestConfig1.png]]
+
Intermediate releases are often referred to as ''devtest'' releases.
  
Your license key is valid for one year from the day registration.<br>
+
Since all parts of the DXLog executable may not be fully updated with an intermediate release,<br>
During that period, you can upgrade existing installations with newer versions as they become available.<br>
+
you are recommended to install such twice, the second time using the ''Repair'' option.  
  
After the one year period has expired, the current version of DXLog.net will continue to work with full functionality<br>
+
This is also the case when installing a public release after a ''devtest'' release or when<br>
but further updates will require a new license key.<br>
+
reverting to an older release.
  
You can use same license key on all your computers.
+
==Resetting DXLog to factory settings==
  
The registered callsign does not have to be the same as the callsign used in the contest log.
+
* Go to the application data folder by entering %appdata% in Windows explorer
 +
* Delete (or better, rename) the DXLog.net folder
 +
* Start DXLog

Latest revision as of 15:06, 6 January 2024

Download the software

DXLog.net is available for download at http://www.dxlog.net/sw

DXLog is free of charge.

Prerequisites

DXLog.net is written using Microsoft Visual Studio C# and compiled for Microsoft .NET Framework 4.0.

It runs on any Windows version with Microsoft .NET Framework version 4.0 but the development team only verifies DXLog on Windows 10 and 11.

Due to the need to support SSL v1.2 for secure communication with live scoreboards and to download
essential data bases like Super Check Partial, Windows XP is no longer supported.

Before installation of DXLog.net, you need to verify that you have Microsoft .NET Framework 4.0 installed on your PC system.
If you are not sure, you can start DXLog.net installation and the installer will warn you if .NET Framework 4.0
(or above) is not installed on your PC system.

Microsoft.NET Framework 4.0 is included in all Windows 7 and Windows 10 installations.

Should need arise, it is also available for free from the Microsoft website.
Direct download link http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=17718.

If you plan to use your PC's parallel LPT port for CW keying and other functions, you need to download
and install the DLPORTIO.DLL driver due to limitations in Windows. It can be downloaded from http://dxlog.net/sw/files/tools/port95nt.exe

If you plan to use the contest recorder, an MP3 encoder must be installed. See the Contest recorder section for more information.

As of version 2.1.1 DXLog.net is using SQLite database for data storage.
On some Windows installations Microsoft Visual C++ 2010 RTM Redistributable Package (x86 version) needs to be installed.

If this package is not found during installation, DXlog.net installer will warn you.
You can download and install this package from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=5555

Install the software

DXlog must be installed in the Program Files folder.
For 32 bit Processor machines this is usually C:\Program Files\DXLog.net.
For 64 bit processor machines this is usually C:\Program Files(x86)\DXLog.net.

IMPORTANT: Do not modify the installation folder proposed by the installer.

Application configuration files as well contest and database definitions are copied to a hidden
Windows folder called Application Data during the first run of DXLog.net.
It can be reached via the Files|Open configuration directory menu shortcut, the %AppData%
system variable, or its direct location which is C:\Users\USERNAME\AppData\Roaming\DXLog.net

Important: To make a completely clean reinstall of DXLog:

  • Uninstall DXLog
  • Go to the application data folder by entering %appdata% in Windows explorer
  • Delete the DXLog.net folder
  • Install DXLog

Installing intermediate releases

From time to time the development team will make intermediate releases available.
Such releases may not be of production quality and typically solves a particular problem.
If you do not suffer from this problem, and are not part of a testing activity you are not
recommended to install such releases.

Intermediate releases are often referred to as devtest releases.

Since all parts of the DXLog executable may not be fully updated with an intermediate release,
you are recommended to install such twice, the second time using the Repair option.

This is also the case when installing a public release after a devtest release or when
reverting to an older release.

Resetting DXLog to factory settings

  • Go to the application data folder by entering %appdata% in Windows explorer
  • Delete (or better, rename) the DXLog.net folder
  • Start DXLog