Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| en:veos:user_manual [2023/09/04 09:37] – elena.krasnobryzh | en:veos:user_manual [2026/05/28 15:48] (current) – elena.krasnobryzh | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== User's Guide ====== | ||
| {{indexmenu_n> | {{indexmenu_n> | ||
| + | ====== VEOS User Guide ====== | ||
| - | ===== System boot ===== | + | **VEOS** is a Linux-based operating system designed for managing telecom equipment |
| - | VEOS is started automatically after the computer is started | + | This guide contains basic instructions |
| - | Use the Up and Down arrow keys to select | + | **Key user features: |
| + | * Multi-user operation with permission separation | ||
| + | * Execution of standard Linux commands | ||
| + | * Access | ||
| + | * File and process | ||
| + | * Installation | ||
| - | Each string begins with the word [Message] (FAILED or OK), which is a sign of normal or abnormal boot stage completion. The word Message=FAILED indicates the unsuccessful completion of the system component loading, which requires the intervention and special actions of the system administrator. Loading the operating system may take some time, depending on the performance of the computer. The main stages of VEOS loading —core boot, attaching (mounting) file systems, starting system services — can be periodically supplemented by checking file systems for errors. In this case, the waiting time may take longer than usual. Detailed information about the boot steps can be obtained by pressing Esc. | + | ---- |
| - | ===== Log in to the system | + | ===== 1. System boot and login ===== |
| - | The standard VEOS installation includes a basic system running in a console mode. When booting in a console mode, the VEOS boot ends with a request to enter the account login and password. If necessary, you can switch to another console by pressing Ctrl+Alt+F2. In case of successful authentication and identification procedure completion, a login will be performed. VEOS OS will switch to normal operation mode and provide access to the console for the user. | + | |
| - | ====== | + | === 1.1. Booting VEOS === |
| - | VEOS, like all UNIX family systems, has on-screen documentation. Its texts contain documentation on system commands, resources, configuration files, etc., and can also be displayed on the screen during operation. | + | |
| - | ==== MAN Utility ==== | + | VEOS starts automatically after the computer is powered |
| - | To access | + | |
| - | > man ls | + | |
| - | Most of the on-screen documentation is written for users who have some idea of what this command does. Therefore, most of the on-screen | + | |
| - | The search for man descriptions is carried out by the apropos command. If you do not know exactly what the name of the program you need is, then the search is carried out by a keyword, for example, apropos ls, or by entering a word denoting | + | ^ Action ^ Key ^ |
| - | The " | + | | Select |
| + | | Immediately boot the selected option | '' | ||
| + | | Edit boot parameters | '' | ||
| + | | Switch | ||
| - | ==== INFO Utility ==== | + | During |
| - | Another source of information about VEOS and its component programs is the info reference subsystem. The manual page, despite the abundance of links of various | + | |
| - | ===== Installing additional software ===== | + | <note warning> |
| - | To install additional software in VEOS, dnf (or yum) utilities are used to download rpm packets from VEOS repositories and rpm for installation from rpm files. | + | If any boot stage finishes with the '' |
| + | </ | ||
| - | <note important> | + | Main boot stages: |
| - | ==== Installing a packet from the repository ==== | + | |
| - | To install or update a packet from the repository, run the following command: | + | * Mounting file systems |
| - | | + | |
| - | To delete an installed packet: | + | * (If required) checking file systems for errors |
| - | | + | |
| - | ==== Installing a packet from a file ==== | + | === 1.2. Logging into the system |
| - | Sometimes locally downloaded rpm packet is to be installed: | + | |
| - | > rpm -ih < | + | |
| - | To update the packet: | + | |
| - | > rpm -Uh < | + | |
| - | ==== Updating installed packets ==== | + | After boot is completed, the system switches |
| - | Periodically, updates of installed packets appear in the VEOS repositories, | + | |
| - | > dnf update | + | |
| - | During the update process, the utility will detect the latest non-installed versions for all system packets, calculate their dependencies, | + | |
| - | ==== Installation of VAS Experts software ==== | + | < |
| - | By default, VEOS has access to the VAS Experts repositories configured and all the company' | + | Login: _ |
| - | > dnf install fastdpi | + | Password: _ |
| + | </code> | ||
| - | ===== Overview of the main system | + | Credentials are provided by the system |
| - | All commands listed below can be run in a console mode. For more information, use the man command. Example: | + | |
| - | > man ls | + | |
| - | Note: Command parameters | + | |
| - | ==== User accounts ==== | + | <note important> |
| + | **Important: | ||
| + | </ | ||
| - | === The su command === | + | ---- |
| - | The su command allows to change the " | + | |
| - | Syntax: | + | |
| - | > su [OPTIONS...] [USER] | + | |
| - | The command can be used to replace the current user with any other, but most often it is used to obtain superuser (root) rights by the user. When entering the su - command, the superuser (root) password will be requested, and if the correct password is entered, the user will receive administrator rights. To return to user rights, enter the command: | + | |
| - | > exit | + | |
| - | For more information about superuser mode, see the Superuser Mode chapter | + | |
| - | === The id command | + | ===== 2. Built-in documentation ===== |
| - | The id command displays information about the user and the groups | + | VEOS includes an extensive built-in help system. |
| - | > id [OPTIONS...] [USER] | + | |
| - | === The passwd command | + | === 2.1. The '' |
| - | The passwd | + | The '' |
| - | ==== Basic operations with files and directories ==== | + | ^ Action ^ Command ^ |
| + | | View help for the '' | ||
| + | | Search for a command by keyword | '' | ||
| + | | Search for a command by keyword (short form) | '' | ||
| + | | Help for the '' | ||
| - | === The ls command === | + | **Navigation inside a manual page:** |
| - | The ls (list) command types the contents of directories to standard output. Syntax: | + | ^ Key ^ Action ^ |
| - | > ls [OPTIONS...] [FILE...] | + | | '' |
| - | Basic options: | + | | '' |
| - | * -a — view all files, including hidden ones; | + | |
| - | * -l — display more detailed information; | + | |
| - | * -R — output information about subdirectories recursively. | + | |
| - | === The cd command | + | === 2.2. The '' |
| - | The cd command is used to change the directory. The command operates with both absolute and relative paths. If the directory is not specified, the value of the $HOME environmental variable (the user's home directory) is used. If the directory is given a full route name, it becomes the current one. In relation to the new directory, you need to have the right to execute, which in this case is interpreted as a search permission. Syntax: | + | Unlike linear '' |
| - | > cd [-L|-P] [DIRECTORY] | + | |
| - | If " | + | |
| - | > cd docs/ | + | |
| - | Make the current directory /usr/bin (absolute path): | + | |
| - | > cd /usr/bin/ | + | |
| - | Make the parent directory a current one: | + | |
| - | > cd .. | + | |
| - | Go back to the previous directory: | + | |
| - | > cd - | + | |
| - | Make the home directory a current one: | + | |
| - | > cd | + | |
| - | === The pwd command === | + | ^ Command ^ Action ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | The pwd command outputs the absolute path of the current (working) directory. Syntax: | + | ---- |
| - | > pwd [-L|-P] | + | |
| - | Options: | + | |
| - | * -P — do not output symbolic links; | + | |
| - | * -L — output symbolic links. | + | |
| - | === The rm command | + | ===== 3. Software installation and updates ===== |
| - | The rm command is used to delete file entries. If the specified name was the last link to the file, then the file is destroyed. | + | The '' |
| - | Warning: If you delete a file, you will not be able to restore it! | + | === 3.1. Basic package operations === |
| - | Syntax: | + | ^ Operation ^ Command (as root) ^ |
| - | > rm [OPTIONS...] | + | | Install a package from a repository | '' |
| - | Basic options: | + | | Remove a package | '' |
| - | | + | | Update all system packages | '' |
| - | | + | | Install a local '' |
| - | * -r, -R — recursively delete the contents of the specified directories. | + | | Update a local '' |
| - | Example. Delete all html files in the ~/html directory: | + | **Example |
| - | > rm -i ~/html/*.html | + | <code bash> |
| + | dnf install fastdpi | ||
| + | </code> | ||
| - | === The mkdir command === | + | <note important> |
| + | VEOS is preconfigured with access to the official VAS Experts repositories, | ||
| + | </ | ||
| - | mkdir is a command for creating new directories. Syntax: | + | ---- |
| - | > mkdir [-p] [-m rights] < | + | |
| - | === The rmdir command | + | ===== 4. Basic commands for working with the system ===== |
| - | The rmdir command deletes directories | + | All commands listed in this section are standard Linux commands and can be executed |
| - | > rmdir [OPTIONS] < | + | |
| - | Basic options: | + | |
| - | * -p — delete the directory and its descendants. | + | |
| - | The rmdir command | + | |
| - | === The cp command | + | < |
| + | Most short command | ||
| + | </ | ||
| - | The cp command is designed to copy files from one directory to other directories. Syntax: | + | === 4.1. User management === |
| - | > cp [-fip] [SRC_FILE...] [DST_FILE...] | + | |
| - | > cp [-fip] [SRC_FILE...] [DIRECTORY] | + | |
| - | > cp [-R] [[-H] | [-L] | [-P]] [-fip] [SRC_FILE...] [DIRECTORY] | + | |
| - | Basic options: | + | |
| - | * -p — save, if possible, the time of modification and access to the file, the owner and group, access rights; | + | |
| - | * -i — request confirmation before copying to existing files; | + | |
| - | * -r, -R — recursively copy the contents of directories. | + | |
| - | === The mv command === | + | ^ Command ^ Action ^ Note ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | The mv command is designed to move files. Syntax: | + | === 4.2. Navigation and file operations === |
| - | > mv [-fi] [SRC_FILE...] [DST_FILE...] | + | |
| - | > mv [-fi] [SRC_FILE...] [DIRECTORY] | + | |
| - | In the first syntactic form, characterized by the fact that the last operand is neither a directory nor a symbolic link to a directory, mv moves the src_file to the dst_file (the file is renamed). In the second syntactic form, mv moves the source files to the specified directory under names that match the short names of the source files. Basic options: | + | |
| - | * -f — do not ask for confirmation of overwriting existing files; | + | |
| - | * -i — request confirmation of overwriting existing files. | + | |
| - | === The cat command === | + | ^ Command ^ Description ^ Examples / Notes ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | The cat command sequentially outputs the contents of the files. Syntax: | + | <note warning> |
| - | | + | **Warning:** The '' |
| - | Basic options: | + | </ |
| - | | + | |
| - | | + | |
| - | If no file is specified, standard input is read. If the name " | + | === 4.3. Searching for files and commands === |
| - | === The head command | + | ^ Command ^ Description ^ Example ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | The head command outputs the first 10 lines of each file to standard output. Syntax: | + | === 4.4. Access permissions === |
| - | > head [OPTIONS] [FILE...] | + | |
| - | Basic options: | + | |
| - | * -n, –lines=[-]K — print the first K lines of each file, not the first 10; | + | |
| - | * -q, –quiet — do not print headers with file names. | + | |
| - | === The less command === | + | ^ Command ^ Description ^ Example ^ |
| + | | '' | ||
| + | | '' | ||
| - | The less command allows to view the text page by page (to exit, press q). Syntax: | + | === 4.5. System and process monitoring === |
| - | > less FILE | + | |
| - | === The grep command === | + | ^ Command ^ Description ^ Example ^ |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| - | The grep command has many options and provides the possibility to search for a character string in a file. Syntax: | + | ---- |
| - | > grep [search_template] FILE | + | |
| - | === The chmod command | + | ===== 5. File archiving and compression ===== |
| - | The chmod command is designed | + | The **'' |
| - | > chmod [OPTIONS] MODE[,MODE]... < | + | |
| - | > chmod [OPTIONS] --reference=IFILE < | + | |
| - | Basic options: | + | |
| - | * -R — recursively change the mode of access to files located in the specified directories; | + | |
| - | * –reference=IFILE — use IFILE file mode. | + | |
| - | chmod modifies the access rights of each specified file in accordance with the access rights specified in the mode parameter, which can be represented either in a character form or as an octal representing the bit mask of the new access rights. The character mode format is as follows: | + | ^ Operation ^ Command ^ |
| - | > [ugoa...][[+-=][permissions...]...] | + | | Archive |
| - | Here permissions are zero or more letters from the lettering " | + | | Extract |
| + | | Extract a compressed archive ('' | ||
| + | | Create | ||
| - | The " | + | **Example: |
| + | <code bash> | ||
| + | # Archive | ||
| + | tar -cf my_docs.tar Documents/ | ||
| - | Examples. Allow everyone to execute | + | # Extract a gzip-compressed archive into the current directory |
| + | tar -xzf archive.tar.gz | ||
| + | </ | ||
| - | > chmod +x f2 | + | ---- |
| - | Prevent f3 file deletion: | + | |
| - | > chmod +t f3 | + | |
| - | === The chown command | + | ===== 6. Frequently asked questions (FAQ) ===== |
| - | The chown command changes the owner and/or group for each specified file. Syntax: | + | **Question:** How do I obtain superuser (root) privileges? |
| - | > chown [KEY]...[OWNER][:[GROUP]] < | + | **Answer:** Run the '' |
| - | Only the file owner or superuser can change the owner. The owner does not change if it is not specified in the argument. The group also does not change if it is not specified, but if there is a ":" | + | |
| - | > chown test /u | + | |
| - | Change the owner and group of the /u directory: | + | |
| - | > chown test:staff /u | + | |
| - | Change the owner of the /u directory and attached files to test: | + | |
| - | > chown -hR test /u | + | |
| - | ==== File Search | + | **Question: |
| + | **Answer:** '' | ||
| - | === The find command | + | **Question: |
| + | **Answer:** Use the built-in documentation: | ||
| - | The find command is designed to search for all files starting from the root directory. The search can be performed by the name, type, or owner of the file. Syntax: | + | **Question: |
| - | > find [-H] [-L] [-P] [-Olevel] [-D help|tree|search|stat|rates|opt|exec] [PATH...] [EXPRESSION] | + | **Answer:** Add the '' |
| - | Search keys: | + | |
| - | * -name — search by file name; | + | |
| - | * -type — search by type f=file, d=directory, | + | |
| - | * -user — search by owner (name or UID). | + | |
| - | When the find command is executed, you can perform various actions on the found files. Basic actions: | + | **Question:** Can I search within file contents?\\ |
| - | | + | **Answer:** Yes, use the '' |
| - | | + | |
| - | | + | |
| - | * -print — displays the file name on the screen. | + | |
| - | The default path is the current subdirectory. The default expression is print. Examples. Find regular files (not directories) in the current directory which name starts with the " | + | ---- |
| - | | + | <details> |
| - | Find files modified later than file.bak in the current directory: | + | <summary>📌 Technical document information< |
| - | | + | |
| - | Delete all files named a.out or *.o that have not been accessed for a week: | + | |
| - | > find / \( -name a.out -o -name ' | + | |
| - | Delete all files named a.out or *.o that have not been accessed for a week: | + | |
| - | | + | |
| - | === The whereis command === | + | **Document last reviewed:** 2026-05-12\\ |
| + | **Applicable VEOS version:** 8.6 and later\\ | ||
| + | **Author:** VAS Experts | ||
| - | whereis reports the path to the executable program file, its source files (if any) and the corresponding pages of the reference manual. Syntax: | + | </details> |
| - | > whereis [OPTIONS] | + | |
| - | Options: | + | |
| - | * -b — information output only about executable files; | + | |
| - | * -m — information output only about the pages of the reference manual; | + | |
| - | * -s — information output only about the source files. | + | |
| - | + | ||
| - | ==== Process monitoring and control ==== | + | |
| - | + | ||
| - | === The ps command === | + | |
| - | + | ||
| - | The ps command displays a list of current processes. Syntax: | + | |
| - | > ps [OPTIONS] | + | |
| - | By default, information about processes with the same valid UID and control terminal is displayed as those of the user's who submits the command. Basic options: | + | |
| - | * -a — output information about processes associated with terminals; | + | |
| - | * -f — output the " | + | |
| - | * -l — output the " | + | |
| - | * -p list — display information about processes with the PIDs specified in the list; | + | |
| - | * -u list — display information about processes with listed identifiers or user names. | + | |
| - | + | ||
| - | === The kill command === | + | |
| - | + | ||
| - | The kill command allows to terminate the execution of a process or send it a signal. Syntax: | + | |
| - | > kill [-s] [signal] [identifier] [...] | + | |
| - | > kill [-l] [completion_status] | + | |
| - | > kill [-signal_number] [identifier] [...] | + | |
| - | + | ||
| - | The identifier is the PID of the leading task process or the task number, preceded by a " | + | |
| - | * -l — display a list of supported signals; | + | |
| - | * -s signal, -signal — send a signal with the specified name. | + | |
| - | + | ||
| - | If the usual kill command does not give the desired effect, the kill command with the -9 parameter (kill -9 PID_number) shall be used. | + | |
| - | + | ||
| - | === The df command === | + | |
| - | + | ||
| - | The df command shows the amount of available disk space in the file system that contains the file transferred as an argument. If no file is specified, the available space on all mounted file systems is shown. The default sizes are specified in 1KB blocks. Syntax: | + | |
| - | > df [OPTIONS] [FILE...] | + | |
| - | Basic options: | + | |
| - | * –total — calculate the total volume at the end; | + | |
| - | * -h, –human-readable — print dimensions in a readable format (e.g. 1K, 234M, 2G). | + | |
| - | + | ||
| - | === The du command === | + | |
| - | + | ||
| - | The du command counts the disk usage by each file, for directories, | + | |
| - | > du [OPTIONS] [FILE...] | + | |
| - | Basic options: | + | |
| - | * -a, –all — output the total amount for each given file, not just for directories; | + | |
| - | * -c, –total — calculate the total volume at the end. It can be used to find out the total disk space usage for the entire list of given files; | + | |
| - | * -d, –max-depth=N — output the volume for the directory (or files, if –all is specified) only if it is N or less levels below the command string arguments; | + | |
| - | * -S, –separate-dirs — output the size of each directory separately, not including the sizes of subdirectories; | + | |
| - | * -s, –summarize — display only the sum for each argument. | + | |
| - | + | ||
| - | === The which command === | + | |
| - | + | ||
| - | The which command displays the full path to the specified commands or scripts. Syntax: | + | |
| - | > which [OPTIONS] < | + | |
| - | Basic options: | + | |
| - | * -a, –all — outputs all matched executable flies by content in the $PATH environment variable, not just the first one; | + | |
| - | * -c, –total — calculate the total volume at the end. It can be used to find out the total disk space usage for the entire list of given files; | + | |
| - | * -d, –max-depth=N — output the volume for the directory (or files, if –all is specified) only if it is N or less levels below the command string arguments; | + | |
| - | * -S, –separate-dirs — output the size of each directory separately, not including the sizes of subdirectories; | + | |
| - | * –skip-dot — skips all directories from the $PATH environment variable that start with a dot. | + | |
| - | + | ||
| - | ==== Using multitasking ==== | + | |
| - | + | ||
| - | VEOS is a multitasking system. In order to run the program in the background, you need to type "&" | + | |
| - | + | ||
| - | === The bg command === | + | |
| - | + | ||
| - | The bg command allows to move the task to the background. Syntax: | + | |
| - | > bg [IDENTIFIER ...] | + | |
| - | The identifier is the PID of the leading task process or the task number, preceded by a " | + | |
| - | + | ||
| - | === The fg command === | + | |
| - | + | ||
| - | The fg command allows to bring the task to the foreground. Syntax: | + | |
| - | > fg [IDENTIFIER ...] | + | |
| - | The identifier is the PID of the leading task process or the task number, preceded by a " | + | |
| - | + | ||
| - | ==== File compression and packaging ==== | + | |
| - | + | ||
| - | === The tar command === | + | |
| - | + | ||
| - | File compression and packaging is performed using the tar command, which converts a file or group of files into an archive without compression (tarfile). File packaging into an archive is most often performed with the following command: | + | |
| - | > tar -cf [name of the archive file to be created] [packaged files and/or directories] | + | |
| - | Example of using the archive packing command: | + | |
| - | > tar -cf moi_dokumenti.tar Docs project.tex | + | |
| - | Unpacking the archive contents to the current directory is performed by the command: | + | |
| - | | + | |
| - | Special compression programs are used to compress files: gzip, bzip2 and 7z. | + | |