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.

*opsi-configed*: Context Menu after Right-clicking a Client
Figure 1. 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.

*opsi-configed*: Client Search
Figure 2. 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.

Client can be reached.
Figure 3. opsi-configed: Client can be reached.
Client cannot be reached.
Figure 4. opsi-configed: Client cannot be reached.
*opsi-configed*: Use this icon to check which clients are connected.
Figure 5. 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.
*opsi-configed*: Configure the visible Columns in the Client List.
Figure 6. 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.

*opsi-configed*: Use this Icon to request Session Information from all Clients.
Figure 7. 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.

*opsi-configed*: Use this Icon to only show selected Clients.
Figure 8. 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.

*opsi-configed*: Use the Free Client Search to create your own Search Criteria.
Figure 9. 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.

*opsi-configed*: Saved Search Queries
Figure 10. 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.

*opsi-configed*: Search for Failed Actions.
Figure 11. 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.
*opsi-configed*: Tree View
Figure 12. 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.

*opsi-configed*: Create a new Group.
Figure 13. opsi-configed: Create a new Group.

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

*opsi-configed*: Enter Group Name and Description.
Figure 14. 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.

*opsi-configed*: The *Client* Menu
Figure 15. 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.
*opsi-configed*: Extended Column View for opsi Clients
Figure 16. 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.

opsi-configed: Scheduler for Wake on LAN (WoL)
Figure 17. 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.

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

Click on the red checkmark to send the message.

*opsi-configed*: Client message window
Figure 19. 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).

*opsi-configed*: Starting Remote Control Software
Figure 20. 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:

  1. In the top area, you will find a list of the names of the available commands.

  2. 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.

  3. 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:

*opsi-configed*: Configure the Remote Control Commands.
Figure 21. 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.

*opsi-configed*: Adding a new Client
Figure 22. 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.

*opsi-configed*: Creating multiple Clients
Figure 23. 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.

*opsi-configed*: Move Clients to another Depot
Figure 24. 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.

*opsi-configed*: List of Localboot Products with detailed View on the right
Figure 25. 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.

*opsi-configed*: Property Table
Figure 26. 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.

*opsi-configed*: List Editor, Selection List
Figure 27. 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:

*opsi-configed*: List Editor, Field for Custom Values
Figure 28. 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.

*opsi-configed*: List of Netboot Products with detailed View on the right
Figure 29. 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.

*opsi-configed*: Hardware Information Tab
Figure 30. 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.

*opsi-configed*: Hardware Information, Driver Upload
Figure 31. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

*opsi-configed*: Software Informationen
Figure 32. opsi-configed: Software Informationen

Log Files

You can view the clients' log files on the Log files tab. Use the slider at the bottom right to change the loglevel (see section Setting the Loglevel). You can also use the mouse wheel to operate the slider. The different loglevels are displayed in different colours.

You can search in the log files using the search field at the bottom (continue the search with [F3] or [Ctrl]+[L]).

*opsi-configed*: Viewing the Log Files
Figure 33. opsi-configed: Viewing the Log Files

Host Parameters: Client and Server Configuration

You can make a variety of configuration settings via the Host parameters tab. When you are in the Client Configuration mode, this tab displays client-specific settings. When the Server Configuration is active, you see the corresponding server defaults.

Configuration entries (config objects of the opsi server) are essentially lists of values. The list editor is used to edit these values (see section Property Configuration).

Depending on the type of the configuration object:

  • The elements of the list can be either Unicode text values or boolean values (true/false).

  • The set of allowable list elements can be fixed or expandable.

  • The DefaultValues entry of the object includes exactly one list element in the case of singleValue, and a random selection from the allowable list elements for multiValue objects.

You can create new configuration entries via the right-click context menu on the server’s Host parameter page. Likewise, you can delete existing objects there.

*opsi-configed*: Host Parameters (Context Menu of a Client Entry)
Figure 34. opsi-configed: Host Parameters (Context Menu of a Client Entry)

The relationship between server and client host parameters is complex:

  • Server entries provide the default values for the client entries.

  • To create a client entry, you must first create a server configuration object.

  • If you delete a server entry (the config object), the associated client entries, which are based on ConfigState objects, also disappear.

  • There can be a distinct entry for the client in the database if the client value differs from the server default, but also when they are identical. If this distinct entry exists, it remains even if the server default changes.

  • Starting with opsi-configed version 4.0.7.6.5, there is a context menu for client properties with options to Remove the specific value (client value is always the current server default) and Set the current default as specific value.

  • If the client value differs from the current server default, it is displayed in bold.

  • There are configuration objects for which client values can theoretically be created and edited, but which have no meaning because they only store server-related information. These properties are usually hidden in current versions of opsi-configed.

The host parameters are organized into functional groups for clarity. These groups are displayed on the left in a tree-like structure, while the corresponding parameters and their values are shown on the right.

*opsi-configed*: Host Parameters in the Client Configuration
Figure 35. opsi-configed: Host Parameters in the Client Configuration