Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update OpenBSD.md #12

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Update OpenBSD.md #12

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a0ed627
Update OpenBSD.md
pkubaj Aug 29, 2017
5c40e17
Update OpenBSD.md
pkubaj Aug 31, 2017
f8ac8d2
Update OpenBSD.md
pkubaj Aug 31, 2017
7b85bcb
Update OpenBSD.md
pkubaj Sep 2, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 40 additions & 14 deletions docs/OpenBSD.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ Install OpenBSD over PXE
For example:

```
wget http://ftp.icm.edu.pl/pub/OpenBSD/5.9/amd64/bsd.rd
wget http://ftp.icm.edu.pl/pub/OpenBSD/5.9/amd64/pxeboot
wget http://ftp.icm.edu.pl/pub/OpenBSD/6.1/amd64/bsd.rd
wget http://ftp.icm.edu.pl/pub/OpenBSD/6.1/amd64/pxeboot
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj You have changed BSD version to 6.1, so please update it also in PXE menu.cfg

By default, those files should be placed directly in tftp server root
directory. In our case it's `netboot` directory, which is mounted inside
Expand Down Expand Up @@ -48,23 +48,14 @@ Install OpenBSD over PXE
menu default
kernel OpenBSD/amd64/pxeboot.0
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj please consider adding some earlyprint over COM. Running this option in PXE menu causes no output and restarts apu2 after a while

```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj consider adding some earlyprint over COM. I have no idea if the booting is proceeding or not when I run that menu option.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean the option in PXELINUX or the autoboot option in iPXE? Generally, both load very quickly and it's usually you environment (dhcpd or tftpd configuration) which is bad.

Path to `bsd.rm` is set in `/etc/boot.conf`, which needs to be created.

```
boot tftp:/OpenBSD/amd64/bsd.rd
```

Note that it has to be in tftpd root directory, not the directory where bsd
files are!

3. Boot configuration.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj add a new line before "3. Boot configuration" because it appends to the previous line.


Bootloader configuration is set through `/etc/boot.conf` file. In our case we
need at least to enable serial port communication and set it's speed.
OpenBSD bootloader by default loads `bsd` file, so rename `bsd.rd` to `bsd`.

```
stty com0 115200
set tty com0
```
4. Installation.

Installation process is mostly straightforward. Take a look at the choice of
Expand All @@ -76,3 +67,38 @@ Install OpenBSD over PXE
bsd.mp (multi-processor kernel)
baseXX.tgz (OpenBSD base system) - essential
```

5. In order to use Autoinstall mode, a few more adjustments need to be made.

The binary you set to load in "filename" directive in DHCP server needs to be
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj What if I do not have DHCP running?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pkubaj what if I do not have a DHCP server running?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With this procedure, it won't work. I'll prepare another one, for when there's no DHCP.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please verify now.

a symlink called `auto_install` pointing to `pxeboot.0`. Example:

```
subnet 192.168.0.0 netmask 255.255.255.0 {
option routers 192.168.0.1;
range 192.168.0.4 192.168.0.254;
filename "auto_install";
```

Otherwise, you're going to be asked whether you want to install or upgrade.

The configuration file for installation is served by HTTP server passed by
`server-name`, `option tftp-server-name`, or `next-server` directive.
The file needs to be named `install.conf`. Here's an example:
```
System hostname = 3mdeb.dev
Change the default console to com0 = yes
Which speed should com0 use = 115200
Password for root = 3mdeb.dev
Network interfaces = em0
IPv4 address for em0 = dhcp
Setup a user = emdeb
Password for user = 3mdeb.dev
What timezone are you in = Europe/Warsaw
Location of sets = http
Server = mirror.leaseweb.com
Use Whole disk MBR, whole disk GPT, OpenBSD area or Edit = W
```

You need to connect APU to the em0 Ethernet port (the nearest port to the RS232
plug) and provide apriopriate routing and DNS resolver.