Opsi Manual Opsi Version 4.0.7
Total Page：16
File Type：pdf, Size：1020Kb
opsi manual opsi version 4.0.7 uib gmbh Bonifaziusplatz 1b 55118 Mainz Tel.:+49 6131 275610 www.uib.de Stand: 19.10.2017 [email protected] opsi manual opsi version 4.0.7 i Contents 1 Copyright 1 2 Introduction 1 2.1 Who should read this manual?........................................1 2.2 Notations....................................................1 3 Overview of opsi 2 3.1 Experience...................................................2 3.2 opsi features...................................................2 3.3 opsi Extensions.................................................2 3.4 Structure....................................................3 4 opsi-Management GUI: opsi-configed 5 4.1 Requirements and operation..........................................5 4.1.1 Logging of the opsi-configed ......................................6 4.1.2 Choosing the language.........................................6 4.1.3 Custom start values with Java Web Start..............................7 4.2 Login......................................................7 4.3 Copy & Paste, Drag & Drop..........................................8 4.4 opsi-configed modes Client configuration / server configuration / license management..........8 4.5 Depot selection.................................................8 4.6 Cient selection.................................................9 4.6.1 The clients list............................................. 11 4.6.2 Selecting clients............................................. 13 4.7 Client selection and hierarchical groups using the tree view........................ 14 4.7.1 Basic concepts............................................. 14 4.7.2 How to . ................................................ 15 4.8 Client processing / Client actions....................................... 16 4.8.1 Install By Shutdown, Uefi Boot and WAN Configuration...................... 16 4.8.2 WakeOnLan (Wake selected clients)................................. 17 4.8.3 Fire opsiclientd event (Push Installation).............................. 18 4.8.4 Sending messages (Show popup message)............................... 18 4.8.5 Session info for selected clients.................................... 19 4.8.6 For WAN-Clients: Delete package cache............................... 19 4.8.7 Call external remote control tools for selected clients........................ 19 4.8.8 Shutdown / reboot of selected clients................................. 21 4.8.9 Delete, create, rename and move clients............................... 21 4.9 Product configuration............................................. 22 opsi manual opsi version 4.0.7 ii 4.10 Property tables with list editor windows................................... 24 4.10.1 Hidden Password Property Values.................................. 25 4.11 Netboot products................................................ 25 4.12 Hardware information............................................. 26 4.12.1 Automatic driver upload........................................ 27 4.13 Software inventory............................................... 29 4.14 Logfiles: Logs from client and server..................................... 29 4.15 Product default properties........................................... 30 4.16 Host parameters in client and server configuration............................. 31 4.16.1 Management of user rights and roles................................. 33 4.17 Depot configuration.............................................. 34 4.18 Group actions.................................................. 35 4.19 Product actions................................................. 35 4.20 Server-Console................................................. 36 4.20.1 Connection data and permissions................................... 37 4.20.2 SSH-Terminal.............................................. 38 4.20.3 Predefined commands with input masks............................... 38 4.21 Define commands................................................ 39 5 opsi-server 41 5.1 Overview.................................................... 41 5.1.1 Installation and initial operation................................... 42 5.1.2 Samba Configuration.......................................... 42 5.1.3 The daemon opsiconfd......................................... 42 5.1.4 Required administrative user accounts and groups......................... 43 5.1.5 needed shares.............................................. 43 5.1.6 opsi PAM Authentication....................................... 43 5.1.7 problem management......................................... 44 5.2 Remarks to Samba 4.............................................. 45 5.2.1 The /etc/opsi/opsi.conf: pcpatch and opsifileadmins........................ 45 5.2.2 Share Configuration.......................................... 45 5.2.3 Access to the shares: clientconfig.depot.user............................. 46 5.3 opsi command line tools and processes.................................... 46 5.3.1 Tool: opsi-setup............................................ 46 5.3.2 Tool: opsi-package-manager: (de-)installs opsi-packages...................... 49 5.3.3 Tool: opsi-product-updater ..................................... 50 configurable repositories........................................ 51 configurable actions.......................................... 51 5.3.4 Tools: opsi-admin / opsi config interface ............................... 52 opsi manual opsi version 4.0.7 iii Overview................................................ 52 Typical use cases............................................ 53 5.3.5 Server processes: opsiconfd and opsipxeconfd............................ 54 opsiconfd monitoring: opsiconfd info................................. 54 5.3.6 Server process: opsi-atftpd...................................... 55 5.4 Web service / API methods.......................................... 56 5.4.1 object oriented methods........................................ 56 Overview................................................ 56 host (server and clients)........................................ 58 group (group administration)..................................... 59 objectToGroup (group administration)................................ 60 product (product meta data)..................................... 60 productProperty (definition of product properties)......................... 61 productPropertyState (depot or client specific product property settings)............. 62 productDependency (product dependencies)............................. 62 productOnClient (client specific information to a product e.g. installation state)........ 63 productOnDepot (depot specific information to a product)..................... 63 config (administration of host parameter defaults)......................... 64 configState (administration of client host parameters)....................... 64 auditHardwareOnHost (client specific hardware information)................... 64 auditHardware (client independent hardware information)..................... 66 auditSoftwareOnClient (client specific software information).................... 67 auditSoftware (client independent software information)...................... 68 auditSoftwareToLicensePool (license management)......................... 68 softwareLicenseToLicensePool (license management)........................ 69 softwareLicense (license management)................................ 69 licenseContract (license management)................................ 69 licenseOnClient (license management)................................ 70 licensePool (license management)................................... 70 Communication with hosts...................................... 71 log_read / log_write .......................................... 72 5.4.2 Action oriented methods........................................ 73 5.4.3 Backend extensions........................................... 79 5.4.4 Accessing the API........................................... 79 5.5 opsi-backup................................................... 79 5.5.1 Introduction.............................................. 79 5.5.2 Preconditions for a backup...................................... 79 5.5.3 Quick Start............................................... 79 5.5.4 Basic parts of opsi........................................... 80 opsi manual opsi version 4.0.7 iv Opsi configuration........................................... 80 Opsi backends............................................. 80 opsi depot share............................................ 80 opsi work bench............................................ 80 opsi repository............................................. 81 TFTP directory............................................ 81 5.5.5 The program opsi-backup ...................................... 81 Create a backup............................................ 81 Archive your backup files....................................... 83 Verify a backup............................................. 83 Restore from a backup file....................................... 83 5.6 opsi data storage (backends).......................................... 84 5.6.1 file backend............................................... 84 5.6.2 mysql backend............................................. 85 mysql backend for inventory data................................... 85 mysql backend for configuration data................................. 88 Initializing the MySQL-Backend................................... 89 Configure the mysql database for access from outside the server.................. 91 5.6.3