Opsi Getting Started Opsi-Version 4.0.7
Total Page:16
File Type:pdf, Size:1020Kb
opsi Getting Started opsi-Version 4.0.7 uib gmbh Bonifaziusplatz 1b 55118 Mainz Tel.:+49 6131 275610 www.uib.de Stand: December 17, 2018 [email protected] opsi Getting Started opsi-Version 4.0.7 i Contents 1 Copyright 1 2 Introduction 2 2.1 Steps for Installation and Getting Starting..................................2 2.2 Hardware Requirements............................................2 2.3 Configuration Requirement..........................................3 3 opsi Support Matrix (opsi runs on which server)4 3.1 Supported distributions for server.......................................4 4 Installation 6 4.1 opsi-server Base Installation..........................................6 4.1.1 Starting up the uib preconfigured Virtual Machine.........................6 4.1.1.1 First Start..........................................6 4.1.1.2 Language selection......................................7 4.1.1.3 First boot...........................................7 4.1.1.4 Second Start.........................................9 4.1.1.5 Terminal Window...................................... 10 4.1.1.6 Check the Network Connection............................... 11 4.1.1.7 Update the opsi-Server................................... 11 4.1.1.8 Install the standard opsi-products............................. 11 4.1.1.9 Starting opsi-Server Interface................................ 12 4.1.2 Installation on a Debian / Ubuntu.................................. 12 4.1.3 Installation on a Univention Corporate Server (UCS)........................ 14 4.1.3.1 Installation through Univention App-Center....................... 15 4.1.3.2 Upgrading an existing opsi-Installation from UCS 3 to UCS 4 (over the App-Center). 15 4.1.3.3 Manual opsi-installation on UCS (without App-Center)................. 16 4.1.3.4 Hints about installing opsi on an UCS server with the role member .......... 17 4.1.3.5 PXE-Boot configuration for operating system installation................ 18 4.1.3.6 Synchronising data from LDAP to opsi.......................... 18 4.1.4 Installation on openSUSE....................................... 18 opsi Getting Started opsi-Version 4.0.7 ii 4.1.5 Installation on Suse Linux Enterprise Server (SLES)........................ 20 4.1.6 Installation on RedHat Enterprise Linux (RHEL).......................... 21 4.1.7 Installation on CentOS Server..................................... 23 4.2 Update and Configuration of the opsi-server................................. 24 4.2.1 Proxy Entry in apt-configuration File................................ 24 4.2.2 Update of the opsi-server....................................... 25 4.2.3 Backend Configuration......................................... 25 4.2.4 Set Samba Configuration and Change Passwords.......................... 27 4.2.5 Checking the Java Configuration................................... 28 4.2.6 Create Users and administrate the groups opsiadmin / pcpatch.................. 28 4.3 DHCP Configuration.............................................. 29 4.3.1 Using a DHCP Server at the opsi-server............................... 29 4.3.2 Using an External DHCP Server................................... 30 4.3.3 Checking the Backend Configuration for DHCP Entries...................... 30 4.4 Configure how the opsi-server gets the Client’s IP-Address......................... 31 4.5 Install the Minimal opsi Products....................................... 31 4.6 Installing and Checking the Activation File................................. 32 4.7 Starting the management interface (opsi-configed)............................. 33 4.8 Network Ports used by a opsi installation.................................. 33 5 Integration of Existing Clients 34 5.1 Installation of the opsi-client-agent...................................... 34 5.1.1 Usage of service_setup.cmd...................................... 34 5.1.1.1 service_setup.cmd on Windows NT6........................... 34 5.1.1.2 service_setup_NT5.cmd on Windows NT5........................ 35 5.1.2 Usage of the opsi-deploy-client-agent................................. 35 5.2 Rollout from Existing Products........................................ 37 5.2.1 Usage of opsi standard products: opsi-configed........................... 37 5.2.2 Hard- and Software Inventory with the Products hwaudit and swaudit.............. 37 5.2.3 Hardware Inventory with the Netboot Product hwinvent...................... 37 6 Installation of a New Windows OS using opsi 38 6.1 Creating a New Client using the opsi Management Interface........................ 38 6.1.1 Hardware Inventory with the Netboot Product hwinvent...................... 39 6.1.2 Create a New Client using the opsi-client-bootcd.......................... 39 6.1.3 OS-Installation: Complete the Base Package for Windows..................... 41 6.1.4 NT 6 family: Win10 / Win8.1 / Win7 / 2008R2.......................... 41 6.1.4.1 Creating a PE........................................ 41 6.1.4.2 Creating a PE using opsi.................................. 41 opsi Getting Started opsi-Version 4.0.7 iii 6.1.4.3 Manually Creating a PE.................................. 42 6.1.4.4 Tweaking a WinPE (WAIK / Windows 7)......................... 42 6.1.4.5 Tweaking a WinPE (ADK / Windows 8/10)....................... 42 6.1.4.6 Extending a PE....................................... 43 6.1.4.7 unattend.xml......................................... 44 6.1.4.8 Driver Integration...................................... 44 6.1.4.9 Providing the Installation Files............................... 44 6.1.4.10 Installation Log files..................................... 45 6.1.5 Windows Product Key......................................... 45 6.1.6 Start the Windows Installation.................................... 46 6.1.7 Structure of the Unattended Installation Products......................... 46 6.1.7.1 Directory Tree Overview.................................. 46 6.1.7.2 File Descriptions....................................... 47 6.1.7.3 Directory installfiles / winpe................................ 47 6.1.7.4 Directories opsi and custom................................. 47 6.1.7.5 Directory drivers....................................... 47 6.1.8 Simplified Driver Integration during the Automatic Windows Installation............ 47 6.1.8.1 General Driver Packages.................................. 48 6.1.8.2 Preferred Drivers....................................... 48 6.1.8.3 Drivers that will be Manually Assigned to Computers.................. 48 6.1.8.4 Drivers that will be Automatically Assigned to the Computers using the Fields <ven- dor>/<model>....................................... 49 6.1.8.5 Structure of the Driver Directory and Driver Files:.................... 49 6.1.8.6 Processing of the Different Levels of Driver Integration................. 49 6.1.8.7 Driver Addition and Checking............................... 50 7 Integration of New Software Packages into the opsi Server 54 7.1 A Brief Tutorial: How to write a opsi-winst Script............................. 54 7.1.1 Introduction.............................................. 54 7.1.2 Methods of Non-Interactive Installation............................... 54 7.1.3 Structure of a opsi-script / opsi-winst Script............................ 55 7.1.4 Primary Sections............................................ 55 7.1.5 Important Kinds of Secondary Sections............................... 56 7.1.6 Global Constants............................................ 57 7.1.7 Second Example: tightvnc....................................... 57 7.1.8 Elementary Commands for Primary Sections............................ 58 7.1.8.1 String Variable........................................ 58 7.1.8.2 Message / showbitmap................................... 58 7.1.8.3 if [else] endif......................................... 59 opsi Getting Started opsi-Version 4.0.7 iv 7.1.8.4 Functions........................................... 59 7.1.8.5 Error, Logging and Comments............................... 59 7.1.8.6 Requirements......................................... 59 7.1.9 Third example: The Generic Template opsi-template ........................ 59 7.1.10 Interactive Creation and Testing of a opsi-winst Script....................... 66 7.1.11 Suggestions on How to Solve Problems with opsi-winst Scripts.................. 70 7.1.11.1 Search for Unattend or Silent Switches.......................... 70 7.1.11.2 Some Important opsi-winst Commands.......................... 71 7.1.11.3 Installation When the User is Logged on......................... 72 7.1.11.4 Working with MSI-packages................................ 72 7.1.11.5 Customization after a silent/unattended Installation................... 73 7.1.11.6 Integration with Automated Answers for the setup Program.............. 73 7.1.11.7 Analyze and Repackage................................... 76 7.1.11.8 How to uninstall Products................................. 76 7.1.11.9 Known Issues with the 64 Bit Support........................... 77 7.2 Creating an opsi Package........................................... 77 7.2.1 Create, Pack, and Unpack a New Product.............................. 78 7.2.1.1 Create with opsi-newprod.................................. 79 7.2.1.2 Build the Package with opsi-makeproductfile....................... 86 8 More Information 88 opsi Getting Started opsi-Version 4.0.7 1 / 88 Chapter 1 Copyright The Copyright of this manual is held by uib gmbh in Mainz, Germany. This manual is published under the creative commons license Attribution - ShareAlike (by-sa). A German description