...
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:
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 |
|---|
Do not proceed Contact Support if:
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.
...