Bug 39038 - Document univention-cloud-init network configuration
Document univention-cloud-init network configuration
Status: RESOLVED WONTFIX
Product: UCS extended documentation
Classification: Unclassified
Component: Installation
unspecified
Other Linux
: P5 normal with 1 vote (vote)
: ---
Assigned To: Docu maintainers
https://docs.software-univention.de/i...
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2015-07-29 10:00 CEST by Erik Damrose
Modified: 2023-04-18 11:02 CEST (History)
2 users (show)

See Also:
What kind of report is it?: Bug Report
What type of bug is this?: 6: Setup Problem: Issue for the setup process
Who will be affected by this bug?: 1: Will affect a very few installed domains
How will those affected feel about the bug?: 3: A User would likely not purchase the product
User Pain: 0.103
Enterprise Customer affected?:
School Customer affected?:
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Erik Damrose univentionstaff 2015-07-29 10:00:02 CEST
univention-cloud-init supports ip address configuration, but the feature is not documented in the extended installation doc
Comment 1 Philipp Hahn univentionstaff 2020-01-30 09:40:37 CET
A participant on the Univention Summit 2020 asked for this:

1. Download UCS appliance image for KVM from <http://updates.software-univention.de/download/evaluation/UCS-KVM-Image.qcow2>
2. Start VM
3. Abort "Univention System Setup" (USS) running in Browser with "Ctrl-Q"
4. Login as user "root" with password "univention"
5. ucr set repository/online=yes repository/online/unmaintained=yes  # Bug #46294 comment 3
6. apt-get -qq update
7. apt-get install cloud-init
8. apt-get clean
8. dpkg-reconfigure cloud-init
   # Select the source most appropriate for your environment; see <https://cloudinit.readthedocs.io/en/latest/topics/datasources.html>; easiest is probably "NoCloud"
   # When using `univention-cloud-init` do this with UCRV system/setup/cloud-init/datasources=NoCloud,None
9. ucr set repository/online=no repository/online/unmaintained=no
10. ucr set system/setup/boot/start=no  # Disable starting USS in browser (automatically done by univention-cloud-init)
11. poweroff  # VM
12. Use this so prepared image as your new master image

For UCS there also is the UCS package `univention-cloud-init`, which provides the integration to run system setup from cloud-init:

1. apt install univention-cloud-init
2. Setup cloud-init to provide the file configuration as documented at <https://docs.software-univention.de/installation.html#appliance:use:cloudinit>
3. Run new VM with copy or copy-on-write-enabled base image

Further optimizations:
- ucr set grub/bootsplash=nosplash grub/quiet=no grub/rootdelay=0 grub/generate-menu-lst=no  # Disable splash and delays and enable debug output


Default values from univention-cloud-init:

ucs_setup:
 hostname: ucs
 domainname: ucs.local
 windowsdomain: UCS
 ldap_base: dc=ucs,dc=local
 rootpassword: univention
 role: domaincontroller_master
 components:
 package_install:
 package_remove:
 eth0_address: dhcp
 eth0_broadcast:
 eth0_netmask:
 eth0_network:
 nameserver:
 dnsforwarder:
 gateway:
 sslou: Univention Corporate Server
 sslorg: DE
 sslemail: ssl@ucs.local
 sslstate: DE
 ssllocality: DE
 timezone: America/New_York
 keymap: en_us

You can manually configure the network by setting "eth0_address" and "eth0_netmask" (and optionally "eth0_network" and "eth0_broadcast").
Comment 2 Philipp Hahn univentionstaff 2023-04-18 11:02:25 CEST
univention-cloud-init is deprecated and no longer supported.