ServerOS Documentation
website·Indexed 30 days ago
https://docs.serversolutions.io/A server delivery and management platform designed to upgrade delivery workflows and accelerate server sales. Documentation covers hardware and environment requirements, installation, port requirements, and integrations with WHMCS, HostBill, Andrisoft Wanguard, and FastNetMon Advanced, as well as troubleshooting for IPMI (iDRAC 8/9), RDP, and CentOS 7 Yum.
What's inside ServerOS
- ServerOS supports the installation of multiple controllers across different data centers. This allows administrators to control devices in multiple physical locations from a single centralized management platform.
Resolve 'wget: command not found' error during installation
The 'wget: command not found' error occurs when the wget package is not installed on the system. Install it using the package manager corresponding to your OS.# For CentOS / AlmaLinux / RockyLinux / Fedora yum install wget -y # OR dnf install wget -y # For Debian / Ubuntu apt update apt install wget -yPrerequisites for installing Docusaurus
To run Docusaurus, you must have Node.js version 18.0 or above installed. It is recommended to check all checkboxes related to dependencies during the Node.js installation process.Perform clientless remote access via Embedded Bastion
The embedded bastion host allows administrators to initiate RDP, SSH, or Telnet connections directly from the server or switch management pages without needing a local client. All operational behaviors are recorded and support playback for auditing.Install Wanguard API for ServerOS integration
To integrate Wanguard with ServerOS, thewanrestapipackage must be installed on the server where the Wanguard console is located. Ensure that the ServerOS installation server can communicate with the Wanguard server.# CentOS / RockyLinux / AlmaLinux yum install wanrestapi -y # If yum is unavailable, try dnf dnf install wanrestapi -y # Debian / Ubuntu apt update apt install wanrestapi -yGenerate a new Docusaurus site using the classic template
You can create a new Docusaurus site with the classic template by running thenpm initcommand. This command automatically sets up the project structure and installs all necessary dependencies.npm init docusaurus@latest my-website classicInstall the ServerOS Bandwidth Chart module for WHMCS
This module provides binding functionality between products and traffic charts in WHMCS, which is particularly useful for services like IP Transit. To install: download the package, extract it, locate the archive corresponding to your specific PHP version, and upload/extract that archive into your WHMCS directory.Start the Docusaurus development server
After generating a site, navigate into the project directory and run the start script. This builds the website locally and serves it at http://localhost:3000/. The server supports hot-reloading, meaning changes to files (such asdocs/intro.md) are displayed automatically without a manual restart.cd my-website npm run startChoose a network configuration for ServerOS
ServerOS supports three network setup schemes depending on the available hardware and security requirements:
- Single Port: A single port handles External, IPMI, and Management networks. Simple setup, but lacks isolation and may be slow during peak delivery.
- Single Port (VLAN): A single port handles External, IPMI, and Management networks via VLANs. Provides full network isolation with simple hardware, but may be slow during peak delivery.
- Dual Port: First port is dedicated to External traffic; second port handles IPMI and Management networks. Provides full isolation and ensures administrator operations are not affected during peak delivery.
Install operating systems via ServerOS
ServerOS supports a wide range of operating systems for installation.
Linux (supports installation without ISO files):
- CentOS 6, 7, 8, Stream 8, Stream 9
- AlmaLinux 8, 9
- RockyLinux 8, 9
- OpenEuler 22 LTS
- Debian 8, 9, 10, 11, 12
- Ubuntu 14.04, 16.04, 18.04, 20.04, 22.04 LTS
- Proxmox VE 6, 7, 8
- VMware ESXi 5, 6, 7, 8
- Xenserver
Windows:
- Original ISO installation (Vista and newer)
- .wim/.esd installation (Vista and newer)
- .gho Ghost installation (Windows Server 2003 and newer)
Automate CentOS 7 Yum repository switching
To automate the fix for CentOS 7 Yum repositories during system image deployment, use a script to update thebaseurlin the repository configuration files. You must choose aMIRROR_DOMAINbased on the server's location: usemirrors.ustc.edu.cn/centos-vaultfor Mainland China orvault.centos.orgfor global access.# China Mainland - 中国 MIRROR_DOMAIN="mirrors.ustc.edu.cn/centos-vault" # Global - 国际 (Uncomment the line below and comment the China line to use) # MIRROR_DOMAIN="vault.centos.org" MIRROR_ALTARCH_DIR="centos-altarch" if [ "$MIRROR_DOMAIN" != "vault.centos.org" ];then MIRROR_ALTARCH_DIR="altarch" sed -i.bak \ -e 's|^#baseurl=http://vault.centos.org|baseurl=http://'$MIRROR_DOMAIN'/centos|g' \ /etc/yum.repos.d/CentOS-Vault.repo fi; sed -i.bak \ -e 's|^#\?mirrorlist=|#mirrorlist=|g' \ -e 's|^#\?baseurl=http://mirror.centos.org/centos|baseurl=http://'$MIRROR_DOMAIN'/centos|g' \ -e 's|^#]?baseurl=http://mirror.centos.org/altarch/|baseurl=http://'$MIRROR_DOMAIN'/'$MIRROR_ALTARCH_DIR'/|g' \ /etc/yum.repos.d/CentOS-{Base,fasttrack,CR}.repoReset operating system passwords
ServerOS supports password resets for the following systems:
- All versions of CentOS, AlmaLinux, RockyLinux, and OpenEuler
- All versions of Debian and Ubuntu
- All versions of Proxmox VE, VMware ESXi, and Xenserver
- All Windows systems from Windows XP onwards
- All Windows Server systems from Windows Server 2003 onwards