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.

Tokens
5.6K
Snippets
19
Records
50
Agent score
48%

What's inside ServerOS

  1. Manage multi-datacenter deployments with ServerOS Controllers

    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.
  2. 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 -y
  3. Prerequisites 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.
  4. 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.
  5. Install Wanguard API for ServerOS integration

    To integrate Wanguard with ServerOS, the wanrestapi package 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 -y
  6. Generate a new Docusaurus site using the classic template

    You can create a new Docusaurus site with the classic template by running the npm init command. This command automatically sets up the project structure and installs all necessary dependencies.
    npm init docusaurus@latest my-website classic
  7. Install 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.
  8. 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 as docs/intro.md) are displayed automatically without a manual restart.
    cd my-website
    npm run start
  9. Choose a network configuration for ServerOS

    ServerOS supports three network setup schemes depending on the available hardware and security requirements:

    1. Single Port: A single port handles External, IPMI, and Management networks. Simple setup, but lacks isolation and may be slow during peak delivery.
    2. 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.
    3. 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.
  10. 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)
  11. Automate CentOS 7 Yum repository switching

    To automate the fix for CentOS 7 Yum repositories during system image deployment, use a script to update the baseurl in the repository configuration files. You must choose a MIRROR_DOMAIN based on the server's location: use mirrors.ustc.edu.cn/centos-vault for Mainland China or vault.centos.org for 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}.repo
  12. Reset 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