SuperAdmin / 06. Troubleshooting
Updated: 25. March 2018
Author: Peter Širka

06. Troubleshooting

Professional Support Chat with contributors

FAQ


SSL certificate is expired for SuperAdmin

If your SSL has been expired just login to your server via SSH (you need be under root privileges) and write into the terminal:

# Open app directory
$ cd /www/superadmin/

# Renew SSL
$ bash ssl.sh superadmindomain.yourdomain.com --renew

# Test NGINX configuration
$ nginx -t

# Reload NGINX configuration
$ nginx -s reload

How can I restart SuperAdmin?

You need to restart it manually on the server. Just login to your server via SSH (you need be under root privileges) and write into the terminal:

# Open app directory
$ cd /www/superadmin/

# Run SuperAdmin
$ bash run.sh

The command stops SuperAdmin (if ran) and start it again.


How can I upgrade SuperAdmin to newest version?

  • back up file /databases/applications.json
  • back up your credentials in /config file (only credentials, nothing more)
  • download source-code of SuperAdmin from my.totaljs.com
  • copy all directories and files from a new version of SuperAdmin to your server
  • restore your backup file /databases/applications.json
  • restore your credentials in /config
  • install ftp helper via $ apt-get install -y ftp
  • you need to update SSL generator to the latest version via bash /www/superadmin/ssl.sh --update
  • restart SuperAdmin bash run.sh
  • clear cache in your web browser

IMPORTANT:
If you have lower version than v7.0.0 then replace /etc/nginx/nginx.conf for /superadmin/nginx.conf.


How can I uninstall SuperAdmin from my server?

  • you need to kill SuperAdmin and stop all Total.js applications:
$ kill -9 $(ps aux | grep "total" | awk {'print $2'}) > /dev/null
  • then remove /www/ directory
  • restore old nginx configuration, it's stored as /etc/nginx/nginx.conf.backup
  • remove a cron job according to this result $ crontab -l
  • done

Can I use own nginx configs?

Of course. SuperAdmin doesn't limit you with nginx and you can create own nginx configs out of SuperAdmin, just add your nginx config to the directory below:

  • /www/nginx/ directory
  • and perform nginx reload $ nginx -s

Where are stored certificates, websites and configs?

All data are stored in /www/ directory:

  • SSL certificates /www/ssl/
  • Nginx configs /www/nginx
  • Logs /www/logs/
  • Websites /www/www/
  • SuperAdmin /www/superadmin/

Can I provide SuperAdmin on another Linux distribution than Ubuntu?

Yes, but we have tested it on Ubuntu Server only. Some developers provide SuperAdmin on Debian distributions, but we don't have any experience with it.


How does monitoring work?

Each Total.js applications need to depend on monitor module. Follow module install instructions. If you have monitor module installed then add URL to monitoring to your app in SuperAdmin:

Monitoring


Can I use SuperAdmin in commercial projects?

Of course, we don't limit you. Premium SuperAdmin is under MIT license and you can use it everywhere or sell it to your end-customers.


Which applications are needed for SuperAdmin?

Install requirements:

  • Ubuntu Server +v14
  • curl
  • openssl

SuperAdmin requirements:

  • awk
  • bash
  • cat
  • cp
  • df
  • du
  • free
  • ftp
  • grep
  • ifconfig
  • last
  • lsof
  • mkdir
  • netstat
  • npm
  • ps
  • tail
  • tar
  • unzip
  • uptime
  • wc
  • zip

A problem with generating of SSL certificates

If you have a problem with generating SSL certificates, try to check your DNS records for IPv4 and IMPORTANT: IPv6 address. ACME checks IPv6 first and then it checks IPv4.