EzUGCC for Linux

Post Reply
Masher
Site Admin
Posts: 3612
Joined: Thu Apr 20, 2006 2:54 pm
Location: America's Heartland
Contact:

EzUGCC for Linux

Post by Masher »

EzUGCC for Linux is an ISO install image for quickly setting up a Linux box with UGCC pre-installed. This should be very useful for testing our panel or for production use. The ISO should work on physical systems and virtual machines without issue.

Requirements
  • BIOS or UEFI based system (ensure you download the correct ISO)
  • x64 bit based CPU
  • 20GB hard drive (you’ll need more if you want to setup servers)
Install
  • Download the ISO, burn it to disk or use an ISO to USB tool to copy it to a thumb drive. Or mount the ISO in a VM.
  • Boot from the ISO/USB media.
  • For MBR ISO, choose the Automatic Recovery option at the boot menu
  • For EFI ISO, choose the Relax-and-Recover option at the boot menu, login as root, and run 'rear recover'
  • Follow prompts. It's safe to accept the default options presented to you, but tweak as you see fit.
  • Once the restore is complete reboot.
  • Login with the root user (if prompted for a password use 'password'), you'll be prompted to set your password.
  • The username/password for the panel is admin/admin and is running on port 80.
Post install tasks (important):
  • If networking does not work out of the box use the 'nmtui' command to setup an Ethernet connection.
  • Browse to the IP address of the server to verify you can access the panel. Optionally visit the Check.aspx page to make sure all tests pass.
  • Update the system by running 'yum update' or 'dnf update' on CentOS 8. A reboot is recommended once completed. It's recommended you do this periodically to keep the operating system up to date with the latest bug and security fixes.
  • Update the panel to the latest version by running the update-ugcc.sh script in /root. See Upgrading section below for more information.
Upgrading
  • A script to update the panel is located in root's home folder. When you login to a shell you should be placed in this folder by default.
  • Review the update release notes for any important information or procedures that may need to be done pre or post upgrade
  • run './update-ugcc.sh' to start the updater. It will check for updates and automatically install them for you.
  • It also does a full backup of the /ugcc folder before installing updates incase you need to restore. These backups are saved in the /root folder.
Notes
  • A newer Centos 8 image was released October 2020, we decided we'll only maintain a UEFI version going forward, but will keep the legacy/mbr based OEL 7 image available for those without an UEFI system.
  • All the panel associated files are in /ugcc. The web panel files are located in /var/www/html. /ugcc/www symlinks to /var/www/html.
  • The firewall service and selinux have been disabled.
  • This uses a sqlite database for lower resource consumption and simpler deployment.
  • MySQL can be used by modifying the panel's configuration files in /ugcc/www/Web.config, and /ugcc/mon/ugccmon.cfg
If you run into any issues, have questions or suggestions on how we can improve this please let us know via the forums.
Last edited by Masher on Sat Sep 14, 2019 8:52 am, edited 2 times in total.
Masher
-----------
Please do not PM me unless asked to! We are a small company. If you have an issue or question it would be best to post it in the forums where it can help others in the future.

NEW Join our Discord!
Post Reply