Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Here are the steps on how to download GENERAL BYTES public key that your machine will always trust when downloading new software packages from GENERAL BYTES.

Note

KYC is now required by GB!

Access to the private APT repository is provided only to our Operators that:

  1. undergo additional KYC checks, and

  2. have paid all current invoices.

Please contact the Sales department if you cannot access the package repository during CAS installation or CAS update.

1. Download the repository public key to your key rings folder.

Run the following command to download the public key:

Code Block
sudo wget -O /usr/share/keyrings/generalbytes-repo.public https://trust.generalbytes.com/generalbytes-repo.public

2. Check the digital signature of the downloaded public key.

Make sure that the public key has the correct checksum.

...

Code Block
6f65c52005425872acd880cbf9c3975fdc1db45fc85b60ef981482cead51746b  /usr/share/keyrings/generalbytes-repo.public

3. Compare the checksum of GENERAL BYTES public key from the repository.

Code Block
sudo wget -q -O - https://packages.generalbytes.com/generalbytes-repo.public | sha256sum

...

Code Block
6f65c52005425872acd880cbf9c3975fdc1db45fc85b60ef981482cead51746b  -

...

4. Verification

Note

Contact Support if:

  • any of the steps fail, or

  • the checksum is invalid, or

  • the checksums differ.

Continuing may result in the installation of an untrusted key and subsequently: untrusted software in the future.

5. Add the generalbytes repository to APT

For installation and updates, the repository must be specifically added to the Ubuntu system.

Create the repository file:

Code Block
sudo touch /etc/apt/sources.list.d/generalbytes-repo.list

Edit the new file using nano:

Code Block
sudo nano /etc/apt/sources.list.d/generalbytes-repo.list

...

Add the following line to the file:

Code Block
deb [arch=amd64 signed-by=/usr/share/keyrings/generalbytes-repo.public] https://packages.generalbytes.com/LICENSE ./stable main
  • Replace “LICENSE” with your actual GENERAL BYTES approved license key.

Example:

...

  • Save and exit the nano editor (Press Ctrl+X, and answer “Y” when asked to save the file).

If you prefer to do it in a single line, use this script:

Code Block
read -p"Enter your license number and press ENTER:" LL && [ "$LL" == "" ] && echo "bad lincence number try again" || sudo sh -c  "echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/generalbytes-repo.public] https://packages.generalbytes.com/$LL ./stable main' > /etc/apt/sources.list.d/generalbytes-repo.list"

6. Update the Ubuntu system repository.

Code Block
sudo apt update

...

Troubleshooting

The license issued by GENERAL BYTES may be revoked without warning.

If your license fails to be accepted during an APT update, CAS update, or CAS installation, please contact Sales to ensure that your account is in good standing.

...

Removal

The changes made to APT will prevent APT from installing updates - including security updates - if the license is invalid for any reason. If you continue to use the server (without CAS), then you should remove the modifications to your Ubuntu.

DO NOT DO THIS UNLESS REQUIRED!

To temporarily disable the GB APT Repository:

Rename this file:

Code Block
sudo mv /etc/apt/sources.list.d/generalbytes-repo.list /etc/apt/sources.list.d/generalbytes-repo.list~

Re-enable the file when you’re ready to update CAS:

Code Block
sudo mv /etc/apt/sources.list.d/generalbytes-repo.list~ /etc/apt/sources.list.d/generalbytes-repo.list

To permanently remove the GB APT repository:

Code Block
sudo rm /usr/share/keyrings/generalbytes-repo.public
sudo rm /etc/apt/sources.list.d/generalbytes-repo.list
sudo apt update

...

Viewing patch availability:

You might want to check if a patch is available before shutting down CAS and upgrading. You can do this while CAS is up.

Code Block
apt update && apt show -a batm-server-upgrade-20240201
  • where the version sought is 20240201

...

The current patch versions will be displayed.

...