A valid CAS license key from General Bytes (order here)
RAM is a critical part of seamless operation in this application – “the more, the merrier” when it comes to that component.
We ask you to use Ubuntu 22.04 LTS for the sake of support ease and consistency. Other flavors of Linux may work, but General bytes' products and this guide are focused around known quantities.
Ubuntu LTS versions 20.04 and 22.04 are currently supported.
These installation instructions are based on the images available on Digital Ocean. Images sourced from ISO’s (or other VPS providers) may not work as expected.
If you choose an alternate OS, you may find yourself handling your own problems without much guidance (if you can even get the software installed & operating)!
This guide presumes you've installed a bare Ubuntu 22.04 LTS OS, without any additional software aside from perhaps a distribution upgrade. This guide further presumes root access, and sudo may be required (yet omitted) in some examples supplied below. This guide assumes root for all commands. Security is also assumed. You are running a currency exchange and hackers would love to gain access to your funds. Make it hard for them! Spend some time learning the best practices for your digital security, and implement those practices! So, let's get going.
First: Login to your server.
You must access your “headless” Linux server using SSH.
Using Linux or Mac, this is rather straightforward. Open a terminal window and SSH into your server:
On a Windows machine, you have a couple choices - but none are built-in.
PuTTY is a little dated, but still used by millions.
Regardless of what you use, implement SSH keys (on your server) and disable passwords – remember: people want to steal your money! Password authentication usually makes that easier.
You should be looking at a CLI logged in as root on your web server before you proceed further.
“sudo” may be required for some commands below (if you’re not logged in as “root”).
Prepare your server
Update your Ubuntu:
Your Ubuntu software is obsolete out-of-the-box. You’ll need to update your installation immediately before proceeding further (and weekly thereafter).
sudo apt update && sudo apt dist-upgrade
when asked, “Do you want to continue? [Y/n] y" reply “y”.
if asked, “keep the local version currently installed” is safe (at this point).
press Enter (when requested) to accept the default answers to any queries (allow the update process to do whatever it suggests). There may be several of these messages.
Adjust your timezone:
Your reports and logs will be based on the current timezone, which is typically UTC (by default). Set your server to the correct timezone to enable accurate reporting.
sudo dpkg-reconfigure tzdata
Enable the UFW Firewall
A firewall should be enabled and active before installing CAS. Malicious actors may setup a bot to watch certain IP ranges. During your installation, that bot may manage to infiltrate your system in the few seconds it is unexposed - so lock it up before you go any further installing CAS.
Finally, complete the last step of CAS software installation:
sudo /opt/batm/batm-install finish
You’ll be asked to enable “telemetry”. In this context, you’re being asked to permit BATM error logs to be automatically sent to the GB servers. “Telemetry” does not imply that GB can access your BATMs remotely to collect this data - this is not (currently) the case. Do not be alarmed.
After answering the “telemetry” question, the version installed will be displayed.
This version may not be the current version.
The “latest version” - may not be. In this example, the installed version IS NOT the latest version.
Update your CAS
The version installed may not be the latest stable version.
Follow this guide to install the latest version and/or patch:
Be patient. Initial startup may take 15-20 minutes.
Make sure you have enough RAM. During startup, the initialization routine will max out your CPUs and insufficient RAM will result in a bottleneck. Your system may terminate one (or both) of your services - and your server won’t serve.