Code Monkey home page Code Monkey logo

asl-install's Introduction

ASL-Install

This project was [originally] focused on the steps needed to build, install, and configure an AllStarLink node running on a virtual machine [VM] in the cloud.

That focus has not precluded efforts to support other deployments (e.g. a DELL Wyse 3040 and Raspberry Pi running Debian).

Target Operating System(s)

This package has been tested on :

  • Amazon Linux 2023
  • Debian 12.5 "bookworm"
  • Ubuntu 22.04 LTS "jammy"

I have had success using the Raspberry Pi Imager application, selecting :

Raspberry Pi Device : "Raspberry Pi 4"
Operating System    : "Raspberry Pi OS (other)", "Raspberry Pi OS Lite (64-bit)"

Packages installed

Initial Setup (Amazon Linux 2023)

# install git
sudo yum update
sudo yum install -y git

Initial Setup (Debian 12.5 "bookworm")

# install git
sudo apt update
sudo apt upgrade -y
sudo apt install -y git
sudo apt autoremove -y

Initial Setup (Ubuntu 22.04 LTS "jammy")

# install git
sudo apt update
sudo apt upgrade -y
sudo apt install -y git
sudo apt autoremove -y

Pre-installation notes (all OS's)

  • If the above pre-installation commands (e.g. sudo apt upgrade) resulted in the kernel being updated then you should reboot the system before proceeding.

Installation (all OS's)

# download this repository
git clone https://github.com/Allan-N/ASL-Install.git

# build and install AllStarLink
cd ASL-Install
./asl-install.sh

The asl-install.sh script should present you with a menu of the steps needed to build, install, and configure a node. Execute each step, in order, at least one time.

When finished, the script will suggest that you reboot the system. Unless you know that the changes you made would not affect the running configuration then please consider that to have been a strong suggestion.

Note: to update your local copy of the repository you can use the git pull command

Tidbits

Many of the AllStarLink/Asterisk commands (e.g. asl-menu, astres.sh, etc) are installed in the /usr/sbin directory. One of the gotchas with [Debian] installs is that the default search PATH does not include this directory. You can update your default path by updating the "~/.profile" file in your home directory. As an example, I have updated my file to look like :

...
# if running bash
if [ -n "$BASH_VERSION" ]; then
    # include .bashrc if it exists
    if [ -f "$HOME/.bashrc" ]; then
        . "$HOME/.bashrc"
    fi
fi

# update PATH (WA3WCO)                                               <--- ADDED
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"  <--- ADDED
...

Other useful commands

To update the hostname

hostnamectl
sudo hostnamectl set-hostname ASL-WA3WCO

To update the timezone

timedatectl
timedatectl list-timezones
sudo timedatectl set-timezone America/New_York

To check the networking subsystem

networkctl status

Configuration options

To turn off the telemetry that announces nodes being connected/disconnected you can make the following changes to the /etc/asterisk/rpt.conf file :

Change "holdofftelem" from "0" to "1"
Change "telemdefault" from "1" to "2"

... and some of my favorite packages

  • apt-file

    APT package searching utility

     sudo apt install -y apt-file
     sudo apt-file update
    
  • avahi-daemon

    The Avahi mDNS/DNS-SD daemon (Apple's Zeroconf architecture (also known as "Bonjour")

     sudo apt install -y avahi-daemon
     sudo cp /usr/share/doc/avahi-daemon/examples/ssh.service /etc/avahi/services
    
  • mlocate

    find files by name, quickly (e.g. locate asl-menu)

     sudo apt install -y mlocate
     sudo updatedb
    

Authors

  • Allan Nathanson, WA3WCO

asl-install's People

Contributors

allan-n avatar dandrzejewski avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.