View source for Neon/Installation/OEM

<languages />

<translate>

<!--T:1-->
OEM installation mode is a special installation mode targetted at hardware manufacturers. The principal difference to a regular installation is that the installation itself creates a temporary user for customization from where the system is switched into ''firstboot mode''. Booting in ''firstboot mode'' will let the final user configure the system to her preference and create her actual account.

<!--T:2-->
This enables hardware manufacturers to install and prepare a system for their customers while still letting the customers pick their own user name, keyboard layout and the like.

<!--T:3-->
{{Remember|2=Requirements|1=For this to work you need a neon ISO newer than 2017-01-13 and ensure to have internet access during installation as part of the OEM tooling is downloaded on-demand.}}

== How To == <!--T:4-->

<!--T:5-->
Put the ISO on a USB stick and boot the device using the stick.

<!--T:6-->
Depending on the operation mode of device the ISO will be either booting in BIOS mode or UEFI mode. The two look slightly different, but both offer an option to start in OEM mode.

=== UEFI === <!--T:7-->

<!--T:8-->
In UEFI mode you will be greeted by GRUB where you simply have to start the OEM entry rather than the standard one.

<!--T:9-->
[[File:Neon-oem-uefi.png|512px]]

=== BIOS === <!--T:10-->

<!--T:11-->
In BIOS mode you will be greeted by a splash screen. You want to hit <keycap>Esc</keycap> to get to the menu. In the menu you can use the <keycap>F4</keycap> key to switch the installer into OEM mode. Once selected simply hit <keycap>Enter</keycap> to start.

<!--T:12-->
[[File:Neon-oem-bios1.png|248px|Splash]]
[[File:Neon-oem-bios2.png|248px|Mode selection]]

=== Installation === <!--T:13-->

<!--T:14-->
The installation process itself is the same as it would be for a non-OEM installation. The major difference is that the installer window title will say that the installer is in OEM mode and the user setup will have the fixed username ''oem''.

<!--T:15-->
[[File:Neon-oem-installer-1.png|248px|Main screen]]
[[File:Neon-oem-installer-2.png|248px|User screen]]

=== System Preparation === <!--T:16-->

<!--T:17-->
Booting into this system will bring you to the system preparation stage. You will be logged into the temporary ''oem'' user and can modify the system as necessary. In this stage you could install additional software, language packs, media codecs, drivers and so forth.

<!--T:18-->
The system you are working on is going to be the system the user will use, so take care not to leak credentials in log or configuration files. Should you need to, make sure to delete them before you move on.

<!--T:19-->
Once you are done preparing the system you can prepare it for delivery. Simply open a terminal and run

<!--T:20-->
<code>oem-config-prepare</code>

<!--T:21-->
[[File:Neon-oem-prepare.png|512px|System ready to rumble]]

<!--T:22-->
The system is now in firstboot mode. At this stage you could create a disk image of the final system and supply it to your manufacturer to put on all hard drives, or simply do so yourself. The next time the system is booted it will come up in ''firstboot mode'' for the customer.

=== First Boot === <!--T:23-->

<!--T:24-->
During the first boot a simplified installer interface is used to configure the final system. As part of this, the previously used ''oem'' user will be removed.

<!--T:25-->
[[Image:Neon-oem-firstboot-1.png|248px]]
[[Image:Neon-oem-firstboot-2.png|248px]]

<!--T:26-->
[[Image:Neon-oem-firstboot-3.png|248px]]
[[Image:Neon-oem-firstboot-4.png|248px]]

=== Finale === <!--T:27-->

<!--T:28-->
Once the configuration is done the user is automatically soft-rebooted into his final system. Ready for rock'n'roll.

<!--T:29-->
[[Image:Neon-oem-done.png|512px]]

</translate>