cqrlog/help/index_right.html
OH1KH bd117244fc Change to Cqrlog first start
This replaces ShowMessage "It seems you are trying to run this program
	for the first time...."

	As default it acts just like before. If user just closes window from top
	right X or clicks "OK" logs are created to user folder.
	As seen so many times this causes database connection problems because
	mysql safe thread does not start for reason, or other.
	It is called now "save logs in linux user folder"

	The second selection "save logs in local SQL server" is new option where
	logs will be saved to localhost/3306. The "real" SQL server that is
	installed already when filling Cqrlog dependencies.

	Using loacalhost SQL server a SQL user with password and privileges
	must be created. Cqrlog does it now making "create_cqr_user.sh" to
	users home directory and trying to execute it with command terminal.
	Xterm, gnome-terminal and lxterminal are searced fro run, but if
	none is found user is prompted to execute script manually with his
	"excotic" command-line terminal.
	Cqrlog also creates "backup_all-cqr.sh" scirpt that user can later
	use for backing up all cqrlog databases using mysqldump.

	Third selection is "save logs in external SQL server" that can be
	anywhere in network. In that case server admin needs to make
	SQL user for Cqrlog with proper privileges.
	Also in that case Cqrlog creates backup scrip with proper settings to
	backup logs later.

	Help files have been updated and new page for this start is created.
	it can be opened from DB selection window using xdg-open using
	button "?(please read)" and appears also in left frame of Main help.

	Specially the second selection may help a lot starting of Cqrlog.
	Also Mysql 8.x will work whith that case as no mysql_safe thread
	is tried to start in user's folders.

	This is tested with Fedora35(Gtk2/QT5), Mint20, and RPi 4b trying all
	selections.
	RPi graphics are working "weird" way compared to others.
	And Tabulator jumping does not work in Mint20 (virtual machine)
	None of these prevents usage.

Squashed commit of the following:

commit d7dfde30543ff1ef4f49b1c5fe9ccf3e17499ad5
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat Apr 9 13:04:45 2022 +0300

    Some RPi fixes still

commit 3e1e478c4960f8124a27ae7ffb686e5577993624
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat Apr 9 09:43:19 2022 +0300

    Some help fixes

commit f069596910fa56db172a5d2871236b30b06e7185
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri Apr 8 18:56:29 2022 +0300

    more fixing, again

commit a7f28186ad9bc8872f8afb28d8cafcbbc797d763
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri Apr 8 16:27:21 2022 +0300

    this nearly works, finally

commit 756f5941d2706dc3c8b446b36fe36d7da33aa0e1
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri Apr 8 13:15:15 2022 +0300

    several fixes, but still all do not work yet

commit 0a13c47d8a4aff263d7a9efbbca27c3fe7b38e8c
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 13:25:02 2022 +0300

    findfile fails on Mint20, strange

commit 3c858495f7492134ac3f8683738a450e22b5c20f
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 13:13:18 2022 +0300

    some typing errors fixed

commit 05aaedaec6890f61527df5eaee00c41b8aa88229
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 13:00:18 2022 +0300

    marker file delete change

commit b673f9a23f5255156405665587093939a35efeee
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 12:50:09 2022 +0300

    Error messages

commit 5f4da30c271c2ddb0bb7814cecfd3d74e58ea01b
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 10:40:40 2022 +0300

    some fixes

commit 773afc7df528b11762cace714ba32539d2f9bcdd
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 10:23:27 2022 +0300

    spellcheck hint texts

commit b63dbbe73dfeb0c87552f2b29a6cb6d2b36aeea3
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Apr 7 08:57:22 2022 +0300

    try to find terminal

commit 3f4cc32eee3ec321a81b2d7f9ee1c906ec5654b6
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Apr 6 19:38:07 2022 +0300

    Some help fixes

commit c406dcf3a857073d9bbaafca0f6fa4692dc789dd
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Apr 6 17:50:11 2022 +0300

    this nearly works. Help needs attention

commit b125604dc2fc0683941b3ee058d15ab9bf7a94e4
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Apr 6 14:45:21 2022 +0300

    some formatting

commit cae21e3bc4758c7dde98e7c1e4f66a2b42c5f392
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Apr 6 11:39:41 2022 +0300

    script changes

commit 6d2733837acf323c3ffaff361552f4f7cfd47e7b
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue Apr 5 20:00:45 2022 +0300

    one step forward

commit 2572b5b00bffca86296a795fc1db0eeb3e68318a
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue Apr 5 12:41:18 2022 +0300

    a fix

commit b8e779984e046586bb2dba55eaa7064ff95e3ab9
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue Apr 5 12:02:38 2022 +0300

    some layout fix etc

commit 60a8abb64f8ab77d904375e51340f1336ec3bb74
Author: OH1KH <oh1kh@sral.fi>
Date:   Mon Apr 4 20:14:02 2022 +0300

    core works, perhaps

commit d36679fce0a031cd1193b704c1a1dbd9a612a270
Author: OH1KH <oh1kh@sral.fi>
Date:   Mon Apr 4 15:51:09 2022 +0300

    some progress

commit 76c81b6f78d6fdbb52ae7c0aa34c433104b04e4e
Author: OH1KH <oh1kh@sral.fi>
Date:   Sun Apr 3 11:35:34 2022 +0300

    this does not work(yet)
2022-04-09 13:06:29 +03:00

149 lines
8.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en-us">
<head>
<META NAME="GENERATOR" CONTENT="Linux">
<META HTTP-EQUIV="Expires" CONTENT="-1">
<META HTTP-EQUIV="Last-Modified" CONTENT="0">
<META HTTP-EQUIV="Cache-Control" CONTENT="no-cache, must-revalidate">
<META HTTP-EQUIV="Pragma" CONTENT="no-cache">
<title>CQRLOG - Help Index</title></head>
<body>
<strong><h1>CQRLOG for LINUX (version 2.5.0)</h1></strong>
by<br><br>
<i>Petr Hlozek, OK2CQR
[<a href="http://www.ok2cqr.com">http://www.ok2cqr.com</a>]</i>
<br>
and
<br>
<i>Martin Kratoska, OK1RR
[<a href="http://www.ok1rr.com">http://www.ok1rr.com</a>]</i>
<br><br>
<strong><h3>If you are impatient:</h3></strong>
<div align="justify">
<div>Please check at least left frame <strong>'Starting cqrlog'</strong>,<strong>'Running first time'</strong> and <strong>'Preferences'</strong>.
<br> Thank you !
</div>
<strong><h3>Description:</h3></strong>
<div align="justify">
<div>CQRLOG is an advanced ham radio logging application based
on a MySQL database. It provides radio interfacing utilizing the hamlib libraries
(currently support for 140+ radio types and models), DX cluster
connection, band map, QRZ.com/HamQTH.com callbook (XML access),
ClubLog and Logbook of the World support, IOTA support, a
grayliner, propagation indicator, xplanet support (maps in azimuthal projection centered in
your QTH), OK1RR free QSL manager database etc.
<br> <br>CQRLOG is intended mainly for seriously HF DX minded operators
but can be used for any ham logging purpose, also by casual operators.
It is equipped with probably most accurate DXCC country database
available, providing not only the country resolution but also state,
province, region, district etc. It resolves also antarctic bases,
special event stations, contest callsigns and much more.<br><br>
CQRLOG has its own web site at
<a href=http://www.cqrlog.com><strong>http://www.cqrlog.com</strong></a>.
Find news, changes, latest additional files and howtos there.
If you have a problem, browse the web site first, then ask for help.
</div>
<br><br> <strong><h3>License and disclaimer:</h3></strong>CQRLOG is
published under the GNU GENERAL PUBLIC LICENSE Version 2 (GPL v. 2), June
1991. This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version. Full version of GPL v.
2 is <a href="h8.html"><strong>here</strong></a>.
<br><br>The authors are not responsible for any damages, losses or safety risks to the user; the software is
published AS IS.
<br><br><strong><h3>Supported transceivers:</h3>
</strong> The Radio Control interface is provided using <i>hamlib</i>,
a set of libraries, which is a development effort to provide a
consistent interface for programmers wanting to incorporate radio
control in their programs. <i>hamlib</i> is not a complete user
application, rather, it is a software layer intended to make
controlling various radios and other shack hardware much easier.
<br><br> Most recent amateur radio transceivers allow external control
of their functions through a serial interface. Unfortunately, control
commands are not always consistent across a manufacturer's product line
and each manufacturer's product line differs greatly from its
competitors.
<br><br> There's no standardized protocol to remotely control one's
rig, be it a Ham radio transceiver, a SWL receiver, any kind of scanner
or other mobiles. However, many manufacturer have designed their
own proprietary protocol, implemented in some of their product family.
Therefore, each rig family will require a <i>hamlib</i> backend to set
the VFO frequency, change mode and passband width, get current signal
strength, etc. The actual list of supported radios can be found <a href="https://sourceforge.net/p/hamlib/wiki/Supported%20Radios/"><strong>on Hamlib website</strong></a>.
<br><br> <strong><h3>Installation:</h3></strong>
Ubuntu users can use a repository on <a href="https://launchpad.net/~ok2cqr/+archive/ubuntu/ppa">Launchpad</a>. To add the repo, open a terminal and copy&amp;paste<br><br>
<code>
sudo add-apt-repository ppa:ok2cqr/ppa<br>
sudo apt-get update<br>
sudo apt-get install cqrlog <br>
</code><br>
Only Ubuntu 14.04 and Ubuntu 16.04 are officially supported but there are also builds for other
versions of Ubuntu on <a href="https://launchpad.net/~ok2cqr/+archive/ubuntu/ppa">Launchpad</a>.
<br><br>
Debian users can simply install using the package manager<br><br>
<code>
sudo apt-get install cqrlog <br>
</code><br><br>
For other distributions, you can use binaries located at
<a href="http://cqrlog.com/download">http://cqrlog.com/download</a>.
Some of them, like Fedora and Arch, have their own repositories for CQRLOG - Fedora: <a
href="https://apps.fedoraproject.org/packages/cqrlog">https://apps.fedoraproject.org/packages/cqrlog</a>
ArchLinux <a href="https://aur.archlinux.org/packages/cqrlog/">https://aur.archlinux.org/packages/cqrlog/</a><br>
If upgrading, no important file will be overwritten. Anyway, <strong>backup your log</strong> before you begin any
upgrade!
<br><br><strong><h3>Dependencies:</h3></strong>
<ul>
<li><strong>HamLib</strong> - must be installed even if you don't want radio control. The sources are available
at <a href="http://hamlib.sourceforge.net/"><strong>http://hamlib.sourceforge.net/</strong></a>, however
precompiled packages are available for almost all major Linux distributions.
</li>
<li><strong>MySQL server and client</strong> - The MySQL client must be installed,
without this the program will not work at all. A MySQL server must be reachable,
either on the local machine or via a network.
</li>
<li><strong>libssl-devel</strong> needed if you want to use LoTW and/or online log upload
</ul>
</div>
<strong><h3>Third Party Programs</h3></strong>
<ul>
<li><strong>Hamlib</strong> - <strong><font color="#FF0000">NEEDED</font></strong>,
without this CQRLOG will not work!
</li>
<li><strong>Trusted QSL</strong> - for LoTW operations. Ubuntu and Debian have this package in their repositories.</li>
<li><strong>xplanet</strong> - for DX Cluster spot visualization on the azimuthal map.</li>
<li><strong>cwdaemon</strong> - for CW operation, only if you choose parallel or serial port keying without Winkey.
</li>
<table border="0" cellpadding="5" cellspacing="2" width="100%">
<tbody>
<tr>
<td valign="top">
<img src="img/exc.png"></td>
<td bgcolor=ffffcc valign="top" align="justify"><strong><font color="red">WARNING!</font></strong>
cwdaemon use may result in <strong>sloppy CW at speeds above 30 WPM</strong>.
Use Winkey (by K1EL) if possible or your <strong>kernel must be modified to minimalize the
latency</strong>. Tickless, high resolution timer and 1000 Hz sampling rate must be used.
Recommended for very experienced linux users only!
</td>
</tr>
</tbody>
</table>
<li><strong>fldigi</strong> for RTTY and Digital Modes. Install the package from your
distribution or download from the W1HKJ site <a href=http://www.w1hkj.com/Fldigi.html><strong>http://www.w1hkj.com/Fldigi.html</strong></a>
</li>
</ul>
<p align="center"><img src="img/line.png"></p>
<table border="0" cellpadding="2" cellspacing="2" width="100%">
<tbody>
<tr>
<td align="left" width="33%">&nbsp;</td>
<td align="center" width="33%">[<a href="#aa">Menu</a>]</td>
<td align="right" width="33%"><a href="h1.html">Next </a>&gt;</td>
</tr>
</tbody>
</table>
</body>
</html>