OpenBSD install

• introduction
• prereqs
• required ports:
• setting up the database
• creating the netdisco user
• installing netdisco
• next & important remark
• web frontend won’t work

introduction

this is a guide for a full install of netdisco & support items on openbsd 7.8. while installing openbsd make sure to install everything (except perhaps games78.tgz)

openbsd versions older as 7.8 don’t like the alien-ultraviolet package we provide, as such we advise to run at least 7.8. alternatives (with tradeoffs) exist, contact the mailinglist for advise on that.

unless stated all steps should be done as root.

prereqs

you should have set up the doas program, or lacking that, sudo.

required ports:

• p5-IO-Socket-SSL

• p5-DBD-Pg

• net-snmp

• postgresql-server

• uv

• curl

how to install: pkg_add p5-IO-Socket-SSL p5-DBD-Pg net-snmp postgresql-server uv curl

setting up the database

doas su - _postgresql
mkdir /var/postgresql/data
initdb -D /var/postgresql/data -U postgres -A scram-sha-256 -E UTF-8 -W
exit
rcctl enable postgresql
rcctl start postgresql
createuser -U postgres -DRSP netdisco
createdb -U postgres -O netdisco netdisco

creating the netdisco user

(i used zsh as shell, ksh is the default)

adduser

Couldn't find /etc/adduser.conf: creating a new adduser configuration file
Reading /etc/shells
Enter your default shell: csh ksh nologin sh zsh [ksh]: zsh
Your default shell is: zsh -> /usr/local/bin/zsh
Default login class: authpf bgpd daemon default pbuild staff unbound vmd xenodm
[default]:
Enter your default HOME partition: [/home]:
Copy dotfiles from: /etc/skel no [/etc/skel]:
Send welcome message?: /path/file default no [no]:
Do not send message(s)
Prompt for passwords by default (y/n) [y]:
Default encryption method for passwords: auto blowfish [auto]:
Use option ``-silent'' if you don't want to see all warnings and questions.

Reading /etc/shells
Check /etc/master.passwd
Check /etc/group

Ok, let's go.
Don't worry about mistakes. There will be a chance later to correct any input.
Enter username []: netdisco
Enter full name []: netdisco
Enter shell csh ksh nologin sh zsh [zsh]:
Uid [1000]:
Login group netdisco [netdisco]:
Login group is ``netdisco''. Invite netdisco into other groups: guest no
[no]:
Login class authpf bgpd daemon default pbuild staff unbound vmd xenodm
[default]:
Enter password []:
Enter password again []:

Name:        netdisco
Password:    ****
Fullname:    netdisco
Uid:         1000
Gid:         1000 (netdisco)
Groups:      netdisco
Login Class: default
HOME:        /home/netdisco
Shell:       /usr/local/bin/zsh
OK? (y/n) [y]:
Added user ``netdisco''
Copy files from /etc/skel to /home/netdisco
Add another user? (y/n) [y]: n
Goodbye!

installing netdisco

change to netdisco user: su - netdisco

we’ll be using the uv package provided by openbsd’s ports system which we installed earlier, so make sure to add this to your environment: ALIEN_ULTRAVIOLET_INSTALL_TYPE=system

install netdisco (we’ll use ftp instead of curl) ftp -o - https://cpanmin.us/ | perl - --notest --local-lib ~/perl5 App::Netdisco

next & important remark

from now on you can follow the normal installation steps: https://metacpan.org/pod/App::Netdisco#Installation

web frontend won’t work

the web framework has been seen to only listen on ipv6 on dual stack machines, to force it to listen on ipv4 only use:

export IPV=4
~/bin/netdisco-web start