Difference between revisions of "Installation"
(→Install the software) |
(→Prerequisites) |
||
| (14 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
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. | + | DXLog is completely free of charge. Operational costs are generously covered by K1LZ and K1XM.<br> |
| + | The development team does not accept donations at this time. | ||
| + | |||
| + | DXLog does not have any formal minimum requirements but the general<br> | ||
| + | recommendations are Windows 11 and 4Gbyte of RAM. | ||
==Prerequisites== | ==Prerequisites== | ||
| − | DXLog.net is written using | + | DXLog.net is written using in C# and compiled for Microsoft .NET Framework 4.8. |
| − | It runs on any Windows version with Microsoft .NET Framework version 4. | + | It runs on any Windows version with Microsoft .NET Framework version 4.8 but<br> |
| + | <b>the development team only verifies DXLog on Windows 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> | ||
essential data bases like Super Check Partial, Windows XP is no longer supported. | 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. | + | Before installation of DXLog.net, you need to verify that you have Microsoft .NET Framework 4.8 installed on your PC system.<br> |
| − | If you are not sure, you can start DXLog.net installation and the installer will warn you if .NET Framework 4. | + | If you are not sure, you can start DXLog.net installation and the installer will warn you if .NET Framework 4.8 <br> |
(or above) is not installed on your PC system. <br> | (or above) is not installed on your PC system. <br> | ||
| − | Microsoft.NET Framework 4. | + | Microsoft.NET Framework 4.8 is included in all Windows 10 and Windows 11 installations. |
| − | |||
| − | |||
| − | |||
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> | ||
| Line 30: | Line 32: | ||
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 Windows | + | On some older or custom Windows versions 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> | ||
| Line 36: | Line 38: | ||
==Install the software== | ==Install the software== | ||
| − | |||
| − | |||
| − | |||
| − | ''' | + | DXLog installs in the protected <tt>Program Files</tt> directory on your computer. |
| + | |||
| + | When a never version is available, DXLog will prompt you to install it and guide you through the installation. | ||
| + | |||
| + | '''Important:''' The guided installation may cause a false malware alert. The development team is working on a solution. | ||
| − | Application configuration files as well contest and database definitions are copied to a | + | If the guided upgrade cannot be used or does not work you can manually download the installation package<br> |
| − | + | (the .MSI file) here https://dxlog.net/sw | |
| − | + | ||
| − | system variable, or its direct location which is <tt>C:\Users\USERNAME\AppData\Roaming\DXLog.net</tt> | + | You can just install a newer release. There is no need to remove older versions. |
| + | |||
| + | '''Important:''' Never modify the files in the installation directory, typically <tt>C:\Program Files\DXLog.net</tt>. | ||
| + | |||
| + | Application configuration files as well as contest and database definitions are copied to a directory in Windows'<br> | ||
| + | hidden <tt>%AppData%</tt> directory called during the first run of DXLog.net. | ||
| + | |||
| + | '''Important:''' If you need to edit DXLog files, you should only edit these copies. | ||
| + | |||
| + | This hidden directory can be reached via the <code>Files|Open configuration directory</code> menu shortcut, <br> | ||
| + | the <tt>%AppData%</tt> system variable, or its direct location which is <tt>C:\Users\USERNAME\AppData\Roaming\DXLog.net</tt><br> | ||
| + | with <tt>USERNAME</tt> being the active user name on your computer. | ||
'''Important''': To make a completely clean reinstall of DXLog: | '''Important''': To make a completely clean reinstall of DXLog: | ||
* Uninstall DXLog | * Uninstall DXLog | ||
| − | * Go to the application data | + | * Go to the application data directory by entering %appdata% in Windows explorer |
| − | * Delete the DXLog.net | + | * Delete the DXLog.net directory |
* Install DXLog | * Install DXLog | ||
| Line 60: | Line 74: | ||
recommended to install such releases. | recommended to install such releases. | ||
| − | Intermediate releases are often referred to as ''devtest'' releases. | + | Intermediate releases are often referred to as ''devtest'' releases and they are available [[https://dxlog.net/sw/#files%2Fdownload%2Fdevtest here]]. |
| + | |||
| + | Since the installer may not recognize a public release as newer than recent devtest release,<br> | ||
| + | you may need to uninstall the devtest release before installing it. | ||
| + | |||
| + | ==Installing an older release== | ||
| − | + | When installing an older release it is very important to: | |
| − | |||
| − | + | * Uninstall DXLog before installing the older release. | |
| − | + | * Clear the %appdata%\DXLog.net\Contest directory. | |
| − | == | + | ==Resetting DXLog to factory settings== |
| − | * Go to the application data | + | * Go to the application data directory by entering %appdata% in Windows explorer |
| − | * Delete (or better, rename) the DXLog.net | + | * Delete (or better, rename) the <tt>DXLog.net</tt> directory |
| + | * Start DXLog | ||
Latest revision as of 20:09, 5 April 2025
Contents
Download the software
DXLog.net is available for download at http://www.dxlog.net/sw
DXLog is completely free of charge. Operational costs are generously covered by K1LZ and K1XM.
The development team does not accept donations at this time.
DXLog does not have any formal minimum requirements but the general
recommendations are Windows 11 and 4Gbyte of RAM.
Prerequisites
DXLog.net is written using in C# and compiled for Microsoft .NET Framework 4.8.
It runs on any Windows version with Microsoft .NET Framework version 4.8 but
the development team only verifies DXLog on Windows 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.8 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.8
(or above) is not installed on your PC system.
Microsoft.NET Framework 4.8 is included in all Windows 10 and Windows 11 installations.
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 older or custom Windows versions 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 installs in the protected Program Files directory on your computer.
When a never version is available, DXLog will prompt you to install it and guide you through the installation.
Important: The guided installation may cause a false malware alert. The development team is working on a solution.
If the guided upgrade cannot be used or does not work you can manually download the installation package
(the .MSI file) here https://dxlog.net/sw
You can just install a newer release. There is no need to remove older versions.
Important: Never modify the files in the installation directory, typically C:\Program Files\DXLog.net.
Application configuration files as well as contest and database definitions are copied to a directory in Windows'
hidden %AppData% directory called during the first run of DXLog.net.
Important: If you need to edit DXLog files, you should only edit these copies.
This hidden directory 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
with USERNAME being the active user name on your computer.
Important: To make a completely clean reinstall of DXLog:
- Uninstall DXLog
- Go to the application data directory by entering %appdata% in Windows explorer
- Delete the DXLog.net directory
- 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 and they are available [here].
Since the installer may not recognize a public release as newer than recent devtest release,
you may need to uninstall the devtest release before installing it.
Installing an older release
When installing an older release it is very important to:
- Uninstall DXLog before installing the older release.
- Clear the %appdata%\DXLog.net\Contest directory.
Resetting DXLog to factory settings
- Go to the application data directory by entering %appdata% in Windows explorer
- Delete (or better, rename) the DXLog.net directory
- Start DXLog
