2020-01-22 23:34:42 +01:00
---
title: ucs
type: docs
---
2020-06-04 15:22:56 +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/master/LICENSE)
2020-01-31 11:35:06 +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.
{{< hint warning > }} **WARNING** \ This role covers only some really basic configurations and is far away production ready. {{< / hint > }}
2020-01-22 23:34:42 +01:00
* [Default Variables ](#default-variables )
2020-05-25 23:11:05 +02:00
* [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 )
2020-01-22 23:34:42 +01:00
* [Dependencies ](#dependencies )
---
## 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
```
## Dependencies
None.