Manual

The following chapters provide an in-depth look at the user interface, focusing on managing clients with opsi-configed and working with depots. Additionally, these chapters will offer insights into various configuration options available for the opsi server, including managing client groups and handling products/packages.

User Interface

After successfully logging in, you will see the main window of opsi-configed. Below the menu bar on the left, there is a group of icons. From left to right, these icons allow you to reload all data, create new opsi clients, open a search mask for clients, save changed configurations, filter the client display, check which clients are connected, and retrieve session information.

Figure 1. opsi-configed: Icons on the Left

On the right side, there is also a group of icons. The first set of three icons selects the mode (see section Selecting the Mode). The five icons to the right each open separate dialogs for managing client groups and products, a dashboard, an overview of installed opsi extensions, and the License Management.

From almost all sections, you can copy data to the clipboard and paste it into other applications. Additionally, most opsi-configed tables support drag and drop, allowing you to conveniently transfer table data to a spreadsheet application.

Light and Dark Theme

Starting with opsi 4.3, opsi-configed supports a dark mode. To activate it, open the File menu and select Theme / Dark.

Figure 3. opsi-configed: Dark Mode

To switch back to the light theme, select Theme / Light from the File menu.

opsi-configed stores several settings on the local computer (where you launched the program), including the chosen theme, the last selected clients/groups, and depots. Thus, you will find the same settings upon restarting the program.

Selecting the Mode

Use the three icons on the top right (see Figure 2, “opsi-configed: Icons on the Right”) to switch between different modes:

Depending on your selection, the main window view changes, and different tabs are visible/active or appropriately grayed out.

Clients

This chapter introduces client management with opsi-configed and the features available after clicking the Client Configuration button in the top right overview. You will learn, among other things, how to search for specific clients and retrieve additional information like session data, how to create and manage clients and client groups, execute remote control commands, send pop-up messages, and more.

Searching Clients

After you have successfully logged in, the Clients tab in the center of the main window is activated. Here you see a list of clients that belong to the currently selected depot or the selection in the left sidebar (see section Grouping Clients). Right-clicking on the selected clients opens a context menu through which you can perform various actions, such as triggering events, sending messages, shutting down, and restarting, etc.

Figure 4. opsi-configed: Context Menu after right-clicking a Client

At the top, there’s a search box where you can enter a string. Right next to it, you decide through a drop-down menu where opsi-configed should search: in all columns (meaning all columns that are displayed in the current configuration), by client name, description, status (on/off), date (last seen), and by IP address. The Mode drop-down menu further refines the search:

Full-text search: Use the search just as you would on search engines, entering one or more search words separated by spaces. For a successful search result, at least one of your keywords must appear in one of the columns.
Start-text search: Begin your search with the string that you want to find at the start of an entry in a column.
Regular expression: Enter the search term as a regular expression to find rows where the text in a column matches patterns as defined in the rules of regular expressions. For details on these patterns, please see the Java documentation for java.util.regex.Pattern.

When you press the [Enter] key after entering your search expression, opsi-configed jumps to the next match (or to the next line if there is no match). Right-click in the search box to display additional options.

Figure 5. opsi-configed: Client Search

Examples of Search Patterns

Below are a few examples of simple and complex search patterns.

If you want to search for the string "Meyer" in the names or descriptions of PCs, you can use the pattern .eyer.. Here, the dot (.) represents any character, and the asterisk () represents any number of occurrences (of the preceding element). .*eyer. means the search pattern matches as long as there is something before eyer and something follows it. As any number of occurrences also includes no occurrence, the string "PC Meyer" would match, for example.

To ensure that strings like "Beyer" aren’t also found, the search pattern should be better specified as .[Mm]eyer.. The square brackets mean that exactly one of the listed characters (either an M or an m) must be present.

The second example demonstrates search patterns for products. 0.-opsi.*standard looks for all product names starting with 0, followed by any character, followed by -opsi, followed by any characters (in any number); ending with standard. If you want to ensure that the second character is a digit between 0 and 9, then use this expression: 0[0123456789]-opsi.*standard. As a shortcut for [0123456789], you can also write [0-9], as it represents a continuous subsequence of the sequence of all digits. This search pattern would match products such as 03-opsi-abo-standard and 05_opsi-linux_standard, for example.

Listing Clients

The table on the Clients tab shows the following columns by default:

Client name: Displays the FQDN, i.e. the client’s hostname and the domain name.
Description: This column may contain an optional description.
On: The column shows which clients are currently connected. To do this, click on the second icon from the right at the top left of the icon group. You can activate this feature on the login screen or via a command line parameter. By default, the test interval is set to 0 minutes, which means that this function is deactivated.

Figure 6. opsi-configed: Client can be reached.

Figure 7. opsi-configed: Client cannot be reached.

Figure 8. opsi-configed: Use this Icon to check which Clients are connected.

Last seen: Here you can see the date and time at which the client last reported to the software distribution via the opsiconfd service.
IP address: Displays the client’s IP address.

Click on a column title to reverse the order. Optionally, you can show additional columns by right-clicking on the table and opening the Visible columns entry in the context menu. Now select the columns that you would also like to show: WAN Configuration, System UUID, MAC address, Session information, Inventory number, Creation date, Install on shutdown and depot.

To permanently display the additional columns in opsi-configed, use the top right icon to change to the server configuration (see the chapter Server) and open the Host parameters tab. Edit the configed / configed.host_displayfields option accordingly.

Figure 9. opsi-configed: Configure the visible Columns in the Client List.

If you add the column Session information, the button Request session information from all clients in the icon group at the top left is activated.

Figure 10. opsi-configed: Use this Icon to request Session Information from all Clients.

When you press the button, the opsiconfd attempts to establish a connection with all clients and gather information about currently active user sessions. In the Session information column, you will then see the account name of each active session. You can also activate this function specifically for selected clients via the context menu or the Client menu. This helps to avoid unnecessary waiting for network timeouts if it tries to connect to computers that are turned off.

Since the search function for the client list includes all columns, you can also use it to search for clients where a specific user is logged in.

Selecting Clients

You can select one or several clients in the client list to edit them together. Use the funnel icon or go through the menu Selection / Show only selected clients to limit the list to your selected clients.

Figure 11. opsi-configed: Use this Icon to only show selected Clients.

You can add the selected clients to an existing group by dragging and dropping them onto a group name in the left sidebar.

Using the third icon from the left or through the Selection menu, you can start the free client search dialog, where you can search based on client and/or product properties.

Figure 12. opsi-configed: Use the Free Client Search to create your own Search Criteria.

You can conduct your search for clients not only based on general host properties but also using hardware and software components as search criteria, regardless of whether they were installed via opsi or another method. Use the asterisk (*) as a wildcard for any text input. Link your search criteria with logical AND or OR. Exclude certain results by prefixing a criterion with NOT.

To add more criteria to your search, use the Add criterion dropdown menu. Remove an unwanted criterion by clicking the trash bin icon on the right edge. To reset the search form to its initial state, simply click New search.

You can save your queries under any name and later retrieve them via Selection / Saved search queries. Adding a description when saving will display it as a tooltip in the dropdown list, helping you recall the contents of the saved search.

Figure 13. opsi-configed: Saved Search Queries

If new clients have been added to the environment between searches that match the saved search criteria, opsi-configed will also find them.

You can pass a saved search to opsi-configed at startup using the command line option -qs (see section Start Parameters). If you omit the name, the command will output a list of the saved queries.

Through the Selection menu, you can also specifically search for clients with failed actions, either related to a product or within a specific timeframe.

Figure 14. opsi-configed: Search for Failed Actions.

Grouping Clients

Using the tree view on the left panel, you can manage your clients in groups. The view is divided into three categories: GROUPS, DIRECTORY, and CLIENT LIST. The latter automatically displays all clients from the selected depots. The first two sections differ in how often a client can appear in them. A group is uniquely defined by its name and cannot be duplicated, whereas a client can be assigned to multiple groups. In the DIRECTORY branch, each client has a unique place: unless explicitly assigned to a subgroup, the client is automatically listed in the UNASSIGNED group.

When a client is selected, all groups to which it belongs are highlighted with a colored background.

Figure 15. opsi-configed: Tree View

The tree view offers the following features:

Click on a tree node, such as a group, to display all clients under this node in the middle on the Clients tab. No client is selected for editing.
If you want to mark individual clients for editing, click them directly in the tree view or select them with the mouse ([Ctrl]+Click or [Shift]+Click).
Double-clicking on a group not only displays the associated clients in the table but also selects them for editing at the same time.

This is especially useful when you are working on various tabs, for instance, if you have the Log files tab open and want to view logs for specific clients only.

Creating New Groups

You can easily create additional groups. Simply right-click on the parent group or node, such as GROUPS, and select Create subgroup.

Figure 16. opsi-configed: Create a new Group.

A dialog box then opens where you can enter a name and description for the new group.

Figure 17. opsi-configed: Enter Group Name and Description.

Adding Clients to Groups

There are several ways to add or move clients to groups via drag and drop (see the section Selecting Clients):

Drag clients directly from the client list (tab Clients) to a group to add them.
If you want to copy clients, drag them from a "normal" group, e.g., from the CLIENT LIST node, to another group.
To move a client, drag them from one DIRECTORY group to another DIRECTORY group.

Editing Groups

Right-click on a group to open a context menu. This menu offers options to edit or delete the group, select all clients contained within, and recursively remove all clients from the group and any subgroups.

Editing Clients

Right-click on the client list (tab Clients) or open the Client menu to display possible operations for opsi clients. In the main window, you also see a dialog on the right where you can configure a few properties and extensions for the client.

Figure 18. opsi-configed: The Client Menu

Install on Shutdown, UEFI, and WAN

You can make some settings in the field next to the client list. These include options like Install on shutdown (Windows), UEFI Boot, and WAN configuration.

The Linux client agent is a paid extension. This means that you need an activation file to unlock it. You will receive this file after you have purchased the extension. For evaluation purposes, we’re happy to provide you with a temporary license free of charge. Please contact us via email.

The WAN/VPN extension is a paid extension. This means that you need an activation file to unlock it. You will receive this file after you have purchased the extension. For evaluation purposes, we’re happy to provide you with a temporary license free of charge. Please contact us via email.

Install on shutdown (Windows): There’s a well-established process to configure installations upon the shutdown of a client (see the chapter opsi Installation on Shutdown (free)).
UEFI Boot: Configures a client for UEFI boot (see the chapter opsi with UEFI/GPT)
WAN configuration: Enables the WAN/VPN extension; if the module is not available, the checkbox appears grayed out.

The WAN configuration is read from the server host parameters configed.meta_config.wan_mode_off.*. If you have adopted the default settings of the parameters, the recommended configuration described in the chapter WAN/VPN Extension applies.

You can display information about the options Install on shutdown (Windows) and WAN configuration as a column in the client list, either via the right-click context menu or through the Client / Visible columns menu. This way, you can directly see in the overview which clients have these properties set, and you can filter and sort accordingly.

Figure 19. opsi-configed: Extended Column View for opsi Clients

Wake on LAN (WoL)

opsi-configed includes a scheduler for Wake-On-LAN events (WOL), which you can set up via the menu Client / "Wake up" client(s) / New scheduler. From version 4.0.7, the WOL feature offers the following configuration options:

Direct sending of the network signal to all selected clients.
Delayed transmission of the signal with an adjustable interval between two clients.
Setting a start time for the process via a scheduler.

If a client is assigned to a depot server other than the opsi config server, the transmission of the Wake-on-LAN signal does not occur directly. In this case, an HTTPS connection to the opsiconfd on the depot server is established. The depot server is then responsible for sending the network packet within its network.

Figure 20. opsi-configed: Scheduler for Wake on LAN (WoL)

Please be aware that opsi-configed triggers the Wake-On-LAN actions. Therefore, it is crucial that the program remains active throughout the process and is not terminated.

Triggering Events (Push Installation)

Under Client / Trigger opsiclientd event / on_demand, you can send a call to the client agent of all selected clients to trigger an event. If a client is unreachable or is currently processing another non-interruptible event, opsi-configed will display an error message.

The default event is on_demand. This ensures that action requests for the client are executed immediately.

If a product script includes a reboot request, the client will be restarted without warning.

Since version 4.0.4, it is also possible to trigger other events configured in the opsiclientd.conf file. The available options are determined by the server host parameter configed.opsiclientd_events.

WAN Clients: Deleting Package Cache

For clients connected over a Wide Area Network (WAN), issues with the package cache can occasionally arise. To address these difficulties, a special function is available for these clients: Menu Client / For WAN clients: clear package caches completely resets the cache.

Sending Messages

You can send messages to one or several clients. Select them and then open Client from the menu and choose Send pop-up message. In the dialog box that opens, type your message. In the top right field, you can enter the desired display duration; leave the field empty to display the message indefinitely.

Figure 21. opsi-configed: Send a message to Client(s).

Click on the red checkmark to send the message.

Figure 22. opsi-configed: Client message window

Requesting Session Information

Through the Client menu, you can send a signal to selected clients prompting them to submit their session information to opsi-configed. This information will be displayed in the designated column on the Clients tab, provided that this column is enabled and visible.

Shutdown/Reboot

You have the option to send a signal to selected clients instructing them to shut down or reboot.

Please be aware that clients may shut down without further inquiry, which can lead to data loss if there are unsaved data or active processes on the client.

Starting Remote Control Software

Using the Client menu / Launch Remote Control Software (key [F7]) or the right-click context menu, you can execute any operating system commands on the selected clients. By default, there are four entries that serve as templates for your own commands: sending a ping command to Linux and Windows clients, as well as displaying the info page on Windows and Linux (see the section opsiclientd Info Page).

Figure 23. opsi-configed: Starting Remote Control Software

Please note that opsi-configed executes these commands from its own system environment. This means that the type of command required depends on whether you are running opsi-configed on Windows or Linux.

The dialog is divided into three areas:

In the top area, you will find a list of the names of the available commands.
Below that is a line showing the selected command. Here, you can edit the command if allowed. This line also includes buttons to start and abort the action.
In the third text area of the window, any system feedback from the command execution is displayed.

The applications of this feature are extremely diverse. For example, you can configure a command to establish a remote desktop connection to the selected client, provided that the client supports it. On Windows, you could use the following command for this purpose:

cmd.exe /c start mstsc /v:%host%

A corresponding Linux command is like this:

rdesktop  -a 16 %host%

opsi-configed automatically replaces %host% with the corresponding value for the host name. In addition to %host%, there are other variables available that you can use in the commands:

%ipaddress%: IP address
%hardwareaddress%: MAC address
%opsihostkey%: opsi host key
%inventorynumber%: Inventory number
%depotid%: Depot ID
%configserverid%: Config server ID

You can edit the commands in the server configuration on the Host parameters tab, configed / remote_control:

Figure 24. opsi-configed: Configure the Remote Control Commands.

If a command has the .editable attribute set to true, you can enter variations of the command in the displayed command line, including options or passwords.

This gives the opsi-configed user the ability to freely extend a command and execute all possible commands on the client.

Defining your own Remote Control Command

To define your own command, go to the server configuration under the Host parameters tab, section configed / remote_control. As an example, we will set up a command named example. You will need at least the entry configed.remote_control.example (or alternatively configed.remote_control.example.command). In this entry, you define the command to be executed using the variables shown in the last section, such as %host%, %ipaddress%, etc.

Additionally, you can create an entry configed.remote_control.example.description to explain the new command. The value of this entry will then be displayed as a tooltip to provide users with more information about the command.

Furthermore, you can determine whether the command should be editable or not with a boolean entry configed.remote_control.example.editable. Setting this value to false specifies that users cannot modify the command when invoking it.

Adding Clients

Navigate to Client / Create new opsi client to open a dialog window where you can enter all the information required to create a new client.

Figure 25. opsi-configed: Adding a new Client

The dialog also provides fields for entering the IP address and the hardware address (MAC address). If the backend is enabled to configure a local DHCP server (which is not the default setting), this information is used to register the new client with the DHCP server. Otherwise, the MAC address is stored in the backend and the IP address is discarded.

When creating new clients, from opsi-configed version 4.0.5.8.1 onward, you can also directly specify these options:

Assignment of the new client to a specific group
Specification of a netboot product that may be directly set to setup
Activation of Install on Shutdown and WAN configuration

These settings can also be conveniently made in the hosts list.

Creating multiple Clients

Click the Template button at the top of the client creation dialog to generate a CSV template. Select the desired data you want to include by clicking the checkboxes. You can also define the escape and delimiter characters in this dialog window. Finally, click OK to generate the CSV file.

You can then edit this file with a text editor or spreadsheet to create a list of clients with their respective properties. You can import the list via the File button next to Import CSV File in the client creation dialog.

Figure 26. opsi-configed: Creating multiple Clients

Deactivate Creation/Deletion

Since version 4.0.4, it is also possible to disable the options for creating and deleting clients. This is useful when a service, such as a UCS service, is responsible for creating clients. To set up this feature, edit the server configuration’s host parameter configed.host_actions_disabled. Click in the column; the next dialog offers these three options:

add client
free licenses for client
remove client

Multiple selections are possible.

You can change the settings not only in opsi-configed but also on the command line. Enter the following command to disable the creation and deletion of clients via opsi-configed:

opsi-admin -d method config_updateObjects '{"defaultValues": ["add client", "remove client"], "editable": false, "multiValue": true, "possibleValues": ["add client", "remove client"], "type": "UnicodeConfig", "id": "configed.host_actions_disabled"}'

Renaming and moving Clients

You can also access entries for renaming and moving to another depot via the Client menu. The latter allows multiple selection of clients. In the following dialogue window, select the desired depot from the drop-down menu and then confirm your choices by clicking OK.

Figure 27. opsi-configed: Move Clients to another Depot

Deleting Clients

Select one or more clients and then navigate to Client / Remove client(s) in the menu. A dialog with a security prompt will appear, and you must explicitly confirm your intention to remove the client from the opsi database.

Resetting Products

This function allows you to delete all product-related information from the selected clients. This is especially useful if you need to reset a test client to a certain state.

Localboot Products

When you switch to the Localboot products tab, you’ll see a detailed list of products available for software distribution along with their installation and action status relative to the selected clients.

In the right sidebar, additional useful information about the selected product is displayed, including the product name and version. The fields for product information and description support Markdown, which is particularly beneficial if you have used the control.toml file when creating the product (see the section Example: control Fatei)

Additionally, a table lists potential product dependencies, displaying detailed properties and a tree structure that visualizes the dependencies recursively. This helps you not only identify which other products are required by the selected product but also which products depend on it. This feature is particularly useful if you want to check whether a product is still needed by other products before removing it.

Figure 28. opsi-configed: List of Localboot Products with detailed View on the right

Just like in the client list, you can use the search field above the table to search for names and other values in the table. To the right of the search field, you’ll find filters. For more information, refer to section Searching Clients.

Sorting the List

Like in the client list, you can adjust the view by clicking on the column title. The following columns are available:

Product ID: Displays the name of the product.
Status: Shows the last reported status of this product to the software distribution (installed, not_installed, or undefined). For clarity, not_installed is not displayed. undefined is typically the status during an installation or uninstallation, or if the last script failed.
Report: Here you see a summary of the values of the internal status information actionProgress (installation progress), actionResult (result of the last action), and lastAction (last requested action). During an installation, for example, it may display installing. After an action is completed, the field shows the outcome, such as success (setup) or failed (setup).
Requested action: Displays the action that is supposed to be executed. Possible values are none (visually the field is empty), setup, uninstall, update, once, always, and custom.
Version: The version number is a combination of the product version and the package version of the opsi software product installed on the client.

Use the right-click context menu and Visible columns to display additional columns for localboot products:

Product name: Displays the name of the application.
Target configuration: The desired state, possible values: undefined, installed, always, and forbidden.
Priority: Indicates the priority assigned to the product; possible values range from 100 to -100.
Position: Displays the order in which the products are to be installed.
Last status update: The time of the last update.

Displaying Detailed Information

When you select a product, additional information appears on the right side of the window:

Software/package version: Displays a combination of product and package version as specified by the packager.
Product description: Free text about the software included in the package.
Notes: Free text with details on how to handle this package.
Product dependencies: A list of products that the selected product depends on, including the type of dependency: required (the selected product needs the displayed product, installation order does not matter), pre-required (the displayed product must be installed before the selected one), and post-required (the displayed product must be installed after the selected one).
Property configuration: For client-specific customization of the installation, additional properties may be defined for a product; the next section describes these property tables.

Property Configuration

A property table consists of two columns. The left column lists the names of the properties, and the right column shows the associated value.

Rows that deviate from the standard values (server defaults) are highlighted in bold. This allows you to see at a glance where settings have been adjusted.

Above the table on the right, there are two buttons:

Set client values to server defaults (left): This button copies the server defaults as client-specific settings. These settings remain with the client even if the default values are changed later.
Remove client-specific values (right): This button deletes all settings on the client; thereafter, the server defaults apply again. Any changes to these default values will directly affect the client.

If you hover over a row with your mouse pointer, a tooltip appears (if configured), showing useful information about the meaning of the value as well as the server default.

Figure 29. opsi-configed: Property Table

Click on a value in the right-hand column to open a dialogue for editing. Here you can, for example, select from a list of preconfigured values.

Figure 30. opsi-configed: List Editor, Selection List

Click on a (different) value in the dialog to change the setting.

In addition to these dialogs, there are also windows that display an editing field. You can enter new values here:

Figure 31. opsi-configed: List Editor, Field for Custom Values

To modify an existing value, double-click it in the list. To add new values, click the plus sign to include them in the list. Some properties allow the entry of multiple values. In such cases, the list editor also permits multiple selections. You can easily select multiple entries by holding down the [Ctrl] key while clicking.

Once you have made changes to the values in the list, the green checkmark will change color. Click on the now red checkmark to apply your changes. Otherwise, click on the blue cancel button to reset the changes.

Secret Property Values

For cases where passwords or other "secrets" are included as property values, the following provision is in place (as a "hack" since version 4.0.7, until a specific data type is established):

If 'password' appears anywhere in the name of the property,
or if the property name starts with 'secret',

the property value is replaced with five * in the display. It is only made visible (after a warning) when clicked for editing.

Editing is done as usual in the standard case.

Netboot Products

Products on the Netboot products tab are displayed and configured similarly to the Localboot products tab.

The listed products attempt to set boot images to start on the selected clients upon their next reboot when set to setup. This is typically used for OS installation.

Figure 32. opsi-configed: List of Netboot Products with detailed View on the right

Hardware Informationen

This tab shows information about the client’s hardware, either detected by the boot image or by the localboot product hwaudit.

Figure 33. opsi-configed: Hardware Information Tab

Integrating Drivers Automatically

Since version 4.0.5, opsi has offered the option to automatically upload client drivers to the opsi depot server from selected paths derived from hardware information. These paths, known as ByAudit paths, include the manufacturer’s name and the product or model name extracted directly from the motherboard. Click on Upload drivers and configure further settings in the dialog that opens.

Figure 34. opsi-configed: Hardware Information, Driver Upload

On Linux systems, direct driver upload is initially not possible due to the connection via a share and must be performed manually. However, on a Windows system, driver upload works seamlessly once the connection to the share is active.

In the dialog window, specify details including the Windows product for which the driver is intended, the driver to be uploaded, the method, and the target directory for driver integration. Choosing a different method changes the target directory accordingly. Here is a list of methods and directory structures for driver integration:

Standard:
- Directory: ./drivers/drivers
- Function: Drivers in this directory are identified by their PCI, USB, or HD_Audio identifiers and integrated into the Windows setup.
- Disadvantage: May contain drivers that are not compatible with the available hardware. Nonetheless, you can store drivers here as a fallback for all clients.
Preferred:
- Directory: ./drivers/drivers/preferred
- Function: Drivers in this directory are given priority. The mapping is also based on identifiers in the description file. Direct assignment is required for multiple drivers for one PCI-ID.
- Caution: If different drivers for one PCI-ID exist under preferred, it can lead to problems with driver assignment; assign the drivers directly to the devices.
Excluded:
- Directory: drivers/exclude
- Function: Contains drivers that should be excluded, e.g., due to operating system incompatibilities or incorrect configurations. If you suspect that a linked driver is incorrect, move it to drivers/exclude and run create_driver_links.py again.
Additional:
- Directory: ./drivers/drivers/additional
- Function: Contains additional drivers that should be installed regardless of hardware identifiers. Paths to these directories are assigned to a client through the product property additional_drivers. Specified directories are recursively searched; symbolic links are considered, and all contained drivers are included.
byAudit:
- Directory: ./drivers/drivers/additional/byAudit/<Vendor>/<Model>
- Function: Drivers are categorized by specific hardware vendor and model designations and considered during the Windows installation if they match. Such directories are treated as if they were manually assigned through the additional_drivers property.

Some manufacturers use names with special characters, such as 5000/6000/7000. Since opsi version 4.0.3, the following special characters are internally replaced by an underscore (_): < > ? " : | \ / *

After uploading drivers to ./drivers/drivers or ./drivers/drivers/preferred, make sure to run the script create_driver_links.py on the depot server!

Software Informationen

This tab contains the latest information retrieved with swaudit about installed software on the client.

Figure 35. opsi-configed: Software Informationen

Logdateien

Auf dem Reiter Logdateien sind die Logdateien der Clients über den opsi-configed einsehbar.

Der Level, bis zu dem die Logeinträge sichtbar sind, kann mit einem Schieberegler variiert werden, so dass Fehler leichter gefunden werden können. Den Regler können Sie auch mit dem Mausrad bedienen.

Dabei kann auch in den Logdateien gesucht werden (Fortsetzung der Suche mit [F3] oder [Strg]+[L]). Die einzelnen Zeilen sind je nach Loglevel farbig hervorgehoben.

Figure 36. opsi-configed: Logdateien betrachten

Host-Parameter: Client- und Server-Konfiguration

Eine ganze Reihe von Konfigurationsvorgaben können Sie über den Reiter Host-Parameter vornehmen. Befinden Sie sich im Modus Client-Konfiguration, zeigt Host-Parameter die clientspezifischen Einstellungen an. Ist hingegen die Server-Konfiguration aktiv, sehen sie die jeweiligen Server-Defaults.

Konfigurationseinträge (config-Objekte des opsi-Servers) sind grundsätzlich Wertelisten. Als Werkzeug zur Bearbeitung der Werte dient daher der Listeneditor (vgl. Property Configuration )

Je nach Typ des jeweiligen Konfigurationsobjektes

können die Elemente der Liste entweder Unicode-Textwerte oder boolesche Werte (true/false) sein;
kann die Gesamtheit der zulässigen Listenelemente fest oder erweiterbar sein;
umfasst der DefaultValues-Eintrag des Objektes im singleValue-Fall genau ein Listenelement, bei multiValue-Objekten eine beliebige Auswahl aus den zulässigen Listenelementen.

Neue Konfigurationseinträge können über das Kontextmenü auf der Server-Host-Parameter-Seite erstellt werden. Ebenso können dort bestehende Objekte gelöscht werden.

Figure 37. opsi-configed: Host-Parameter (Kontextmenü eines Client-Eintrags)

Das Verhältnis von Server- und Client-Host-Parametern ist verwickelt:

Server-Einträge liefern die Default-Werte für die Client-Einträge.
Konsequenterweise muss, um einen Client-Eintrag zu erhalten, zuerst ein Server-Konfigurationsobjekt angelegt werden.
Und, wenn ein Server-Eintrag (das Config-Objekt) gelöscht wird, verschwinden auch die zugehörigen Client-Einträge (die auf ConfigState-Objekten beruhen).
Es kann sowohl bei Abweichung des Client-Wertes vom Server-Default als auch, wenn die beiden derzeit identisch sind, einen eigenen Eintrag des Clients in der Datenbank geben. Sofern es diesen eigenen Eintrag gibt, bleibt er auch erhalten, wenn sich der Server-Default ändert.
Zum Umgang mit diesem Thema gibt es daher ab configed Version 4.0.7.6.5 für die Client-Properties ein Kontextmenü mit den beiden Optionen "Spezifischen Client-Wert entfernen" (d.h., der Clientwert ist immer der gerade aktuelle Default-Werte des Servers) und "Setze den jetzigen Default-Wert als (dauerhaften) Wert für den Client.
Wenn der Client-Wert sich vom aktuellen Server-Default unterscheidet, so ist dieser fett dargestellt.
Es kann Konfigurationsobjekte geben, für die theoretisch Client-Werte erzeugt und bearbeitet werden können, die jedoch keinerlei Bedeutung haben, weil eigentlich nur serverbezogene Informationen gespeichert werden. Diese Properties sind in den aktuellen configed-Versionen in der Regel ausgeblendet.

Zur besseren Übersicht sind die Host-Parameter gegliedert nach Funktionsgruppen aufgeführt. Die Gruppen werden auf der linken Seite in einer baumartigen Struktur aufgeführt. Jeweils die zugehörigen Parameter und ihre Werte erscheinen auf der rechten Seite.

Figure 38. opsi-configed: Host-Parameter in der Client-Konfiguration

Depots

Betreiben Sie in Ihrer Umgebung mehrere Depotserver, enthält opsi-configed alle Werkzeuge, um diese flexibel auszuwählen und zu nutzen. Dieses Kapitel erklärt, wie Sie opsi-Depotserver mit opsi-configed verwalten. Es zeigt, wie Sie mit der Mehrfachauswahl arbeiten, eine Übersicht über die zugehörigen Clients erhalten und stellt die Funktionen der Depot-Konfiguration vor. Weiterhin erfahren Sie, wie Sie Standard-Propertys für Produkte über verschiedene Depots hinweg verwalten und anpassen können.

Depotauswahl

Wenn Sie mehrere opsi-Depotserver betreiben, tauchen diese untereinander in der Liste am linken Seitenrand auf. In der Voreinstellung ist das Depot auf dem opsi-Configserver markiert, und opsi-configed zeigt die zu diesem Depot gehörenden Clients an.

Figure 39. opsi-configed: Depotauswahl

Die Liste der Depotserver unterstützt eine Mehrfachauswahl, das heißt, Sie können mehrere Depots markieren und damit alle zugehörigen Clients anzeigen. (Genauer gesagt: Sie sehen dann alle Clients, die auf irgendeinem der ausgewählten Depots zur ausgewählten Gruppe gehören.)

Sie können Clients nur gemeinsam bearbeiten, wenn sie Depots mit identischer Paket-Konfiguration haben. Das bedeutet, dass die Depots synchron sein müssen. Wenn Sie versuchen, Clients aus asynchronen Depots gemeinsam zu bearbeiten, erhalten Sie eine entsprechende Warn- oder Fehlermeldung.

Sie können mehrere Depots in der linken Seitenleiste auswählen:

(=+): Wählt alle Depots mit identischen Produkten aus.
(++) oder Shortcut [Strg]+[A]: Wählt alle Depots aus.
Suchfeld am oberen Rand: Geben Sie den Namen der gewünschten Depots ein.

Beachten Sie, dass die Gruppenauswahl bei einem Depotwechsel erhalten bleibt. Das ist nicht immer das gewünschte Verhalten. Gegebenenfalls aktivieren Sie für das neu ausgewählte Depot eine andere Gruppe bzw. die ganze Client-Liste.

Im Modus Depot-Konfiguration (siehe Abschnitt Modus auswählen) erreichen Sie über das Hauptfenster die beiden Reiter Depot-Konfiguration und Standard-Propertys. Wählen Sie aus der Liste der Depotserver am linken Rand ein Depot aus, um die Einstellungen über die Reiter anzupassen.

Depot-Konfiguration

Auf diesem Reiter können Sie die aktuelle Konfiguration des ausgewählten Depots einsehen und bearbeiten. Dazu gehören Parameter wie die URL, die Netzwerkadresse der Freigabe, die IP-Adresse usw. Klicken Sie jeweils in der rechten Spalte auf einen Property-Wert, um einen Dialog zur Bearbeitung zu öffnen. Abschließend klicken Sie oben links auf das rote Häkchen, um die Konfiguration zu speichern.

Figure 40. opsi-configed: Reiter Depot-Konfiguration

Standard-Propertys

Um die Standardwerte der Localboot- und Netboot-Produkte für einzelne oder mehrere opsi-Depots zu ändern, öffnen Sie den Reiter Standard-Propertys. Die Tabelle zeigt alle Produkte, deren Namen, den Typ, die Produkt- und die Paketversion an. Wählen Sie ein Produkt aus, um die Detailansicht am rechten Rand zu öffnen (siehe Abschnitt Detaillierte Informationen anzeigen). Darunter zeigt ein Feld alle Depots an, die das ausgewählte Produkt enthalten.

Figure 41. opsi-configed: Standard-Propertys

Sie können eines oder mehrere Depots auswählen, um die Defaultwerte (d. h. die Depotwerte) des Produktes zu ändern. Als Voreinstellung werden alle verfügbaren Depots ausgewählt. Mit den üblichen Tastenkombinationen ([Strg]+[A], [Strg]+-Klick oder [Shift]+Klick) markieren Sie mehrere bzw. alle Clients.

Ist der Property-Wert ausgegraut, dann hat dieses Property unterschiedliche Werte auf den ausgewählten Depots.

Über der Tabelle Property-Bearbeitung auf Depot(s) im rechten Fensterbereich finden Sie drei Buttons:

(=+): Markiere alle Depots mit identischen Werten
(++): Wähle alle Depots aus
(Weltkugel): Setze die Standard-Paket-Werte für ausgewählte Depots

Server

Wenn Sie rechts oben auf das Icon Server-Konfiguration klicken, öffnet sich der Reiter Host-Parameter in der Mitte des Fensters. Er zeigt die Server-Defaults der Host-Parameter.

Host-Parameter für den Server

Grundsätzlich funktioniert die Anzeige und die Bearbeitung der Host-Parameter genauso wie dir für die Clients (Host-Parameter: Client- und Server-Konfiguration). Sie klicken in die Spalte Property-Wert und nehmen Ihre Anpassungen dann im sich öffnenden Dialogfenster vor.

Figure 42. opsi-configed: Host-Parameter in der Server-Konfiguration

Verwaltung von Benutzerrechten und -rollen

Wenn die opsi-Erweiterung Benutzerrollen aktiviert ist, können Sie diese mit dem `opsi-configed`in den Host-Parametern des Servers bearbeiten.

Es handelt sich um eine kostenpflichtige Erweiterung. Das heißt, dass Sie eine Freischaltdatei benötigen. Sie erhalten diese, nachdem Sie die Erweiterung gekauft haben. Zu Evaluierungszwecken stellen wir Ihnen kostenlos eine zeitlich befristete Freischaltung zur Verfügung. Bitte kontaktieren Sie uns dazu per E-Mail.

In der Baumansicht erscheint der Eintrag user, das heißt aber nicht, dass die Funktion aktiv ist. Der Standardwert für user.{}.register ist false. Setzen Sie diesen auf true und spielen Sie die Modules-Datei ein, um das Feature (temporär oder dauerhaft) zu aktivieren. Anschließend wird für den angemeldeten Benutzer ein Eintrag in der Baumstruktur erzeugt. Die dabei für die Rechteverwaltung verwendeten Standardeinstellungen entsprechen den "klassischen" Vorgaben für einen Administrator. Für diesen gibt es keine Einschränkungen. Heißt der Account admindepot1 ein, sieht das beispielsweise so aus:

user.{admindepot1}.privilege.host.all.registered_readonly       [false]
user.{admindepot1}.privilege.host.depotaccess.configured        [false]
user.{admindepot1}.privilege.host.depotaccess.depots            []
user.{admindepot1}.privilege.host.opsiserver.write              [true]

Die vier Einträge bedeuten:

Der Benutzer hat nicht einen rein lesenden Zugriff; ein reiner Read-only-Zugriff wäre möglicherweise für einen Helpdesk-Mitarbeiter angemessen.
Es gibt keine Restriktionen bezüglich des Depots (bzw. diese werden nicht berücksichtigt).
Entsprechend kann die Liste der für den Benutzer zugänglichen Depots leer bleiben. Selbst wenn hier etwas eingetragen wäre, hätte dies keine Wirkung, solange depotaccess.configured auf false steht.
Der Benutzer darf Einstellungen aller Art bearbeiten.

Soll der Benutzer admindepot1 nur noch Zugriff auf die Rechner des Depotservers mit dem Namen depot1 haben, stellen Sie Folgendes ein:

user.{admindepot1}.privilege.host.depotaccess.configured setzen Sie auf true.
In die Liste für den Wert user.{admindepot1}.privilege.host.depotaccess.depots tragen Sie depot1 als Wert ein.

Nachdem Sie alle Daten neu geladen haben, sind für admindepot1 keine Clients aus anderen Depots mehr sichtbar. Zusätzlich darf er auch nur noch die Einstellungen für depot1 verändern.

Der Benutzer kann alle Einschränkungen selbst aufheben, solange die Einstellung host.opsiserver.write auf true gesetzt ist. Ändern Sie den Wert auf false, um die Abriegelung komplett zu machen.

Die auf diese Weise eingerichteten Privilegien betreffen ausschließlich die Funktionalität von opsi-configed. Sie haben derzeit keine Auswirkung auf das JSON-RPC-Interface des opsi-Servers.

Die restlichen Einträge, die in der Baumansicht auftauchen, betreffen die Konfiguration der Server-Konsole (siehe Kapitel Server-Konsole).

Gruppen und Produkte

Dieses Kapitel stellt die beiden Dialoge vor, über die Sie Aktionen für Client-Gruppen und Produkte/Pakete in opsi-configed durchführen.

Aktionen für Client-Gruppen

Über die Schaltfläche Gruppen (Spezialfunktionen) rechts oben öffnen Sie ein neues Dialogfenster, in dem Sie Aktionen für Client-Gruppen festlegen (siehe Abschnitt Clients gruppieren). Derzeit steht nur eine Funktion zur Verfügung: die Suche nach einem Betriebssystem, das auf allen PCs der ausgewählten Gruppe schon installiert war und daher zurückgespielt werden kann.

Figure 43. opsi-configed: Gruppenaktionen (für opsi-local-image)

Aktionen für Produkte/Pakete

Neben der Schaltfläche für die Gruppenaktionen finden Sie das Icon Produkte (Spezialfunktionen), das ebenfalls ein eigenes Dialogfenster öffnet. Hier stehen zwei Funktionen zur Verfügung:

Sie können eine .opsi-Datei (ein opsi-Paket) auswählen bzw. den Pfad zur Datei von Hand eingeben. Das Paket können Sie dann auf den opsi-Server laden. Die Standard-Workbench (Netzwerkfreigabe) ist als Zielverzeichnis voreingestellt. Das Icon unter dem Feld stößt das Kommando zum Installieren des Paketes an.
In der unteren Fensterhälfte haben Sie die Möglichkeit, WinPE-Dateien bzw. Installfiles für ein Windows-Produkt zum Server hochzuladen. Das Zielverzeichnis für das opsi-Depot ist die Standardfreigabe.

Figure 44. opsi-configed: Paket- und Produktaktionen

Server-Konsole

Über den Menüeintrag Server-Konsole können Sie aus dem opsi-configed heraus über eine SSH-Verbindung Aktionen auf dem opsi-Server auslösen. Klicken Sie auf den Eintrag, sehen Sie an erster Stelle, ob Sie bereits per SSH mit dem Server verbunden sind (Checkbox SSH-Verbindung direkt starten im Logindialog). Darunter finden Sie Einträge, um die SSH-Verbindungsdaten zu ändern und die vordefinierten Kommandozeilenbefehle zu bearbeiten, die der Menüpunkt opsi anzeigt. Fahren Sie mit dem Mauszeiger über einen Eintrag, um einen Tooltip einzublenden.

Figure 45. opsi-configed: das Menü Server-Konsole

SSH-Verbindungsdaten

Sofern nicht anders konfiguriert, versucht opsi-configed für die SSH-Verbindung den angemeldeten Benutzer mit dem opsi-Configserver zu verwenden. Im Dialogfenster, das Sie über das Menü Server-Konsole / SSH-Verbindungsdaten öffnen, können Sie die Checkbox SSH-Schlüssel für Authentifizierung verwenden aktivieren und in den Feldern darunter einen SSH-Schlüssel auswählen. Ist für diesen eine Passphrase eingerichtet, tragen Sie diese optional im Feld darunter ein.

Figure 46. opsi-configed: SSH-Verbindungsdaten

Alternativ können Sie SSH-Schlüssel und -Passphrase schon beim Start über die folgenden beiden Parameter angeben (siehe Abschnitt Startparameter):

--ssh-key <pfad-zum-schluessel>, z. B. --ssh-key /home/user/.ssh/id_rsa
--ssh-passphrase <passphrase>

Berechtigungen

Über Server-Host-Parameter (siehe Abschnitt Host-Parameter für den Server) können Sie steuern, welche der Menüpunkte sichtbar sind bzw. welche Funktionen der angemeldete Benutzer verwenden darf. Ist die opsi-Erweiterung Benutzerrollen aktiviert, können Sie die Berechtigungen für unterschiedliche Benutzeraccounts festlegen. Für neu angelegte Accounts gelten die Standardwerte.

Die folgenden Einträge gibt es:

user.{}.ssh.serverconfiguration.active
user.{}.ssh.commandmanagement.active
user.{}.ssh.menu_serverconsole.active
user.{}.ssh.commands.active

Sie bedeuten:

aktiviert das Menü der SSH-Verbindungseinstellungen (Default: false)
aktiviert die Bearbeitung von Menüeinträgen der Kommandozeilenbefehle (Default: false)
gibt den Hauptmenüeintrag Server-Konsole als solchen frei (Default: true)
schaltet alle SSH-Menüeinträge frei, die hinterlegte Befehle darstellen (Default: true)

Vordefinierte Befehle

Im Menü Server-Konsole / opsi stehen vordefinierte Kommandozeilenbefehle bereit, die folgende Aktionen ausführen:

Package-Updater: Installieren oder aktualisieren Sie Pakete mit dem opsi-package-updater; im sich öffnenden Dialog wählen Sie aus dem Drop-down-Menü Aktion entweder den Eintrag Pakete aktualisieren , Alle Repositorys auflisten oder Pakete installieren.
Paket-Installation: Installieren Sie opsi-Pakete mit dem *opsi-package-manager auf allen oder einzelnen Depots. Sie können den Pfad zum Paket angeben oder ein Paket aus dem Internet herunterladen.
Paket-Deinstallation: Wählen Sie aus einer Liste eines oder mehrere Pakete zur Deinstallation mit dem opsi-package-manager aus.
opsi-Paket packen: Geben Sie ein Verzeichnis auf dem Server an, in dem Dateien für ein opsi-Paket liegen. Über eine Schaltfläche können Sie die in der control-Datei gefundenen Versionen (Paket- und Produkt-Version) anzeigen und ggf. überschreiben. Über einen Klick auf Erweiterte Optionen blenden Sie Checkboxen ein, über die Sie Zsync- oder Md5-Dateien erstellen sowie die Rechte im Anschluss setzen. Die Schaltfläche Das neu erstellte Paket installieren ruft den opsi-package-manager auf.
Datei-Download: Laden Sie eine beliebige Datei aus dem Internet mit wget herunter und legen diese auf dem Server im Verzeichnis Ihrer Wahl ab.
Modules-Datei hochladen: Laden Sie eine Freischaltdatei für opsi-Erweiterungen zum Server hoch. Diese wählen Sie entweder auf dem lokalen Rechner aus oder laden Sie mit wget aus dem Internet herunter. Optional können Sie Zugangsdaten für den wget-Befehl eingeben.
opsi-Rechte setzen: Korrigiert die Zugriffsrechte von Dateien und Verzeichnissen auf einem opsi-Server und ruft dazu das Kommando opsi-set-rights auf.
opsi-Client-Agent verteilen: Um existierende Rechner als Clients in die opsi-Umgebung aufzunehmen, muss auf diesen der Client-Agent installiert werden. Wählen Sie hier die gewünschten Rechner aus; um den Befehl auf mehreren Clients gleichzeitig auszuführen, müssen die Logindaten auf diesen gleich sein.

Das Skript zum Deployen der Clients muss im Verzeichnis /var/lib/opsi/depot/opsi-client-agent liegen und opsi-deploy-client-agent heißen (siehe Kapitel Clients hinzufügen).

Einige Dialoge (z. B. opsi-Rechte setzen oder Paket-Installation) haben Buttons zur Auswahl von lokalen Dateien. Betätigen Sie die Schaltfläche Ermittle Unterverzeichnisse, um alle Verzeichnisse und Dateien aus dem angegebenen Pfad aufzulisten. Um weitere Ebenen mit einzubeziehen, klicken Sie den Button mehrfach.

Befehle definieren

Sie können über den Eintrag Befehle definieren auch eigene Kommandozeilenbefehle definieren, die sie dann über das Menü Server-Konsole erreichen.

Beachten Sie, dass nicht alle Linux-Distributionen dieselben Befehle bzw. Parameter verwenden. Stellen Sie als Administrator sicher, dass die Distribution für den opsi-Server die Kommandos unterstützt.

Figure 47. opsi-configed: Befehle definieren

Sie können die folgenden Angaben im Dialog Befehle bearbeiten machen:

Menütext des Befehls: Der Menüeintrag muss eindeutig sein und darf nicht an anderer Stelle verwendet werden. Um einen Menütext zu ändern, löschen Sie den Befehl über das Icon mit dem Minuszeichen und erstellen dann einen neuen Befehl. (obligatorische Einstellung)
Übergeordnetes Menü: Legt fest, in welchem Menü der neue Befehl als Menüeintrag erscheinen soll. Lassen Sie das Feld leer, erscheint er automatisch im Menü Server-Konsole. (optionale Einstellung)
Beschreibung: Hinterlegen Sie hier eine Beschreibung, dann taucht sie als Tooltip-Text des Befehls auf. (optionale Einstellung)
Position im Menü: Die Position bestimmt die Reihenfolge (kleine Zahlen zuerst) der Menüpunkte insgesamt und damit innerhalb des jeweiligen Menüs. (optionale Einstellung)
Root-Rechte benötigt: Aktivieren Sie die Checkbox, wenn ein Kommando administrative Rechte benötigt. (optionale Einstellung)
Befehlsliste: Tragen Sie hier die Linux-Befehle ein, einen pro Zeile, um sie nacheinander aufzurufen. (obligatorische Einstellung)
Über das Drop-down-Menü Als Parameter in Befehl einfügen stehen verschiedene optionale Datenquellen für die Befehlsliste zur Verfügung:
- Interaktive Eingabe: Parameter nicht fest vorgeben, sondern interaktive Eingabe in der Form <<<"Interaktive Eingabe">>>, wobei wir empfehlen, eine Beispieleingabe zu notieren.
- Configserver
- IP-Adressen der ausgewählten Clients
- IP-Adressen der ausgewählten Depots
- Namen der ausgewählten Clients
- Namen der ausgewählten Depots
- Optionen für Skript auswählen
- Verbundener SSH-Server

Außer bei der interaktiven Eingabe kann die Rückgabe der Methoden formatiert werden, beispielsweise als durch Kommata voneinander getrennte Liste.

Figure 48. opsi-configed: Befehl ausführen, Parameterabfrage

Operatoren wie AND (&&), || (OR), das Pipezeichen (|) sowie Umleitungsoperatoren (>, < und >>) für die Linux-Befehle sind erlaubt. Beachten Sie, dass keine Benutzereingaben während der Ausführung möglich sind. Kombinieren Sie zwei Befehle und erfordert das erste Kommando Root-Rechte, aktivieren Sie die erwähnte Checkbox; erfordert das zweite ebenfalls Root-Rechte, notieren Sie sudo im Befehl:

apt-get update --yes && sudo apt-get upgrade --yes

Module (Lizenzstatus)

Über das Menü Hilfe / Validierungsstatus der opsi-Module können Sie den aktuellen Lizenzstatus der opsi-Module einsehen.

Figure 49. opsi-configed: Validierungsstatus der opsi-Module

Die Tabelle zeigt zu jedem Modul an, ob es Modul erworben wurde bzw. verfügbar ist. Über Checkboxen am unteren Rand bestimmen Sie, ob Sie den vollständigen zeitlichen Verlauf sowie nur verfügbare oder alle Erweiterungen anzeigen. Die Tabelle zeigt außerdem an, wie lange die Lizenz noch gültig ist und für wie viele Clients sie gilt. Die Spalte mit dem Datum in der Zukunft stellt künftige Änderungen dar, z. B. wann eine Lizenz ausläuft oder eine neue Lizenz gültig wird.

Der Dialog zeigt außerdem eine Legende zu den Warnungen und Warngrenzen an:

Warngrenze Client-Anzahl: absolute Differenz der Clientzahl zu der lizenzierten Anzahl, ab der gewarnt werden soll
Warngrenze Clients prozentual: prozentuale Menge der Clientzahl zu der lizenzierten Anzahl, ab der gewarnt werden soll
Warngrenze Tage bis Lizenzende: Anzahl der verbleibenden Tage bis Lizenzende, b denen gewarnt werden soll

Alle Warngrenzen konfigurieren Sie in der Server-Konfiguration über die Host-Parameter licensing.client_limit_warning_absolute, licensing.client_limit_warning_percent und licensing.client_limit_warning_days.

Wird eine Warngrenze für ein Modul überschritten, erscheint die Zahl in der Tabelle in Orange. Wenn für ein Modul nicht mehr genug Lizenzen existieren oder die Lizenz abgelaufen ist, erscheint die Ziffer in Rot.

Im unteren Teil des Fensters befinden sich Informationen zu den Clients und den Kundendaten, für welche die Lizenzen ausgestellt wurden. Der Checksum-Wert ist zum Abgleich, ob die Daten in der Umgebung mit den Daten bei uib übereinstimmen.