I have re-edited my workspace to create ISO images for general use, originally it was developed for kitting TX120s7 and Thinkpad x220/x230.
The original version used the preseed system of debian, but now it only supports AutoInstall for Ubuntu 22.04.
- 2024/04/26
- Support the Ubuntu 24.04 Desktop and Server versions now.
- Changed the github repository name to ub-autoinstall-iso
As of 22.04, the EFI boot image (boot/grub/efi.img) is no longer included in the ISO image. Please refer to the following document for more details and a workaround.
Install the required packages.
$ sudo apt update
$ sudo apt install git make sudo
Checkout the target tag which you would like to install.
$ sudo git checkout refs/tags/22.04.4 -b my_22.04.4
To download the ISO image and populate the initial files, the following tasks are performed only once.
$ make download
$ make init
The following tasks must be performed each time an ISO file is generated;
$ make setup
$ make geniso
The geniso task might be failed due to the locale, so it is safe to specify LANG=C.
If you want to specify a LANG other than "C", change the GENISO_LANG value in the Makefile.
Customization of the installation process focuses on config/user-data.
- config/user-data.efi - Configuration to create ESP area for UEFI boot
- config/user-data.mbr - Configuration for MBR (BIOS) boot
Please place the preferred configuration file to the config/user-data.
The config/user-data.efi file is linked as config/user-data as the default setting. If your system doesn't support the EFI boot, please use the config/user-data.mbr, instead.
The following is a summary of the major setting parameters.
If you would like to use any headless server which doesn't have video output, but has a serial console, please enable the following line of config/boot/grub/grub.cfg file.
linux /casper/vmlinuz autoinstall "ds=nocloud-net;s=file:///cdrom/" quiet --- console=ttyS0,115200n8
Delete the existing line or comment-out the existing line as follows.
## linux /casper/vmlinuz autoinstall "ds=nocloud-net;s=file:///cdrom/" quiet ---
The tested system, such as x230, can work well even the "console=ttyS0,115200n8" setting was specified. However, other systems, such as x270, couldn't work well, so please take care of the setting.
Change the username: and password: lines in user-data as desired.
- ID: ubuntu
- Password: secret
The hash value specified in the password: line was generated by the following command.
$ openssl passwd -6 -salt "$(openssl rand -hex 8)" secret
Following is an example for providing ssh keys to the default user, ubuntu.
ssh:
authorized-keys:
- "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAAIH8mvfUPhRddvGXBxGcvwo5m3CRVOf8RbFXwaUa9mhLX comment"
- "..."
APU and some old IA servers, such as RX100 S7, should use the isolinux.
The following configurations are made to work with devices that only have a serial terminal.
- Add
console=ttyS0,115200n8to the end of the "append" line in config/isolinux/txt.cfg - Add
console=ttyS0,115200n8to the end of the "linux" line in config/boot/grub/grub.cfg. - Add some isolinux related tasks to Makefile
To create an ISO image for installation on the APU/APU2 from a USB stick, please conduct added tasks as follows,
Perform the following procedures only the first time. If you perform repeatedly, there is no side-effects.
$ make download
$ make init
$ make setup-isolinux
$ ln -fs user-data.mbr config/user-data
$ sed -i -e 's/---$/--- console=ttyS0,115200n8/' config/boot/grub/grub.cfg
Repeat the following steps after editing the user-data file to generate an ISO image.
$ make setup
$ make geniso-isolinux
Copyright 2023,2024 Yasuhiro ABE, <[email protected], [email protected]>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.