Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
openSUSE:Backports:SLE-15-SP5
orthos-client
orthos2.1
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File orthos2.1 of Package orthos-client
.\" Man page generated from reStructuredText. . .TH "ORTHOS2" "1" "Jan 07, 2022" "" "Orthos2" .SH NAME orthos2 \- Orthos Command Line Client Documenation . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH COMMAND LINE INTERFACE (CLI) .SS Basics .sp The Orthos CLI is a simple interactive shell. You can perform following tasks with the Orthos CLI: .INDENT 0.0 .IP \(bu 2 execute complex queries such as “which machines have more than 4 CPUs” and are reserved by Manfred .IP \(bu 2 reserve or release a machine .IP \(bu 2 trigger installation of a machine .IP \(bu 2 view detailed machine information (such as dmidecode, lspci, lsmod or hwinfo) .IP \(bu 2 turn power on/off or just reboot a machine .IP \(bu 2 edit machine data .IP \(bu 2 Sync machines with a cobbler server .IP \(bu 2 Trigger machine data scans .IP \(bu 2 \&... .UNINDENT .SS Install the CLI .sp Python 3 is recommended. .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C zypper in orthos\-client .ft P .fi .UNINDENT .UNINDENT .sp In the Orthos Web Client you will find also the download link \fBDownload CLI\fP to the CLI, here you have the possibility to download the suitable client for your distribution(.rpm). The button is in the top right corner. .SS Connecting the CLI to the Orthos Server .sp The CLI has several options how you can set up the connection to the Orthos server and adapt it to your needs. .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C you_machine:~ # orthos \-\-help usage: orthos [\-h] [\-H HOST] [\-P PORT] [\-U USER] [\-\-password PASSWORD] [\-\-token TOKEN] [\-D] [\-L FILE] [\-\-no\-pager] [\-p] [\-F IFS] [\-q] [\-v] [\-\-timezone TZ] Orthos command line interface. optional arguments: \-h, \-\-help show this help message and exit \-H HOST, \-\-host HOST use the hostname specified on the command line instead of the one in the config file \-P PORT, \-\-port PORT use the port specified on the command line instead of the one in the config file \-U USER, \-\-user USER use the username specified \-\-password PASSWORD Better use \-\-token instead (Create a token in the preferences section of the user on the web interface of the server) \-\-token TOKEN use this token for automatic authentication (e.g. for scripting); \-U/\-\-password options will be ignored \-D, \-\-debug write debugging output \-L FILE, \-\-logfile FILE use that together with \-D to log the debug output in a file rather than the console \-\-no\-pager do not use pager when showing results \-p, \-\-plain\-output print plain output (e.g. for scripting) \-F IFS, \-\-ifs IFS set internal field separator (only useful in combination with \-p; default is $OIFS) \-q, \-\-quiet makes command line client quiet \-v, \-\-version print version output \-\-timezone TZ set the local time zone (default is "Europe/Berlin") .ft P .fi .UNINDENT .UNINDENT .sp Example for the connection to the Orthos Server: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C your_machine:~ # orthos \-H https://orthos\-next.arch.suse.de (orthos 2.0.0) .ft P .fi .UNINDENT .UNINDENT .SS Orthosrc configuration file .sp The orthos package installs an empty configuration file in /usr/share/doc/packages/orthos\-clientorthosrc\&. Once you connected to the orthos server, it is recommended to copy this file to your local config directory: ~/.config/orthosrc and adapt the file to your needs. .SS Orthos Command Examples .sp HELP .sp Provides help and shows you an overview of the available Orthos CLI commands. .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C (orthos 2.0.0) help Commands are: INFO Retrieve information about a machine. POWER Power cycles a machine. REGENERATE Regenerate machine\-related or service files. RESCAN Rescan a machine. SERVERCONFIG Show server configuration. RESERVATIONHISTORY Show reservation history of a machine. ADD Adds information to the database. RELEASE Release machines. QUERY Retrieve information about a machine. RESERVE Reserve machines. SETUP Automatic machine setup. DELETE Removes information from the database. ALIAS Define own aliases. AUTH Request authorisation manually. EXIT Exit program. HELP Provides help. .ft P .fi .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C (orthos 2.0.0) help info Command to get information about a machine. Usage: INFO <fqdn> Arguments: fqdn \- FQDN or hostname of the machine. Example: INFO foo.suse.de .ft P .fi .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C (orthos 2.0.0) help power Command to power cycle machines or the get the current status. Usage: POWER <fqdn> <action> Arguments: fqdn \- FQDN or hostname of the machine. action \- Specify new power state. Actions are: on : Power on. off : Power off via SSH. If didn\(aqt succeed, use remote power. off\-ssh : Power off via SSH only. off\-remotepower : Power off via remote power only. reboot : Reboot via SSH. If didn\(aqt succeed, use remote power. reboot\-ssh : Reboot via SSH only. reboot\-remotepower : Reboot via remote power only. status : Get power status. Example: POWER foo.suse.de reboot .ft P .fi .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C (orthos 2.0.0) help reserve Reserves a machine. Usage: RESERVE <fqdn> Arguments: fqdn \- FQDN or hostname of the machine. Example: RESERVE foo.suse.de .ft P .fi .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C (orthos 2.0.0) help alias Define or display aliases. The command can be called without any arguments, then it displays all available aliases. If it\(aqs called with one argument, then it displays the definition of a specific alias. If it is called with more than two arguments, then you can define new aliases. To execute an alias, type the alias name with a leading \(aq@\(aq. Usage: ALIAS [alias] [*args] Arguments: alias \- Alias name. *args \- Valid command string. Example: ALIAS ALIAS allmachines query name, ipv4 where name =~ foobar ALIAS allmachines @allmachines .ft P .fi .UNINDENT .UNINDENT .sp QUERY .sp Retrieve all kind of information about a machine or general orthos data. This is a very powerful command. It is built up similar to a SELECT SQL database statement. In fact it ends up in querying the underlying orthos server database: .sp query foo, bar where binary_attribute and int_attribute > XY and char_attribute =~ "STRING" .sp \-> This will search for and show the results (also attributes): foo and bar where the condition after where matches. .sp Examples: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C query fqdn, cpu_physical query fqdn where cpu_model =~ Intel query fqdn where cpu_model =~ Intel OR !efi .ft P .fi .UNINDENT .UNINDENT .sp More complex queries: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C # Show full names and installed distributions of all machines which # are not reserved (!res_by), which do run and have an orthos ssh key # installed and therefore could be nightly scanned (status_login) # which are not administrative, x86_64 machines and do have more than 7 # CPU cores: query fqdn, inst_dist where !res_by and status_login and !administrative and architecture = x86_64 and cpu_cores > 7 .ft P .fi .UNINDENT .UNINDENT .sp Use alias(es) for more complex queries: To permanently define and use above command as an alias (auto\-stored in ~/.config/orthosrc), make sure to not use any quoting, just do: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C alias x86_free_running query fqdn, inst_dist where !res_by and status_login and !administrative and architecture = x86_64 and cpu_cores > 7 .ft P .fi .UNINDENT .UNINDENT .sp To use above defined alias (tab completion working...): .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C @x86_free_running .ft P .fi .UNINDENT .UNINDENT .sp Valid operators are: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C !<field> not (binary fields only) == = exactly equal =~ contains =* startswith != unequal > < greater or less than (number fields only) >= <= greater equals or less equals (number fields only) AND logical conjunction OR logical disjunction .ft P .fi .UNINDENT .UNINDENT .SS Orthos Variables and Objects .sp The Orthos Client has many objects that you can query from the machine objects in Orthos. The names are self\-explanatory and can be used for queries as described under the \fIquery\fP command above or you use the TAB completion feature to see available \fIquery\fP attributes. .SH AUTHOR Thomas Renninger .SH COPYRIGHT 2020, openSUSE Orthos2 Team .\" Generated by docutils manpage writer. .
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor
