summaryrefslogtreecommitdiffstats
path: root/documentation/webapp/modules.md
blob: 459e97225e2aa8d66fc0824f90f73dad48310f0c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

Modules

Group / Clients

IP Ranges

iPXE Configurator

Event Manager

This module provides an overview table of all existing events.

BAS Event Manager

An event can be created 1 or edited 3, which opens a dialog with all configurable options. Selected events can be deleted by using the DELETE button 2.

To create an event general options must be set (Step 1), groups and/or clients must be assigned (Step 2) and optionally a blacklist of subgroups and/or clients can be created (Step 3). ::: warning The event can be created right away without assigning any group, but then has to be edited later on. :::

General Options

BAS Event Manager Dialog

1 - Choose one of the existing configurations which will be booted while the event is live. \ 2 - Enable this option, if the event has priority over other ongoing events. \ 3 - Enable this option, if Wake-On-Lan shall be triggered for all assigned groups and clients at the start of the event. \ 4 - Set start and end of the event. \ 5 - Enable to create an recurrent event.

::: warning Multiple important events on the same layer trigger dynamic menu building (see Configloader). :::

Recurrent Events

BAS Event Manager Dialog

1 - Select on which days the event is happening. Default: all selected. \ 2 - Select in which months the event is happening. Default: all selected. \ 3 - Set the interval. \ 4 - Select the type of the interval. Options are days, weeks and months.

::: warning Activating the recurrent switch changes from an one-time event to an recurrent event, therefore changing the meaning of start date/time and end date/time. The dates are now referring to the first and the last date of the event, with the event ongoing from start to end time at every day determined by the interval. :::

::: tip Intervaltype 4 week means the event is ongoing for the whole week, while month is only the start date in the month. E.g. choosing the 13th of january as the start date and 1, month as interval will set up the event on the 13th of every month between start and end date with exception of the non-selected months in 2. While for 2, week as interval the event is ongoing every 2nd week with the start date being in the first ongoing week. :::

Groups and Clients

BAS Event Manager Dialog

Groups 1 and/or clients 2 which are affected by the event have to be selected. Selecting a group will activate the CONTINUE button.

The blacklist only shows subgroups and clients of the previously selected groups. The list is used for selecting groups and clients which shall be excluded of the event.

::: warning If a previously selected group is inside of a blacklisted group, the previously selected group is not excluded from the event. :::

Client Registration

External Backends

iPXE Builder

This module is all about the IPXE which gets delivered to the clients when booting over the network.

IPXE Builder Parameters

The URL to the ipxe repository has to be defined 1.

::: tip The default ipxe repository URL is http://git.ipxe.org/ipxe.git :::

Instead of using the master branch, a branchname can be defined with 2.

Build targets can be selected 3. Either the build targets in the predefined list can be selected or custom build targets can be added if the administrator enabled custom build targets in the ipxe.config while setting the value to true. Custom build targets are added to the predefined list but can be removed using the delete button.

IPXE Builder Console

The console shows the output of the building process. 1 cleans the repository. This includes removing the log and the cloned git files. The scripts or configs will stay.\ 2 currently not working. (Should cancel the started building process)\ 3 starts the buildig process.

IPXE Builder Editor

There are multiple script/configs which can be edited. The script can be selected within the tabbar 1.\ The embedded script will be included in the builded ipxe using the EMBED= parameter.\ The embedded certificate get included using the TRUST= parameter.\ The general.h and the console.h are ipxe configurations. They will replace the files in the cloned repository.

User Management

This module provides a overview table of all the existing users.

User Management

A user can be created 1 or edited 3, which opens a dialog with all editable fields. Selected users can be deleted by pressing the delete button 2.

User Edit

Permissions: * View - The permission to see the overview of the existing users. * Edit - The permission to edit users. * Delete - The permission to delete users.

Permission Manager