2020-01-22 23:34:42 +01:00
---
title: ucs
type: docs
---
2022-06-20 22:39:04 +02:00
[![Source Code ](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white )](https://gitea.rknet.org/ansible/xoxys.ucs) [![Build Status ](https://img.shields.io/drone/build/ansible/xoxys.ucs?logo=drone&server=https%3A%2F%2Fdrone.rknet.org )](https://drone.rknet.org/ansible/xoxys.ucs) [![License: MIT ](https://img.shields.io/badge/license-MIT-blue.svg )](https://gitea.rknet.org/ansible/xoxys.ucs/src/branch/main/LICENSE)
2022-03-03 21:33:22 +01:00
Configure an [Univention Corporate Server ](https://www.univention.com/products/ucs/ ). UCS is a server appliance with an integrated management system for the central and cross-platform administration of servers, services, clients, desktops and users as well as virtualized computers operated in UCS.
2022-05-02 21:45:38 +02:00
{{< hint type = important > }} This role covers only some really basic configurations and should be considered as not production ready. {{< / hint > }}
2022-03-03 21:33:22 +01:00
2022-06-20 22:39:04 +02:00
<!-- more -->
2022-03-03 21:33:22 +01:00
- [Default Variables ](#default-variables )
- [ucs_cronjobs ](#ucs_cronjobs )
- [ucs_custom_tls_apache2_enabled ](#ucs_custom_tls_apache2_enabled )
- [ucs_custom_tls_dovecot_enabled ](#ucs_custom_tls_dovecot_enabled )
- [ucs_custom_tls_enabled ](#ucs_custom_tls_enabled )
- [ucs_custom_tls_postfix_enabled ](#ucs_custom_tls_postfix_enabled )
- [ucs_filesystem_acl ](#ucs_filesystem_acl )
- [ucs_registry_extra ](#ucs_registry_extra )
- [ucs_repository_unmaintained_enabled ](#ucs_repository_unmaintained_enabled )
- [ucs_system_groups ](#ucs_system_groups )
- [ucs_tls_cert_path ](#ucs_tls_cert_path )
- [ucs_tls_certs_dir ](#ucs_tls_certs_dir )
- [ucs_tls_key_dir ](#ucs_tls_key_dir )
- [ucs_tls_key_path ](#ucs_tls_key_path )
- [Discovered Tags ](#discovered-tags )
- [Dependencies ](#dependencies )
2020-01-22 23:34:42 +01:00
---
## Default Variables
2020-05-01 19:16:14 +02:00
### ucs_cronjobs
#### Default value
```YAML
ucs_cronjobs: []
```
#### Example usage
```YAML
ucs_cronjobs:
- name: backup-cleanup
job: "find /var/univention-backup -mtime +7 -delete"
user: root
minute: 0
hour: 3
day: "*"
weekday: "*"
month: "*"
state: present
```
2020-01-22 23:34:42 +01:00
### ucs_custom_tls_apache2_enabled
#### Default value
```YAML
ucs_custom_tls_apache2_enabled: false
```
### ucs_custom_tls_dovecot_enabled
#### Default value
```YAML
ucs_custom_tls_dovecot_enabled: false
```
### ucs_custom_tls_enabled
#### Default value
```YAML
ucs_custom_tls_enabled: false
```
### ucs_custom_tls_postfix_enabled
#### Default value
```YAML
ucs_custom_tls_postfix_enabled: false
```
### ucs_filesystem_acl
#### Default value
```YAML
ucs_filesystem_acl: []
```
#### Example usage
```YAML
ucs_filesystem_acl:
2020-03-21 14:52:52 +01:00
- path: /shares/mydocuments # needs to be set
entity: john # needs to be set
etype: user # needs to be set
permissions: rw # needs to be set
state: # defaults to 'query'
recursive: # defaults to 'no'
2020-01-22 23:34:42 +01:00
```
### ucs_registry_extra
#### Default value
```YAML
ucs_registry_extra: []
```
#### Example usage
```YAML
ucs_registry_extra:
- path: timeserver
value: "ntp.example.com"
state: present
```
### ucs_repository_unmaintained_enabled
#### Default value
```YAML
ucs_repository_unmaintained_enabled: false
```
### ucs_system_groups
#### Default value
```YAML
ucs_system_groups: []
```
#### Example usage
```YAML
ucs_system_groups:
2020-03-21 14:52:52 +01:00
- name: fs-mydocuments-rw # needs to be set
description: # defaults to not set
subpath: # defaults to not set
ou: # defaults to not set
state: # defaults to 'present'
2020-01-22 23:34:42 +01:00
```
### ucs_tls_cert_path
#### Default value
```YAML
ucs_tls_cert_path: /etc/pki/tls/certs/mycert.pem
```
### ucs_tls_certs_dir
#### Default value
```YAML
ucs_tls_certs_dir: /etc/pki/tls/certs
```
### ucs_tls_key_dir
#### Default value
```YAML
ucs_tls_key_dir: /etc/pki/tls/private
```
### ucs_tls_key_path
#### Default value
```YAML
ucs_tls_key_path: /etc/pki/tls/private/mykey.pem
```
2022-03-03 21:33:22 +01:00
## Discovered Tags
tls_renewal
:
2020-01-22 23:34:42 +01:00
## Dependencies
None.