VEOS installation and configuration [Документация VAS Experts]
Документация VAS Experts Документация VAS Experts-mobile
in

Settings

  • Show page
  • Backlinks
  • Show page
  • Backlinks

    • Differences

    This shows you the differences between two versions of the page.

    Link to this comparison view

    Both sides previous revisionPrevious revision
    Next revision    		Previous revision
    en:veos:installation [2023/08/29 07:59] – elena.krasnobryzhen:veos:installation [2026/05/28 15:46] (current) – created elena.krasnobryzh
    Line 1: Line 1:
    -====== Installation ======+======VEOS installation and configuration======
     {{indexmenu_n>2}} {{indexmenu_n>2}}
    -===== ISO Links ===== 
    -  - [[https://repo.vasexperts.com/veos/8.7/isos/x86_64/VEOS-8.7-x86_64-Minimal.iso|VEOS 8.7 Sakhalin]] ([[https://repo.vasexperts.com/veos/8.7/isos/x86_64/checksum|SHA-256 checksum]]) for minimal installation. 
    -  - [[https://repo.vasexperts.com/veos/8.6/isos/x86_64/VEOS-8.6-x86_64-minimal.iso|VEOS 8.6 Valaam]] ([[https://repo.vasexperts.com/veos/8.6/isos/x86_64/checksum|SHA-256 checksum]]) for minimal installation. 
      
     +=====1. Requirements for VEOS installation=====
     +====1.1. Hardware requirements====
     +Before mounting the server into the rack, make sure it meets the **required specifications**:
     +  * [[en:dpi:dpi_brief:dpi_requirements|Requirements for SSG]]
     +  * [[en:dpi:dpi_components:dpiui:hardware_recommendations|Requirements for GUI]]
     +  * [[en:dpi:qoe_analytics:implementation_administration:requirements|Requirements for QoE]]
      
     +:!: If any discrepancies are identified at this stage, contact [[en:dpi:techsupport_info:start|VAS Experts technical support]] for a prompt resolution.
      
    -===== Preparation of the installation USB memory stick ===== +====1.2. Disk partitioning requirements==== 
    -The currently most popular way to install an operating system on your computer is to install from a USB memory stick.+Disk partitioning for SSG software: 
     +  * ~20 GB for the root partition. 
     +  * Allocate the remaining space to the ''/var'' directory. 
     +  * SSG does not use a SWAP partition directly, but it is required for system tasks. Allocate 4 GB for it.
      
    -<note warning>Do not use popular USB disk burning programs such as Rufus, Unetbootin, Multibootusb and Universal USB Installer – the VEOS installer WILL NOT work, as these programs do not properly copy the installation ISO image</note> +Use the GPT partition table type.
    -To create a Linux/Unix installation USB disk, run the dd command: +
    -  > dd if=VEOS-8.6-x86_64-minimal.iso of=/dev/sdz+
      
    -<note important>When writing, specify the entire disk, not the partition on it (i.e. /dev/sdz, but not /dev/sdz1)</note>+=====2. Preparing for VEOS installation===== 
     +====2.1. Server preparation==== 
     +  * Disable Hyper-threading in BIOS for SSG software! 
     +  * Configure the server for maximum performance
      
    -You can download DD for Windows [[http://www.chrysocome.net/dd|here]].+====2.2. Creating bootable media==== 
     +=== ISO links === 
     +  * [[https://repo.vasexperts.com/veos/8.10/isos/x86_64/VEOS-8.10-x86_64-Minimal.iso|VEOS 8.10 Olkhon]] ([[https://repo.vasexperts.com/veos/8.10/isos/x86_64/checksum|SHA-256 checksum]]) for minimal installation
      
    -If using dd for Windows, run dd --list and look carefully at the list of NT Block Device Objects and use the one that looks like \\?\Device\Harddisk1\Partition0 where the description is something like Removable media other than floppy. Block size = 512. Be very careful about which output device you pick or you may overwrite something you did not intend to! +[[en:veos:installation:archived_versions]]
      
     +=== Method 1. Preparing a bootable USB drive ===
     +The most common way to install an operating system today is using a bootable USB drive.
      
    -===== Preparation of the installation disk ===== +<note warning>Do not use popular USB writing tools such as Unetbootin, Multibootusb, or Universal USB Installer — the VEOS installer **WILL NOT** work because these tools incorrectly copy the installation ISO image.</note>
    -The most common way to install an operating system on a computer is to install from an installation DVD.+
      
    -==== Recording a disk image in the MS Windows operating system ==== +== Writing a USB drive on Linux ==
    -An ISO disk image file is a special format file prepared to burn on a disk. To burn an ISO image in the MS Windows use special programs: [[http://gluek.info/wiki/software/small-cd-writer|SCDWriter]], [[http://www.nero.com/rus/index.html|Nero BurningROM]] and others. +
      
    -=== Recording a disk image with Small CD-Writer === +To create a bootable USB drive on Linux/Unix, run the dd command: 
    -The entire process of burning an installation disk with Small CD-Writer consists of the following steps: +  > dd if=VEOS-8.7-x86_64-Minimal.iso of=/dev/sdz bs=1M
    -  - download the image of the distribution disk; +
    -  - download the Small CD-Writer program archive http://gluek.info/wiki/_media/software/scdwriter14.zip; +
    -  - extract program files from the archive to any directory; +
    -  - insert a blank disc into the drive; +
    -  - enter the directory and run SCDWriter.exe; +
    -  - start Disk → Burn ISO image to disk and, in the window that appears, specify the path to the disk image; +
    -  - click the Burn button.+
      
    -==== Recording a disk image in the Linux operating system ==== +:!: When writing the image, specify the **entire disk**, not a partition on it (i.e. ''/dev/sdz'', not ''/dev/sdz1'')
    -To burn ISO images it is recommended to use K3b or Brasero programs that come with any Linux distribution.+
      
    -=== Recording a disk image with K3b === +== Writing a USB drive on Windows ==
    -The entire process of burning an installation disk with K3b consists of the following steps: +
    -  - if the k3b program is missing, you need to install it on your system using the standard software installation tools for the distribution you have; +
    -  - run the k3b program. If properly configured, the program will tell you that there are no problems with the system and will prompt you to proceed to disk burning; +
    -  - in the Service main window menu, select Burn DVD image; +
    -  - in the Burn DVD image window that appears, click the Choose file to burn button. A dialog box will open in which you need to select the ISO image to burn and then click the OK button; +
    -  - the k3b program will show you the information about the ISO file and start calculating the checksum. This operation may take a few minutes. The checksum you get may be compared with the MD5SUM on the distribution page; +
    -  - if the checksums do not match, that means you have selected a wrong file for burning or the downloaded ISO image was broken during data transfer over the network; +
    -  - if the checksums match, insert the disk into your drive. Wait for the Start button to activate; +
    -  - click the Start button.+
      
     +**1. Rufus**
      
    -===== Installation ===== +To write the ISO image to a USB drive on Windows, you can use [[https://rufus.ie/ru/#|Rufus]], making sure to select the "DD Image mode": 
    -To boot your computer to install the system, you need to use the media containing the VEOS distribution.+  * Rufus main screen\\ {{:en:veos:rufus_main_screen.png?400|}} 
     +  * write mode selection dialog\\ {{:en:veos:record_mode.png?400|}}
      
    -===== Installation sequence ===== 
    -After successful initialization of the hardware, the bootloader menu with installation options is displayed: 
      
     +**2. Diskdupe (dd) for Windows**
     +
     +The command parameters are the same as on Linux. The DD distribution for Windows can be downloaded [[http://www.chrysocome.net/dd|here]].
     +
     +When using dd for Windows, first run ''dd --list'' and carefully review the list of NT block devices. Select a device similar to ''\\?\Device\Harddisk1\Partition0'' with a description like "Removable media other than floppy. Block size = 512". Be careful when selecting the device, otherwise you may corrupt data on other disks!
     +
     +=== Method 2. Preparing an installation disk ===
     +The traditional way to install an operating system is using an installation DVD.
     +
     +== Burning a disk image on MS Windows (using Small CD-Writer) ==
     +An ISO disk image file is a specially formatted file prepared for burning to a disk. To burn an ISO image on MS Windows, use dedicated software such as [[http://gluek.info/wiki/software/small-cd-writer|SCDWriter]], [[http://www.nero.com/rus/index.html|Nero BurningROM]], [[https://etcher.balena.io/|balenaEtcher]], and others.
     +
     +
     +The entire process of creating an installation disk using Small CD-Writer consists of the following steps:
     +  - Download the distribution image;
     +  - Download the [[http://gluek.info/wiki/_media/software/scdwriter14.zip|Small CD-Writer]] archive;
     +  - Extract the program files from the archive into any directory;
     +  - Insert a blank disk into the drive;
     +  - Open the extracted directory and run SCDWriter.exe;
     +  - Open the menu item Disk → Burn ISO Image to Disk and specify the path to the disk image in the dialog window;
     +  - Click the Burn button.
     +
     +== Burning a disk image on Linux (using K3b) ==
     +It is recommended to use K3b or Brasero for burning ISO images, as these programs are included in most Linux distributions.
     +
     +The entire process of creating an installation disk using K3b consists of the following steps:
     +  - if the k3b program is not installed, install it using the standard package management tools of your distribution;
     +  - launch the k3b program. If the system is configured correctly, the program will report that there are no issues and offer to proceed with burning the disk;
     +  - in the main window menu, select Service → Burn DVD Image;
     +  - in the Burn DVD Image window, click the button to select the file for burning. A dialog will open where you need to choose the ISO image and click OK;
     +  - k3b will display information about the ISO file and begin calculating the checksum. This may take several minutes. The resulting checksum can be compared with the MD5SUM value on the distribution page;
     +  - if the checksums do not match, either the wrong file was selected or the downloaded ISO image was corrupted during transfer;
     +  - if the checksums match, insert a writable disk into the drive and wait for the Start button to become active;
     +  - click the Start button.
     +
     +=====3. Installation process=====
     +====3.1. Booting from media and startup menu====
     +To boot the computer for system installation, use media containing the VEOS distribution.
     +
     +After successful hardware initialization, the bootloader menu with installation options is displayed:\\
     {{ :veos:veos_boot_menu.png?nolink&600 |}} {{ :veos:veos_boot_menu.png?nolink&600 |}}
      
    -Selecting the normal installation option launches the graphical interface of the installer program. The installation process is divided into steps. Each step is dedicated to configuring or installing a particular feature of the system. The steps follow one after the other. You can move to the next step by pressing Next. If necessary, you can use the Back button to go back to a previous step and change the settings.+Selecting the standard installation option launches the graphical installer interface. The installation process is divided into steps. Each step is dedicated to configuring or installing a specific system property. The steps must be completed sequentially. Proceed to the next step by clicking the Next button. If necessary, use the Back button to return to a previous step and modify settings. 
     + 
     +Technical information about the installation process (log file) can be viewed by pressing Ctrl+Alt+F1, and you can return to the graphical installer using Ctrl+Alt+F7. Pressing Ctrl+Alt+F2 opens the debug virtual console. 
     +Each step includes a short help section available by clicking the Help button or pressing F1. 
     +The installation process consists of the following steps: 
     +  - Selecting the installation interface language 
     +  - Configuring OS installation parameters — keyboard layout, language support, date and time zone settings, disk partition preparation, network configuration, security policy configuration, and administrator account creation 
     +  - Installing the system onto the selected disk 
     +  - Completing the installation and rebooting 
     + 
     +====3.2. Verifying successful installation==== 
     +You can verify the installation in two ways: 
     +  * Check the VEOS version: <code bash>cat /etc/system-release</code> 
     +  * Download any test package from the repository 
     + 
     +=====4. Providing access for further configuration===== 
     + 
     +If you received a preconfigured system from us, proceed directly to the [[en:dpi:dpi_brief:install_point_ssg:micra_install|Installation guide]] section.\\ 
     +Otherwise, you need to install the VEOS operating system on your server yourself and provide us with remote SSH access and root privileges so we can perform installation and initial platform configuration. 
     +After the work is completed, remote access can be disabled. 
     + 
     +  - Create the **vasexpertsmnt** user: <code>adduser -m -G wheel -u 3333 vasexpertsmnt</code> 
     +  - Set a **strong** password for the **vasexpertsmnt** user: <code>passwd vasexpertsmnt</code> For convenience, you can generate a password using openssl: <code>openssl rand -base64 15</code> 
     +  - Save the password for **vasexpertsmnt**. 
     +  - Allow users from the wheel group to execute all commands as any user by adding the following line to ///etc/sudoers//: <code>%wheel ALL=(ALL) NOPASSWD: ALL</code> 
     +  - To provide remote SSH access and restrict access to the following IP addresses:<code>45.151.108.0/23, 94.140.198.64/27, 193.218.143.187, 93.100.73.160, 78.140.234.98, 93.159.236.11, 46.243.181.35, 46.243.181.242</code> 
     +<code> 
     + iptables -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT 
     + iptables -A INPUT -p tcp -s 45.151.108.0/23 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 94.140.198.64/27 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 193.218.143.187 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 93.100.73.160 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 78.140.234.98 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 93.159.236.11 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 46.243.181.35 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp -s 46.243.181.242 -m tcp --dport 22 -j ACCEPT 
     + iptables -A INPUT -p tcp --dport 22 -j DROP 
     + service iptables save 
     +</code> 
     + 
     +If you use firewalld: 
     +<code> 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="45.151.108.0/23" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="94.140.198.64/27" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="193.218.143.187" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="93.100.73.160" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="78.140.234.98" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="93.159.236.11" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="46.243.181.35" service name="ssh" accept' 
     + firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="46.243.181.242" service name="ssh" accept' 
     + firewall-cmd --zone=public --remove-service=ssh --permanent 
     + firewall-cmd --reload 
     +</code> 
     +**!Save your settings, since the server will be rebooted during installation!** \\ 
     +\\ 
     + 
     +After confirming that remote SSH access is available, contact [[en:dpi:techsupport_info|VAS Experts technical support]] (Service Desk) and create a request for SSG license installation, specifying the SSH username and password. 
     + 
     + 
     +<note> 
     +SSG software installation is performed either by engineers or independently according to the following guide: [[en:dpi:dpi_brief:instal_script]]. 
     +</note> 
     +<note warning> 
     +Do not update the operating system kernel until the [[en:dpi:update|update system]] has been activated, 
     +as this may cause the network card driver to fail. 
     +</note> 
     + 
     +=====5. Updating VEOS===== 
     +To update VEOS, install the new version according to the standard [[en:veos:installation#installation_process|installation process]].
      
    -Technical information about the installation progress (log file) can be viewed by pressing Ctrl+Alt+F1, return to the graphical installer – Ctrl+Alt+F7. By pressing Ctrl+Alt+F2 the debugging virtual console opens. Each step is accompanied by brief help that can be accessed by clicking the Help button or by pressing the F1 key. +=====6. Troubleshooting===== 
    -The following steps are used to install the system: +====6.1. VEOS does not start after installation==== 
    -  - choosing the language of the installation interface; +Boot issues can be caused by various reasons, from BIOS/UEFI settings to missing drivers. 
    -  - configuring OS installation options – keyboard layout, language support, date and time zone settings, disk partition preparation, network configuration, security policy configuration, and administrator account creation; +  * Analyze the error messages displayed during boot. 
    -  - installing the system on the selected disk; +  * The most common causes: 
    -  - finishing installation and rebooting.+    * Secure Boot is enabled — disable it in UEFI settings. 
     +    * Incorrect boot order — make sure the disk with VEOS is first in the boot device list. 
     +    * GRUB bootloader is corrupted — boot into Rescue mode from the installation media and restore it. 
     +    * Missing drivers (kernel panic) — use a DUD ISO with the inst.dd boot parameter. 
     +  * If the cause is unclear, contact [[en:dpi:techsupport_info:start|VAS Experts technical support]] and attach a screenshot or the error text.
      
     +====6.2. The installer does not detect the hard drive====
     +In most cases, the issue is related to hardware or the disk controller operating mode.
     +  * Check the physical disk connection: cables, ports, and power.
     +  * Check the SATA controller mode in BIOS/UEFI — switch between AHCI and RAID and try both options.
     +  * If the disk is connected to a RAID or HBA controller, there may be no built-in driver available — use a DUD ISO (see section 2.2.1).
     +  * To rule out disk failure, test the drive on another server.
      
     +====6.3. Network issues after installation====
     +If network connectivity is unavailable after booting VEOS, first check whether NetworkManager is running.
     +  * Check the NetworkManager status: <code>systemctl status NetworkManager</code>
     +  * If the service is disabled or not running, enable it: <code>systemctl enable NetworkManager
     +systemctl start NetworkManager</code>
     +  * If NetworkManager is running but the network still does not work, check the interface settings (DHCP or static IP), default gateway, and DNS.