View Source

Problem

The CAS GUI is unavailable; the website cannot be reached.

The "Admin" service is one of two critical services that run on your hosted server. The admin service enables remote browser access for administration of your CAS settings.

If you cannot connect to CAS using your web browser, then the problem may lie within your CAS server.

note

BATMs do not use or rely on the Admin service. If the GUI is available, abandon this article.

See instead: Master Service Issues

BATMs do not use or rely on the Admin service. If the GUI is available, abandon this article.

See instead: Master Service Issues

Solutions:

If the Admin service is disrupted, your BATMs will continue to operate, but you won't be able to view or make changes to their settings remotely. Here are some solutions to the most common problems.

The underlying cause of this type problem may arise in one of five areas:

General Bytes Knowledge Base > Admin Service Issues > Data Flow Admin.jpg

Your computer, your router, your internet provider, your CAS host, or your CAS server may be down (or any combination of these possible failure points).

1. Check your browser:

Read this article regarding insecure connections: Insecure Browser Connections

If you've never used CAS before, be sure to read the article.

2. Check your server's internet address:

From your server's command line interface (CLI), copy/paste or type:

wget -qO - ipv4.icanhazip.com

You should receive an immediate reply with your public IP address.
- Note this IP - you’ll need it for the next step.

It should match the IP address reported using:

hostname -I

If the same numbers are NOT listed, then you are behind a router/firewall.

Configure your firewall to forward ports 7741 and 7777 to your server!
Use your router’s IP as the Server IP setting for your BATMs.
This is also the case when using Microsoft Azure, AWS, or GCP.

3) Check your CAS services:

First, identify if the Admin service is running. From your server's command line interface (CLI), type:

sudo /batm/batm-manage info

The status of the Master and Admin services (running/stopped) should be displayed.

Ensure that your public IP address (as identified in Step 2) is correct!

If the public IP address is WRONG, then copy/paste (or type):

sudo echo "public_ip="$( wget -qO - ipv4.icanhazip.com ) > /batm/config/network

Alternatively, manually edit the IP in the "/batm/config/network" file.

If you open a support ticket, include all the listed information.

Send a screenshot or picture of this info.

4. Try restarting the Admin service:

sudo /batm/batm-manage start admin

Permit the service time to startup (90+ seconds)
Use the "info" command again to see if it is working:
- sudo /batm/batm-manage info

5. Examine the logging for errors:

If the admin service still won’t start, the explanation will almost always be caught in the logs.

Start the admin service using this special command:

sudo /batm/batm-manage fg admin

the admin service will attempt to start - but it will display ALL messages onscreen - successes AND failures. Not all failures are unexpected or unwanted; they are merely reporting tools and the information is used for complex debugging.
Errors reported towards the end are the most relevant.

If the admin service is started without the “fg" switch (using “start"), then the admin log will be concatenated to any previous admin log, and can be examined by typing:

sudo cat /var/log/batm/admin.log

6. CAS is designed to run on UBUNTU LTS ONLY.

NO OTHER SOFTWARE SHOULD INITIALLY BE RUNNING ON YOUR SERVER.

THIS INCLUDES APACHE, NGINX, OR ANY OTHER WEB SERVER!
Follow these instructions.

7. Ensure that your server meets the minimum requirements.

Our recommended configurations are tested over and over.

a. Doublecheck the directions:

See: CAS CLI Installation

b. Check that you have enough free space on your drive:

sudo df -h
Should report at least 5GB free drive space for both services to run reliably.

c. Ensure that any server firewalls are properly configured:

See: Configuring Server Firewalls

8. Disable any loaded custom extensions.

A custom extension may cause the admin service to stop. If you’ve tried everything else, disable any custom extensions that you’ve installed. If you’ve never installed an extension - then there’s nothing to disable - but if you have? Try disabling it to eliminate it as a possible cause.

Instructions: https://generalbytes.atlassian.net/l/cp/hd1zafYZ

9. If you've covered these steps and still have problems, contact support .

Include the results of "batm-manage info"

Other potential causes include:

CPU overloading, resulting in random intermittent server reboots,
- Insufficient memory,
- Hardware failure,
- Attacks by malicious actors overloading your server.
These problems are outside the scope of General Bytes support.
Please contact your hosting provider or a third-party trusted vendor to address server issues and/or required upgrades. Watch your server usage graphs (if available). Use the "top" utility to watch processor load. It should stay well below 50% on a normal system.