### Start connection with connect command Source: https://wiki.dxcluster.org/wiki/Configuration Example of starting a connection by typing 'connect' followed by a script name at the cluster prompt. The output shows the connection being started. ```text G0VGS de GB7MBC 13-Dec-1998 2041Z >connect gb7djk-1 connection to GB7DJK-1 started G0VGS de GB7MBC 13-Dec-1998 2043Z > ``` -------------------------------- ### startup script example Source: https://wiki.dxcluster.org/wiki/Scripts Example startup script for DXSpider. It sets maximum spots, rejects node adverts and D0/D1 prefixes, sets spider connections, makes instant connections, requires registration, optionally requires passwords, sets external IP, and sets local hostnames. Lines starting with # are ignored. ```plaintext # # # lines starting with a # are ignored # # set maximum no of spots allowed to 100 set/var $Spot::maxspots = 100 # # reject node adverts rej/ann node_default input info telnet,cluster,7000,7300,7373,8000,8888,9000,17300 # # reject D0 and D1 prefixes which aren't on the ITU list rej/spot node_default input 2 call d0,d1 rej/spot node_default input 3 by d0,d1 # # set outbound spider connections with nodes you've paired with set/spider g1abc-2 set/spider gb7abc-1 # # make instant connections to nodes connect g1abc-2 connect gb7abc-1 # # make people register before they can send spots # 1 is on, 0 is off set/var $main::reqreg = 1 # # make people use a password to login # 1 is on, 0 is off set/var $main::passwdreq = 0 # # set the node's external dynamic IP set/external_ip # # set the node and logging pc IPv4s # gather ip address from your network and add them at the end using ,'192.168.1.144' for example set/var @main::localhost_names ('127.0.0.1', '::1', '192.168.1.123','192.168.1.134') # #EOF ``` -------------------------------- ### Install nano editor Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install nano, recommended for beginners. ```bash # yum install nano ``` -------------------------------- ### set/qth example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of setting a QTH location. ```plaintext SET/QTH East Dereham, Norfolk ``` -------------------------------- ### SH/MUF W 24 command example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Shows the command to get 24 hours of propagation data for prefix W. ```text SH/MUF W 24 ``` -------------------------------- ### Example output of show/files Source: https://wiki.dxcluster.org/wiki/Information,_files_and_useful_programs Example output showing a directory and a file with sizes and timestamps. ```text sh/files bulletin DIR 20-Dec-1999 1715Z news 1602 14-Dec-1999 1330Z ``` -------------------------------- ### SYSOP password challenge example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Shows the password string and the sysop command output with five indexes. The indexes start from zero and are used to select characters from the password. ```text password = 012345678901234567890123456789 > sysop 22 10 15 17 3 ``` -------------------------------- ### SHOW/DXQSL example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of the SHOW/DXQSL command to display QSL manager information gathered from spot comments. ```text sh/dxqsl 4k9w ``` -------------------------------- ### Start dxspider.service Source: https://wiki.dxcluster.org/wiki/Auto-start Starts the dxspider service. Run as root. ```bash # systemctl start dxspider.service ``` -------------------------------- ### set/qra example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of setting a QRA grid locator. ```plaintext SET/QRA JO02LQ ``` -------------------------------- ### SHOW/DXQSL example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example of the SHOW/DXQSL command to query the QSL manager database for a callsign. ```text sh/dxqsl 4k9w ``` -------------------------------- ### Install emacs editor Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install emacs. ```bash # yum install emacs ``` -------------------------------- ### SYSOP password challenge example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows the system response to the SYSOP command, returning five indexes into the password string. The indexes start from zero. ```text password = 012345678901234567890123456789 > sysop 22 10 15 17 3 ``` -------------------------------- ### set/baddx example Source: https://wiki.dxcluster.org/wiki/Other_filters Example command to stop bad DX spots. ```text set/baddx video wsjt ``` -------------------------------- ### Start NTP service Source: https://wiki.dxcluster.org/wiki/Centos6 Start the NTP service. ```bash # service ntpd start ``` -------------------------------- ### SHOW/DX example commands Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example invocations of SHOW/DX with various filters: prefix, band, info, QSL, IOTA, QRA, DXCC, zone, state, and their by_ variants. ```text SH/DX 9m0 SH/DX on 20m info iota SH/DX 9a on vhf day 30 SH/DX rf1p qsl SH/DX iota SH/DX iota eu-064 SH/DX qra jn86 SH/DX dxcc oq2 SH/DX dxcc oq2 by w dxcc SH/DX zone 4,5,6 SH/DX by_zone 4,5,6 SH/DX state in,oh SH/DX by_state in,oh ``` -------------------------------- ### Install package foo with yum Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install a package named 'foo'. ```bash # yum install foo ``` -------------------------------- ### Install AX.25 RPMs (libax25, ax25-tools, ax25-apps) Source: https://wiki.dxcluster.org/wiki/Setting_up_the_AX25_Utilities Install the required RPM packages in order: libax25, then ax25-tools, then ax25-apps. Use the exact filenames shown. ```bash rpm -ivh libax25-0.0.7-7.i386.rpm rpm -ivh ax25-tool-0.0.6-13.i386.rpm rpm -ivh ax25-apps-0.0.4-9.i386.rpm ``` -------------------------------- ### SH/BUCK command example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example command that works after adding the alias entry, allowing users to query the buckmaster database. ```text SH/BUCK g1tlh ``` -------------------------------- ### DX command example Source: https://wiki.dxcluster.org/wiki/Getting_and_posting_DX Example of posting DX with frequency, callsign, and remarks. ```plaintext dx 14004 pa3ezl OP Aurelio 599 ``` -------------------------------- ### SHOW/CONFIGURATION command examples Source: https://wiki.dxcluster.org/wiki/Nodes_and_users Four variations of the SHOW/CONFIGURATION command: show all nodes with users, show only nodes, show a specific node by call, and show nodes by prefix. The first example shows all nodes and their users, the second shows only nodes, the third requires a node call, and the fourth uses a prefix to filter nodes. ```plaintext show/configuration show/configuration nodes show/configuration (node_call) show/configuration (prefix) ``` -------------------------------- ### set/badspotter example Source: https://wiki.dxcluster.org/wiki/Other_filters Example command to stop spots from bad spotters. ```text set/badspotter b0mb p1rat nocall ``` -------------------------------- ### accept/wcy sysop version example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of setting a WCY filter for a callsign and setting hops for node_default. ```text accept/wcy node_default all set/hops node_default 10 ``` -------------------------------- ### Install EPEL repository Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install the EPEL repository, required for perl-Curses. ```bash # rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-5.noarch.rpm ``` -------------------------------- ### SHOW/DXCC example commands Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example usage of the SHOW/DXCC command, which is an alias for 'SHOW/DX DXCC'. The options for SHOW/DX also apply. ```text SH/DXCC G SH/DXCC W on 20m iota ``` -------------------------------- ### Install cpanminus via wget Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Alternative method to install cpanminus using wget to fetch the installer script and run it with perl. This is a manual installation method. ```bash wget -O - https://cpanmin.us | perl - --sudo App::cpanminus ``` -------------------------------- ### Install required packages for DXSpider Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install all packages needed for DXSpider. ```bash # yum install perl-TimeDate perl-Time-HiRes perl-Digest-SHA1 perl-Curses perl-Net-Telnet git gcc make ``` -------------------------------- ### Install vim editor Source: https://wiki.dxcluster.org/wiki/Centos6 Run as root to install vim, which extends the basic vi editor features. ```bash # yum install vim ``` -------------------------------- ### SHOW/DX example commands Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example invocations of the SHOW/DX command using various filters such as prefix, band, info text, day range, QSL, IOTA, QRA, DXCC, zones, and states. ```text SH/DX 9m0 SH/DX on 20m info iota SH/DX 9a on vhf day 30 SH/DX rf1p qsl SH/DX iota SH/DX iota eu-064 SH/DX qra jn86 SH/DX dxcc oq2 SH/DX dxcc oq2 by w dxcc SH/DX zone 4,5,6 SH/DX by_zone 4,5,6 SH/DX state in,oh SH/DX by_state in,oh ``` -------------------------------- ### SHOW/DXCC examples Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Examples of the SHOW/DXCC command, which is an alias for SHOW/DX DXCC, showing how to display spots for a country by prefix. ```text SH/DXCC G SH/DXCC W on 20m iota ``` -------------------------------- ### set/badnode example Source: https://wiki.dxcluster.org/wiki/Other_filters Example command to stop spots from a particular node. ```text set/badnode gb7djk gb7dxc ``` -------------------------------- ### accept/announce all example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/announce filter using the 'all' tag to accept everything. ```plaintext acc/ann all ``` -------------------------------- ### Install rsync on Debian-based systems Source: https://wiki.dxcluster.org/wiki/Node_Backup_and_Update_with_check_build Command to install the rsync dependency. ```bash apt install rsync ``` -------------------------------- ### accept/announce examples Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/announce filter commands: acc/ann dest 6MUK, acc/ann 2 by_zone 14,15,16, and a combined version on one line. ```plaintext acc/ann dest 6MUK acc/ann 2 by_zone 14,15,16 (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16) ``` -------------------------------- ### Install build-essential and CPAN packages via cpanm Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Installs build-essential and then uses cpanm to install the required CPAN packages. This is the fallback method when OS packages are not available or too old. The packages installed are EV, Mojolicious, JSON, JSON::XS, Data::Structure::Util, Math::Round, and Net::CIDR::Lite. ```bash sudo apt-get install build-essential sudo cpanm EV Mojolicious JSON JSON::XS Data::Structure::Util Math::Round Net::CIDR::Lite ``` -------------------------------- ### Install SQLite Perl library Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Install the Perl library for SQLite database support. ```bash apt install libdbd-sqlite3-perl ``` -------------------------------- ### accept/spots all example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/spots filter using the 'all' tag to accept everything. ```plaintext acc/spot 3 all ``` -------------------------------- ### dbcreate remote database example Source: https://wiki.dxcluster.org/wiki/Databases Example of creating a remote database entry named 'buckmaster' at remote node 'gb7dxc'. ```text dbcreate buckmaster remote gb7dxc ``` -------------------------------- ### Install NTP Source: https://wiki.dxcluster.org/wiki/Centos6 Install the NTP package to keep the system clock accurate. ```bash # yum install ntp ``` -------------------------------- ### Start AX.25 daemons Source: https://wiki.dxcluster.org/wiki/Setting_up_the_AX25_Utilities Start the daemons that set everything in motion: ax25d and netromd with the -i flag. ```bash ax25d netromd -i ``` -------------------------------- ### Enable dxspider.service Source: https://wiki.dxcluster.org/wiki/Auto-start Enables the service to start at boot. May be needed on some systems. ```bash # systemctl enable dxspider.service ``` -------------------------------- ### reject/spots all example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example using the 'all' tag to reject all spots. Noted as probably for advanced users. ```text rej/spot 3 all ``` -------------------------------- ### SHOW/MYDX example with ACC/SPOT Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of setting a spot filter to only show HF spots, which affects SHOW/MYDX. ```plaintext ACC/SPOT on hf ``` -------------------------------- ### SHOW/HFTABLE: Specify start date in various formats Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Add a date in a recognizable form to start from a different day. The examples show several accepted date formats. ```text sh/hftable 2 25nov02 ``` ```text sh/hftable 2 25-nov-02 ``` ```text sh/hftable 2 021125 ``` ```text sh/hftable 2 25/11/02 ``` -------------------------------- ### Start DXSpider service (systemd) Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Command to start the DXSpider service using systemd. ```bash sudo service systemctl start dxspider ``` -------------------------------- ### Enable NTP at boot Source: https://wiki.dxcluster.org/wiki/Centos6 Configure the NTP service to start automatically at boot. ```bash # chkconfig ntpd on ``` -------------------------------- ### accept/spots by_state example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example accept/spots filter for US states. ```text acc/spots by_state VA,NH,RI,MA,ME ``` -------------------------------- ### accept/wwv sysop version examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Examples of setting WWV filters for a callsign, node_default, and user_default. ```text accept/wwv db0sue-7 1 by_zone 4 accept/wwv node_default all set/hops node_default 10 accept/wwv user_default by W,K ``` -------------------------------- ### DBSHOW command examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Two examples of displaying database entries: the familiar AK1A style using SH/BUCK and the generic DBSHOW command. Both query the buck database for G1TLH. ```plaintext SH/BUCK G1TLH ``` ```plaintext DBSHOW buck G1TLH ``` -------------------------------- ### Change to /spider directory Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Navigate to the DxSpider installation directory before running setup scripts. ```bash $ cd /spider ``` -------------------------------- ### reject/route all example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of using the 'all' tag to reject all routes, equivalent to very restricted mode. ```text rej/route all (equiv to [very] restricted mode) ``` -------------------------------- ### DBCREATE command-based pseudo-database example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Makes a local command 'show/dxqsl' available as a pseudo-database named 'dxqsl'. Useful for remote access from legacy nodes. ```text DBCREATE dxqsl cmd show/dxqsl ``` -------------------------------- ### reject/announce all example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example using the 'all' tag to reject all announces. Noted as probably for advanced users. ```text rej/ann all ``` -------------------------------- ### Download WinCVS from SourceForge Source: https://wiki.dxcluster.org/wiki/CVS URL to download the WinCVS 1.2 stable version. Use this link to get the software before installation. ```text http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip ``` -------------------------------- ### Start the DXSpider cluster with ./cluster.pl Source: https://wiki.dxcluster.org/wiki/Linux_Installation Run './cluster.pl' from the /spider directory to start the cluster. The expected output shows version 1.50 and various loading messages, ending with 'orft we jolly well go ...'. ```bash $ ./cluster.pl DXSpider DX Cluster Version 1.50 Copyright (c) 1998 Dirk Koopman G1TLH loading prefixes ... loading band data ... loading user file system ... starting listener ... reading existing message headers reading cron jobs orft we jolly well go ... ``` -------------------------------- ### Installation commands Source: https://wiki.dxcluster.org/wiki/Updating_Public_IP_and/or_Local_IPs_(set/update_ip) Commands to download and place the update_ip.pl script in the correct directory. ```bash cd /spider/local_cmd mkdir -p set cd set wget -c https://github.com/EA3CV/dxspider_info/blob/main/set/update_ip.pl ``` -------------------------------- ### demonstrate command examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows how to use the demonstrate command to run a command as another user and send the output to that user. Similar to SPOOF with same side effects; commands run at the privilege of the target user. ```plaintext DEMO g7brn sh/dx iota oc209 DEMO g1tlh set/here ``` -------------------------------- ### SH/C with node or prefix - Show users for a node Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Supply a node or part of a prefix to get a list of users for that node or list of nodes starting with that prefix. ```plaintext SH/C GB7DJK SH/C SK ``` -------------------------------- ### Install procps package Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Installs the procps package, which may be missing. This is a precautionary step to ensure the 'top' command is available. ```bash # just in case it's missing (top, that is) sudo apt-get install procps ``` -------------------------------- ### Example: accept/spot call_zone 5 Source: https://wiki.dxcluster.org/wiki/Accept_filters Example that accepts all spots for CQ zone 5 and rejects all others. ```plaintext accept/spot 0 call_zone 5 ``` -------------------------------- ### show/startup Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Views your own startup script created with SET/STARTUP. ```APIDOC ## show/startup ### Description Views your own startup script created with SET/STARTUP. ### Method CLI Command ### Endpoint show/startup ### Parameters None ### Response Displays the contents of your startup script. ``` -------------------------------- ### Example output of sh/ver Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Example output showing the git revision number and version information. ```text DXSpider v1.55 (build 249 git: master/2fc6c64f[r]) usando perl v5.30.3 en Linux Derechos de autor (c) 1998-2023 Dirk Koopman G1TLH ``` -------------------------------- ### Console output during connection Source: https://wiki.dxcluster.org/wiki/Configuration Example of the console output when following a connection from the terminal where cluster.pl was started. From version 1.47 onwards, set/debug connect must be enabled first. ```text <- D G1TLH connect gb7djk-1 -> D G1TLH connection to GB7DJK-1 started -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z > timeout set to 15 CONNECT sort: telnet command: dirkl.tobit.co.uk CHAT "login" -> "gb7djk" received " Red Hat Linux release 5.1 (Manhattan) Kernel 2.0.35 on an i586 " received "login: " sent "gb7djk" CHAT "word" -> "gb7djk" received "gb7djk" received "Password: " sent "gb7djk" Connected to GB7DJK-1, starting normal protocol <- O GB7DJK-1 telnet -> B GB7DJK-1 0 GB7DJK-1 channel func state 0 -> init <- D GB7DJK-1 <- D GB7DJK-1 Last login: Sun Dec 13 17:59:56 from dirk1 <- D GB7DJK-1 PC38^GB7DJK-1^~ <- D GB7DJK-1 PC18^ 1 nodes, 0 local / 1 total users Max users 0 Uptime 0 00:00^5447^~ etc ``` -------------------------------- ### show/startup Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Views a user's startup script. ```APIDOC ## show/startup ### Description Views a user's startup script. ### Method CLI Command ### Endpoint show/startup ### Parameters #### Path Parameters - **call** (string) - Required - Callsign of the user whose startup script to view ### Response Displays the startup script for the specified user. ``` -------------------------------- ### accept/route example filters Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Examples of accept/route filters for specific callsigns and DXCC prefixes, plus the 'all' tag. ```text acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes) acc/route gb7djk call gb7djk (equiv to SET/ISOLATE) ``` ```text by = call by_dxcc = call_dxcc ``` ```text acc/route all ``` -------------------------------- ### SH/MUF long path command examples Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Two equivalent commands to get long path propagation estimates for prefix W over 24 hours. The documentation notes the figures may not be very useful or accurate. ```text SH/MUF W L 24 ``` ```text SH/MUF W 24 Long ``` -------------------------------- ### show/vhftable with date formats Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows the VHF DX Spotter table starting from a specific date. The date can be given in various recognizable formats, as shown in these examples. This is useful for viewing stats for a particular contest weekend. ```plaintext sh/vhftable 2 25nov02 ``` ```plaintext sh/vhftable 2 25-nov-02 ``` ```plaintext sh/vhftable 2 021125 ``` ```plaintext sh/vhftable 2 25/11/02 ``` -------------------------------- ### SHOW/STARTUP Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Views the contents of a startup script created with SET/STARTUP. ```APIDOC ## SHOW/STARTUP ### Description Displays the contents of the startup script created with SET/STARTUP. ### Syntax `SHOW/STARTUP` ### Parameters None. ``` -------------------------------- ### Example output of muser.pl Source: https://wiki.dxcluster.org/wiki/List_of_users_for_mobile_use Example output showing a list of connected users with callsign, registration type, and connection time. The output includes a header, rows for each user, and a total count. ```text List of connected Users: Callsign R P Type Connection Time -------- - - --------- --------------- CT7AGM-1 USER EXT 0 d 0 h 11 m EA1FU-1 R P USER EXT 0 d 1 h 9 m EA3CV R P USER LOCL 0 d 4 h 42 m EA3GOP USER EXT 0 d 6 h 56 m EA4HPI USER EXT 0 d 0 h 8 m EA5GST USER EXT 1 d 2 h 0 m EA5JN R P USER EXT 0 d 3 h 27 m EA8DLF USER EXT 0 d 0 h 30 m EC3ALS USER EXT 8 d 0 h 1 m F6DAY USER EXT 0 d 2 h 55 m SK0MMR USER RBN 2 d 8 h 38 m SK1MMR USER RBN 6 d 12 h 42 m Users: 10 ``` -------------------------------- ### Switch to sysop user Source: https://wiki.dxcluster.org/wiki/Centos6 Changes to the sysop user to perform installation steps. ```bash # su - sysop ``` -------------------------------- ### SHOW/CONFIGURATION: Display specific node or prefix (SH/C GB7DJK, SH/C SK) Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Use SH/C with a node callsign or prefix to display users for that node or nodes starting with that prefix. Examples show querying for GB7DJK and SK. ```plaintext SH/C GB7DJK SH/C SK ``` -------------------------------- ### Output of 'show/configuration' (all nodes) Source: https://wiki.dxcluster.org/wiki/Nodes_and_users Example output from the first command 'show/configuration', showing a list of nodes and their connected users. Nodes with parentheses indicate limited protocol, showing only user count. ```plaintext sh/c Node Callsigns EI5TCR (7 users) GB7ADX GB7BAA G4FPV G8TIC GB7BIG (GD0TEP) GD3UMW GB7BPQ (G0INA) G0RCI G3AKU G3OCA (GB7CDX) G3JNB G4ALR GB7DJK G0FYD G0REK G1TLH G4PEL G4SOZ G4TVR G7SQW K8AZ M0CTQ-1 MM1CXE-10 ON7WP GB7DXA G0RDI G8SJP GB7DXC (G0HDB) G0WFK (G1FYC) G3KWK G3LME G3OIL G4BGW G4FUJ (G4PDQ) GW7SMV GB7DXE G1NNB (GB7DXG) GU6EFB GU7DHI GB7DXK G1NTW G3IBI G3NSM G3XAQ G4CUS G4XQY G7GAN GB7DXM G1EUC G3GAF G3LAS G4ZTR G8WXU M0BCT M1EMF ``` -------------------------------- ### show/satellite: Show tracking data Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Use SH/SAT with a satellite name to get tracking data for passes that start and finish 5 degrees below the horizon. Default is next three hours in five-minute intervals. You can specify hours and interval. Without a name, lists all known satellites. ```plaintext SH/SAT AO-10 SH/SAT FENGYUN1 12 2 ``` -------------------------------- ### reject/announce all example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of using the 'all' tag to reject all announces, noted as probably for advanced users. ```text rej/ann all ``` -------------------------------- ### DBAVAIL command example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows how to list all databases defined in the system. The command is aliased to SHOW/COMMAND. ```text DBAVAIL (or it will have been aliased to SHOW/COMMAND) ``` -------------------------------- ### Install cpanminus via curl Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Alternative method to install cpanminus using curl. First installs curl with apt, then fetches and runs the installer script. ```bash sudo apt-get install curl curl -L https://cpanmin.us | perl - --sudo App::cpanminus ``` -------------------------------- ### Example axports configuration for TNC2 Source: https://wiki.dxcluster.org/wiki/Setting_up_the_AX25_Utilities Example configuration for a standard TNC2, showing two ports with unique portnames and SSIDs. ```text #portname callsign baudrate paclen window description 2m gb7mbc-2 19200 256 2 2m port on 144.900MHz 4m gb7mbc-4 19200 256 2 4m port on 70.325MHz ``` -------------------------------- ### Start and stop the cluster Source: https://wiki.dxcluster.org/wiki/Centos6 Commands to start and stop the DXspider cluster using upstart. The start command is '#start dxspider' and the stop command is '#stop dxspider'. ```bash #start dxspider ``` ```bash #stop dxspider ``` -------------------------------- ### Expected startup output from cluster.pl Source: https://wiki.dxcluster.org/wiki/Installing_the_software Example of the display after running cluster.pl, showing version, loading messages, and startup status. ```text DXSpider DX Cluster Version 1.50 Copyright (c) 1998-2002 Dirk Koopman G1TLH loading prefixes ... loading band data ... loading user file system ... starting listeners ... Internal port: localhost 27754 load badwords: Ok reading in duplicate spot and WWV info ... reading existing message headers ... load badmsg: Ok load forward: Ok load swop: Ok @msg = 0 before delete @msg = 0 after delete reading cron jobs ...v cron: reading /spider/cmd/crontab cron: adding 1 0 * * 0 DXUser::export("$main::data/user_asc") reading database descriptors ... doing local initialisation ... orft we jolly well go ... queue msg (0) ``` -------------------------------- ### Create sysop user file with create_sysop.pl Source: https://wiki.dxcluster.org/wiki/Centos6 Creates the basic user file with you as the sysop. ```bash $ ./create_sysop.pl ``` -------------------------------- ### Install MRTG on Debian Source: https://wiki.dxcluster.org/wiki/Web_based_statistics Run these commands as root to update package lists and install the mrtg package, ensuring all dependencies are installed. ```bash sudo apt-get update sudo apt-get -y install mrtg ``` -------------------------------- ### SPOOF command examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Examples of using the SPOOF command to execute commands as another user, setting name and QRA for G1TLH. ```text SPOOF G1TLH set/name Dirk SPOOF G1TLH set/qra JO02LQ ``` -------------------------------- ### reject/spots sysop filter examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Examples of setting spot filters for a specific callsign, node default, and user default using the sysop version of reject/spots. ```text reject/spot db0sue-7 1 by_zone 14,15,16 reject/spot node_default all set/hops node_default 10 reject/spot user_default by G,M,2 ``` -------------------------------- ### Create local configuration directories and copy DXVars.pm Source: https://wiki.dxcluster.org/wiki/Centos6 Sets up the local configuration directories and copies the distributed DXVars.pm template to local/DXVars.pm for editing. ```bash $ cd /spider $ mkdir local $ mkdir local_cmd $ cp perl/DXVars.pm.issue local/DXVars.pm $ cd local $ vi DXVars.pm (or your favourite editor) ``` -------------------------------- ### accept/spots examples Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/spots filter commands: acc/spot 1 on hf/cw and acc/spot 2 on vhf with zone conditions. ```plaintext acc/spot 1 on hf/cw acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16) ``` -------------------------------- ### Install cpanminus via apt Source: https://wiki.dxcluster.org/wiki/UPDATE.mojo Installs cpanminus using the system package manager on Debian-based systems. This is the first method presented for installing cpanminus. ```bash sudo apt-get install cpanminus ``` -------------------------------- ### DBCREATE chained database example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Defines a chained database 'sdx_qsl' that searches 'sql_ad' after it. No checking is done for existence of chained databases. ```text DBCREATE sdx_qsl chain sql_ad ``` -------------------------------- ### user_default.issue example Source: https://wiki.dxcluster.org/wiki/Scripts Example user_default.issue file. When copied to user_default or a callsign, it delivers initial information to a user at login, showing DX spots, users, WWV, and WCY data. ```plaintext # # standard user default script # blank + sh/dx 5 blank - sh/u blank - sh/wwv 1 blank - sh/wcy 1 blank + # #EOF ``` -------------------------------- ### Export user database to file Source: https://wiki.dxcluster.org/wiki/Restoring_the_user_DB_(Mojo_branch) Run in the sysop console on the origin node. Creates the file /tmp/example_json. ```text export_json /tmp/example_json - (this creates the file /tmp/example_json) ``` -------------------------------- ### accept/announce by prefixes example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/announce filter using the 'by' field to accept announces from prefixes G, M, and 2. ```plaintext acc/ann by G,M,2 ``` -------------------------------- ### Run create_sysop.pl to create initial user files Source: https://wiki.dxcluster.org/wiki/Installing_the_software Run from the \spider\perl directory. Produces no output on success and returns to the DOS prompt. ```shell cd \spider\perl perl create_sysop.pl ``` -------------------------------- ### Install Perl packages with PPM Source: https://wiki.dxcluster.org/wiki/Microsoft_Windows_Installation Use the PPM command-line tool to install the required Perl packages: net-telnet, timedate, and db_file. Run each command separately in a command prompt. ```shell ppm install net-telnet ``` ```shell ppm install timedate ``` ```shell ppm install db_file ``` -------------------------------- ### dbshow lookup example Source: https://wiki.dxcluster.org/wiki/Databases Looks up information for a callsign (G0YLM) from the buckmaster database. ```text dbshow buckmaster G0YLM ``` -------------------------------- ### Create /etc/init/dxspider.conf upstart script (Ubuntu 9.10+) Source: https://wiki.dxcluster.org/wiki/Configuration For Ubuntu 9.10 and later, place this script in /etc/init/dxspider.conf. It uses runlevel [2345] and stop on [!2345]. ```bash #DXSpider startup script # # This service maintains a getty on tty7 from the point the system is # started until it is shut down again. start on runlevel [2345] stop on runlevel [!2345] respawn exec /bin/su - sysop -c "/usr/bin/perl -w /spider/perl/cluster.pl" >/dev/tty7 ``` -------------------------------- ### Scenario: Node-A and Node-B details Source: https://wiki.dxcluster.org/wiki/Create_a_secure_connection_between_nodes Example configuration for two nodes, including callsigns, passwords, hostnames, and ports. ```text Node-A: XX0XX-2 Node-B: ZZ8ZZ-4 password para ZZ8ZZ-4: A49=Dk4T password para XX0XX-2: jTra691R node-a.hams.org node-b.radio.com port 7300 port 8000 ``` -------------------------------- ### Telegram bot token example Source: https://wiki.dxcluster.org/wiki/Sending_messages_to_the_sysop_via_Telegram Example token format returned by BotFather. ```text 1234567890:AAEjg0EjEMPLO_T0KEN4PRUEBA1234 ``` -------------------------------- ### Create upstart configuration /etc/init/dxspider.conf Source: https://wiki.dxcluster.org/wiki/Centos6 Upstart configuration for CentOS 6.x to auto-start the DXspider cluster. Starts on runlevel 3, stops on runlevels 0,1,6, respawns with limit 10 times in 5 seconds, and runs the cluster as sysop user. ```upstart # This service kicks off the DXspider cluster start on stopped rc RUNLEVEL=[3] stop on starting runlevel [016] respawn respawn limit 10 5 exec /bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7 ``` -------------------------------- ### Install perl-IO-Socket-INET6 module Source: https://wiki.dxcluster.org/wiki/Centos6 Install the Perl module required for IPv6 support in Dxspider. ```bash # yum install perl-IO-Socket-INET6 ``` -------------------------------- ### NETRom/AX25 connection script example Source: https://wiki.dxcluster.org/wiki/Configuration Example connection script for a NETRom/AX25 connection. Uses timeout 60, abort regex (Busy|Sorry|Fail), and connect ax25 with /usr/sbin/netrom_call. The client line can be omitted if the script is named 'gb7dxm'. Note the comment to chmod 4775 netrom_call. ```plaintext timeout 60 abort (Busy|Sorry|Fail) # don't forget to chmod 4775 netrom_call! connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh # you can leave this out if you call the script 'gb7dxm' client gb7dxm ax25 ``` -------------------------------- ### Save check_build.pl to local_cmd directory Source: https://wiki.dxcluster.org/wiki/Node_Backup_and_Update_with_check_build Installation path for the check_build.pl script. ```bash /spider/local_cmd/check_build.pl ``` -------------------------------- ### Start the DXSpider cluster with cluster.pl Source: https://wiki.dxcluster.org/wiki/Installing_the_software Launches the cluster. Expected output shows version, loading messages, and startup status. ```shell perl cluster.pl ``` -------------------------------- ### SHOW/MUF example command Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows the next two hours of propagation data for the prefix W. The output assumes 20 dBW power and -123 dBm receiver sensitivity. ```plaintext SH/MUF W ``` -------------------------------- ### Install MySQL/MariaDB Perl library Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Install the Perl library for MySQL or MariaDB database support. ```bash apt install libdbd-mysql-perl ``` -------------------------------- ### Copy Local.pm from base installation Source: https://wiki.dxcluster.org/wiki/Sending_messages_to_the_sysop_via_Telegram Command to copy Local.pm from the base installation if /spider/local/Local.pm does not exist. ```bash cp /spider/perl/Local.pm /spider/local/ ``` -------------------------------- ### SHOW/DX with qsl option Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of using SHOW/DX with the qsl option to check raw input spots for QSL information. ```text sh/dx 4k9w qsl ``` -------------------------------- ### SH/MUF W command example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Shows the command to estimate propagation for prefix W for the default next two hours. The output includes header info, locations, and signal strength predictions. ```text SH/MUF W ``` ```text RxSens: -123 dBM SFI: 159 R: 193 Month: 10 Day: 21 Power : 20 dBW Distance: 6283 km Delay: 22.4 ms Location Lat / Long Azim East Dereham, Norfolk 52 41 N 0 57 E 47 United-States-W 43 0 N 87 54 W 299 UT LT MUF Zen 1.8 3.5 7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0 18 23 11.5 -35 mS0+ mS2 S3 19 0 11.2 -41 mS0+ mS2 S3 ``` -------------------------------- ### reject/wwv example filter Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example reject/wwv filter that only shows WWV broadcasts by stations in the US. ```text reject/wwv by_zone 14,15,16 ``` -------------------------------- ### accept/wwv by_zone example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example accept/wwv filter that only shows WWV broadcasts by stations in the US. ```text accept/wwv by_zone 4 ``` -------------------------------- ### accept/spots sysop filter examples Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Shows how to set spot filters for a specific callsign, node default, and user default using the sysop version of accept/spots. ```text accept/spot db0sue-7 1 by_zone 14,15,16 accept/spot node_default all set/hops node_default 10 accept/spot user_default by G,M,2 ``` -------------------------------- ### accept/announce example filters Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Examples of accept/announce filters for specific destinations, zones, prefixes, and states. ```text acc/ann dest 6MUK acc/ann 2 by_zone 14,15,16 (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16) ``` ```text acc/ann by G,M,2 ``` ```text acc/ann by_state va,nh,ri,nh ``` ```text acc/ann all ``` -------------------------------- ### Add universe and multiverse repositories and update apt Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Run these commands as root to enable the universe and multiverse repositories and update the package list. Required for installing packages from these repositories. ```bash sudo add-apt-repository universe sudo add-apt-repository multiverse sudo apt update ``` -------------------------------- ### accept/spots by_state example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/spots filter for US states using the by_state field. ```plaintext acc/spots by_state VA,NH,RI,MA,ME ``` -------------------------------- ### accept/announce by_state example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example accept/announce filter for American states using the by_state field. ```plaintext acc/ann by_state va,nh,ri,nh ``` -------------------------------- ### Create connect script for peer node Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Create a connect script by copying the example gb7tlh to your peer node name, then edit it to set the correct telnet address, port, and callsign. ```bash $ cd /spider/connect/ $ cp gb7tlh ``` -------------------------------- ### Sample output when there is a change Source: https://wiki.dxcluster.org/wiki/Updating_Public_IP_and/or_Local_IPs_(set/update_ip) Shows the output when there is a change to public or local IPs. ```text Public IPv4 change: 2.2.2.2 → 1.1.1.1 Public IPv6 change: Local IPs changes: 127.0.0.1 ::1 172.18.0.3 192.168.1.22 ``` -------------------------------- ### Create /etc/event.d/dxspider upstart script (Ubuntu 6.10+, Fedora Core 9+) Source: https://wiki.dxcluster.org/wiki/Configuration For systems using upstart (Ubuntu from 6.10, Fedora Core from 9), create this file at /etc/event.d/dxspider to start DXSpider on runlevels 2 and 3, and respawn it if it crashes. ```bash #DXSpider startup script # # This service maintains a getty on tty7 from the point the system is # started until it is shut down again. start on runlevel 2 start on runlevel 3 stop on runlevel 0 stop on runlevel 1 stop on runlevel 4 stop on runlevel 5 stop on runlevel 6 respawn exec /bin/su - sysop -c "/usr/bin/perl -w /spider/perl/cluster.pl" >/dev/tty7 ``` -------------------------------- ### Telegram getUpdates response example Source: https://wiki.dxcluster.org/wiki/Sending_messages_to_the_sysop_via_Telegram Example JSON snippet from the getUpdates response showing the chat ID. ```json "chat":{"id":123456789,"first_name":"YourName",...} ``` -------------------------------- ### Become root with sudo su - Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Login as the user created during installation and become root to perform administrative tasks. ```bash $ sudo su - ``` -------------------------------- ### JOIN command example Source: https://wiki.dxcluster.org/wiki/DXSpider_Sysop_Command_Reference Example of joining a conference group named FOC using the JOIN command. ```plaintext JOIN FOC ``` -------------------------------- ### Set @main::localhost_names with qw() option Source: https://wiki.dxcluster.org/wiki/Configure_Node_with_more_than_one_local_IP_(Mojo_branch) Alternative syntax using qw() to simplify the list. Works the same as the list version. Can define as many IP addresses as needed, IPv4 or IPv6. ```perl set/var @main::localhost_names qw(127.0.0.1 ::1 192.168.1.30 172.16.0.20) ``` -------------------------------- ### ECHO simple example and output Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Shows a simple ECHO command and its output, demonstrating that no trailing newline is needed. ```text echo GB7DJK is a dxcluster ``` ```text GB7DJK is a dxcluster ``` -------------------------------- ### JOIN command example Source: https://wiki.dxcluster.org/wiki/DXSpider_User_Command_Reference Example of joining a conference group named FOC using the JOIN command. ```plaintext JOIN FOC ``` -------------------------------- ### Create local directories Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Create local directories for custom commands, data, and configuration. ```bash $ mkdir local_cmd $ mkdir local_data $ mkdir local ``` -------------------------------- ### Install Date:Manip with cpanm Source: https://wiki.dxcluster.org/wiki/List_of_nodes_for_mobile_use Alternative installation method for the Date:Manip Perl module using cpanm. ```bash # Alternative cpanm install Date:Manip ``` -------------------------------- ### Copy Listeners.pm to local Source: https://wiki.dxcluster.org/wiki/Ubuntu_24.04 Copy the Listeners.pm file to the local directory for configuration. ```bash $ cp perl/Listeners.pm local/ ``` -------------------------------- ### Example xinetd process output Source: https://wiki.dxcluster.org/wiki/Setting_up_the_AX25_Utilities Example output from the ps command. The PID is the first number after the user; here it is 592. ```text root 592 0.0 0.1 2256 620 ? S Feb07 0:00 xinetd -stayalive -reuse -pidfile /var/run/xinetd.pid ``` -------------------------------- ### Startup file path Source: https://wiki.dxcluster.org/wiki/Node_configuration_for_user_access Path to the startup file that must be edited to make variable changes permanent across node restarts. ```text /spider/scripts/startup ```