Start

If you’ve installed opsi-configed as a localboot product, launch the management interface using the shortcut in your start menu. For macOS users, the tool is accessible in the Applications folder via the Finder.

However, if you are using the portable Java application, first make the downloaded file executable under Linux and macOS. To do this, open a terminal window and enter the following command:

chmod +x opsi-configed-linux.run
chmod +x opsi-configed-macos

On Windows, start the portable application by double-clicking opsi-configed-windows.exe. Under Linux and macOS, start the program from the terminal using this command:

./opsi-configed-linux.run
./opsi-configed-macos

Start Parameters

Various parameters are available to modify how opsi-configed behaves when launched from a terminal. These parameters enable you to preselect specific clients or client groups, input your username and password for login, and specify an SSH key along with its passphrase. To view all the available parameters, simply use --help when starting the application:

*opsi-configed*: Start Parameters
Figure 1. opsi-configed: Start Parameters

Setting the Loglevel

By default, opsi-configed logs at level 4 (warning). You can also set the log level lower or higher, for example to log level 6 (info) or level 7 (debug). In total, opsi distinguishes between 10 different log levels:

  • 0 - none: Logging is completely deactivated

  • 1 - essential: Very important messages

  • 2 - critical: Critical errors

  • 3 - error: Errors

  • 4 - warning: Warnings

  • 5 - notice: Important information

  • 6 - info: Further information 7 - debug: Messages for troubleshooting 8 - trace: Lots of details, e.g. recorded communication 9 - secret: Confidential information

To set the loglevel when starting the application, use the parameter --loglevel <number>; you can choose a number between 0 and 9.

Use caution with enabling level 7 and higher, as these loglevels should be reserved for situations where the program is experiencing startup issues. Activating these levels can lead to extensive and detailed logfiles.

If opsi-configed is already running, you can set the log level via the Help menu.

*opsi-configed*: Setting the Loglevel via the Menu
Figure 2. opsi-configed: Setting the Loglevel via the Menu

Directory for Logfiles

For Linux and macOS, logfiles are by default located in the hidden .configed folder in your home directory. On Windows, you’ll find the logs at C:\Users\<username>\AppData\Roaming\opsi.org\log. The latest logfile is named configed.log, while older logs are marked with an underscore and a sequential number, like configed_0.log, configed_1.log, and so on.

When starting opsi-configed you can use the parameter -d (long form: --directory) to specify a different directory for the logfiles:

./opsi-configed-linux.run -d ~/.logs/opsi/
You can find out which logfile is currently being used by clicking on Current log file in the Help menu. In the dialog box that opens, you can copy the path to the clipboard or open it in the standard text editor.
*opsi-configed*: Viewing the current Logfile (Linux)
Figure 3. opsi-configed: Viewing the current Logfile (Linux)

Choosing the Language

opsi-configed uses your operating system’s language settings. If there’s no localization available for that language, the interface will default to English. Additionally, if a translation is missing for a specific term within the language file, that term will also appear in English.

To select a different language for the interface when launching the program, use the -l parameter (or its extended form --locale):

./opsi-configed-linux.run -l en_US

Instead of specifying the full format <language>_<region> (such as en_US, de_DE), you can simply use the language code (en or de). This will apply the available localization files for all language variants.

To change the language in an active opsi-configed session, navigate to File / Select language. The program will reinitialize, rebuilding (almost) all components in the new language.

With the --localizationfile parameter, you can set a custom localization file. Additionally, using --localizationstrings ensures that opsi-configed shows all terms from the localization file that need translation.

The last two parameters are especially useful for testing your own localization files.