1 aa513bf8 2023-01-22 jrmu version=pmwiki-2.2.130 ordered=1 urlencoded=1
2 aa513bf8 2023-01-22 jrmu agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:88.0) Gecko/20100101 Firefox/88.0
3 aa513bf8 2023-01-22 jrmu author=Arthur
4 aa513bf8 2023-01-22 jrmu charset=UTF-8
6 aa513bf8 2023-01-22 jrmu ctime=1620390347
7 aa513bf8 2023-01-22 jrmu host=179.228.49.181
8 aa513bf8 2023-01-22 jrmu name=Openbsd.Hopm-Arthur
10 aa513bf8 2023-01-22 jrmu targets=Openbsd.Doas
11 aa513bf8 2023-01-22 jrmu text=!! Pre-requisites%0a# It is assumed you have ''[[Openbsd/Doas|doas]]'' configured properly. If you do not have this configured properly and are interfacing with your server as root, you are asking for trouble!%0a# It is assumed you have ran ''adduser'' before. If not, you can run it and the majority of the defaults are fine.%0a# It is **also** assumed you have your own favourite text editor. If you **do not have** a favourite text editor, I recommend installing ''nano'' via ''doas pkg_add nano''. You must know how to use your favourite text editor as I won't cover you on how to use it.%0a%0a!! Installation%0aCreate hopm as its own user.%0a%0a[@%0a$ doas adduser%0aUse option ``-silent'' if you don't want to see all warnings and questions.%0a%0aReading /etc/shells%0aCheck /etc/master.passwd%0aCheck /etc/group%0a%0aOk, let's go.%0aDon't worry about mistakes. There will be a chance later to correct any input.%0aEnter username []: hopm%0aEnter full name []: hopm%0aEnter shell bash csh jk_chrootsh ksh nologin sh [ksh]: nologin%0aUid [1002]: 65532%0aLogin group hopm [hopm]: %0aLogin group is ``hopm''. Invite hopm into other groups: guest no %0a[no]: %0aLogin class authpf bgpd daemon default pbuild staff unbound znc %0a[default]: daemon%0aEnter password []: %0aDisable password logins for the user? (y/n) [n]: y%0a%0aName: hopm%0aPassword: ****%0aFullname: hopm%0aUid: 65532%0aGid: 65532 (hopm)%0aGroups: hopm %0aLogin Class: daemon%0aHOME: /home/hopm%0aShell: /sbin/nologin%0aOK? (y/n) [y]: %0aAdded user ``hopm''%0aCopy files from /etc/skel to /home/hopm%0aAdd another user? (y/n) [y]: n%0aGoodbye!%0a@]%0a%0aInstall the necessary ''wget'' package which is required for pulling files. ''gmake'' is required for compiling and installing.%0a[@%0a$ doas pkg_add wget gmake%0a@]%0a%0aGrab the latest [[https://github.com/ircd-hybrid/hopm/releases|hopm]]. As of writing, 1.1.6 is the latest.%0a[@%0a$ doas -u hopm wget "https://github.com/ircd-hybrid/hopm/archive/1.1.6.tar.gz" -O "/home/hopm/hopm-1.1.6.tar.gz"%0a@]%0a%0aDecompress the downloaded tarball, after you navigate into its own home directory.%0a[@%0a$ cd /home/hopm%0a$ doas -u hopm tar zxf hopm-1.1.6.tar.gz%0a@]%0a%0aNavigate into the extracted path and run configure within it.%0a[@%0a$ cd hopm-1.1.6%0a$ doas -u hopm ./configure%0a@]%0a%0aRun ''gmake'' as per instructed. Then ''gmake install'' which will install into its ''$HOME/hopm'' by default.%0a[@%0a$ doas -u hopm gmake%0a$ doas -u hopm gmake install%0a@]%0a%0aCopy ''hopm/etc/reference.conf'' as ''hopm/etc/hopm.conf'' and edit with **your own favourite text editor**. In my case I use ''vim''.%0a[@%0a$ cd ../hopm/etc%0a$ doas -u hopm cp reference.conf hopm.conf%0a$ doas -u hopm vim hopm.conf%0a@]%0a%0aMake necessary adjustments within the ''hopm.conf'' to suit your server/network configuration. Save and exit out of **your own favourite text editor**. In the first few running instances, I would enable debug mode to see if there were any issues with the configuration.%0a[@%0a$ cd ../bin%0a$ doas -u hopm hopm -dd%0a@]%0a%0a!! Troubleshooting%0aGetting hopm configured right can be tricky. So, here are some few hints and tips.%0a%0a# Ideally, for the initial testing/trialling phase, you do not want hopm to be running in the background. This is especially true if you aren't familiar with UNIX. To workaround this, you can run hopm with -d, e.g.%0a[@%0a$ ./hopm -d%0a@]%0aYou can specify the -d however many times needed but its usefulness typically stops after the second "d",%0a[@%0a$ ./hopm -dd%0a@]%0aAlso see [[https://github.com/ircd-hybrid/hopm/blob/master/README|here]]%0a%0aIf you see this error:%0a%0a[@%0a[2021-01-23T09:59:14-0600] IRC -> connect(): error connecting to username.coconut.ircnow.org: Connection refused %0a[2021-01-23T09:59:14-0600] IRC -> Connection to (username.coconut.ircnow.org) failed, reconnecting. %0a[2021-01-23T09:59:14-0600] IRC -> connect(): error connecting to username.coconut.ircnow.org: Connection refused%0a@]%0a%0aThis may be due to a configuration issue with ngircd. In particular, if the hostname has an AAAA record, hopm may be trying to connect via IPv6 but ngircd does not listen to IPv6 connections.%0a%0a!! Run Hopm as System Daemon%0aCreate a file at /etc/rc.d/hopm%0a%0aAdd the following lines to it:%0a%0a[@%0a#!/bin/ksh%0adaemon="/home/hopm/hopm/bin/hopm"%0a. /etc/rc.d/rc.subr%0arc_cmd $1%0a@]%0a%0aRun these commands to start hopm immediately and have it started on every boot:%0a%0a[@%0adoas chmod +x /etc/rc.d/hopm%0adoas rcctl start hopm%0adoas rcctl enable hopm%0a@]%0a%0aAdditional details can be found on this page https://ircnow.org/kb/doku.php?id=openbsd:rc.d%0a%0aSyntax errors when hopm is running in foreground: this is either the result of missing brackets where needed in config file, or that the file has DOS encodings. See [[https://github.com/ircd-hybrid/hopm/issues/22#issuecomment-301276082]] here. The missing brackets where it was needed may come from the previous section, compared to the line/s where it is indicated by hopm when executed.
12 aa513bf8 2023-01-22 jrmu time=1620390512
13 aa513bf8 2023-01-22 jrmu author:1620390512=Arthur
14 aa513bf8 2023-01-22 jrmu diff:1620390512:1620390441:=114,115c114,115%0a%3c Add the following lines to it:%0a%3c %0a---%0a> Add the following script to it:%0a> %0a123c123%0a%3c Run these commands to start hopm immediately and have it started on every boot:%0a---%0a> Run these commands to start hopm immediately and also make sure that it is started on boot:%0a
15 aa513bf8 2023-01-22 jrmu host:1620390512=179.228.49.181
16 aa513bf8 2023-01-22 jrmu author:1620390441=Arthur
17 aa513bf8 2023-01-22 jrmu diff:1620390441:1620390391:=133c133%0a%3c Syntax errors when hopm is running in foreground: this is either the result of missing brackets where needed in config file, or that the file has DOS encodings. See [[https://github.com/ircd-hybrid/hopm/issues/22#issuecomment-301276082]] here. The missing brackets where it was needed may come from the previous section, compared to the line/s where it is indicated by hopm when executed.%0a\ No newline at end of file%0a---%0a> '''Troubleshooting:''' Syntax errors when hopm is running in foreground: this is either the result of missing brackets where needed in config file, or that the file has DOS encodings. See [[https://github.com/ircd-hybrid/hopm/issues/22#issuecomment-301276082]] here. The missing brackets where it was needed may come from the previous section, compared to the line/s where it is indicated by hopm when executed.%0a\ No newline at end of file%0a
18 aa513bf8 2023-01-22 jrmu host:1620390441=179.228.49.181
19 aa513bf8 2023-01-22 jrmu author:1620390391=Arthur
20 aa513bf8 2023-01-22 jrmu diff:1620390391:1620390347:=126d125%0a%3c doas chmod +x /etc/rc.d/hopm%0a
21 aa513bf8 2023-01-22 jrmu host:1620390391=179.228.49.181
22 aa513bf8 2023-01-22 jrmu author:1620390347=Arthur
23 aa513bf8 2023-01-22 jrmu diff:1620390347:1620390347:=1,132d0%0a%3c !! Pre-requisites%0a%3c # It is assumed you have ''[[Openbsd/Doas|doas]]'' configured properly. If you do not have this configured properly and are interfacing with your server as root, you are asking for trouble!%0a%3c # It is assumed you have ran ''adduser'' before. If not, you can run it and the majority of the defaults are fine.%0a%3c # It is **also** assumed you have your own favourite text editor. If you **do not have** a favourite text editor, I recommend installing ''nano'' via ''doas pkg_add nano''. You must know how to use your favourite text editor as I won't cover you on how to use it.%0a%3c %0a%3c !! Installation%0a%3c Create hopm as its own user.%0a%3c %0a%3c [@%0a%3c $ doas adduser%0a%3c Use option ``-silent'' if you don't want to see all warnings and questions.%0a%3c %0a%3c Reading /etc/shells%0a%3c Check /etc/master.passwd%0a%3c Check /etc/group%0a%3c %0a%3c Ok, let's go.%0a%3c Don't worry about mistakes. There will be a chance later to correct any input.%0a%3c Enter username []: hopm%0a%3c Enter full name []: hopm%0a%3c Enter shell bash csh jk_chrootsh ksh nologin sh [ksh]: nologin%0a%3c Uid [1002]: 65532%0a%3c Login group hopm [hopm]: %0a%3c Login group is ``hopm''. Invite hopm into other groups: guest no %0a%3c [no]: %0a%3c Login class authpf bgpd daemon default pbuild staff unbound znc %0a%3c [default]: daemon%0a%3c Enter password []: %0a%3c Disable password logins for the user? (y/n) [n]: y%0a%3c %0a%3c Name: hopm%0a%3c Password: ****%0a%3c Fullname: hopm%0a%3c Uid: 65532%0a%3c Gid: 65532 (hopm)%0a%3c Groups: hopm %0a%3c Login Class: daemon%0a%3c HOME: /home/hopm%0a%3c Shell: /sbin/nologin%0a%3c OK? (y/n) [y]: %0a%3c Added user ``hopm''%0a%3c Copy files from /etc/skel to /home/hopm%0a%3c Add another user? (y/n) [y]: n%0a%3c Goodbye!%0a%3c @]%0a%3c %0a%3c Install the necessary ''wget'' package which is required for pulling files. ''gmake'' is required for compiling and installing.%0a%3c [@%0a%3c $ doas pkg_add wget gmake%0a%3c @]%0a%3c %0a%3c Grab the latest [[https://github.com/ircd-hybrid/hopm/releases|hopm]]. As of writing, 1.1.6 is the latest.%0a%3c [@%0a%3c $ doas -u hopm wget "https://github.com/ircd-hybrid/hopm/archive/1.1.6.tar.gz" -O "/home/hopm/hopm-1.1.6.tar.gz"%0a%3c @]%0a%3c %0a%3c Decompress the downloaded tarball, after you navigate into its own home directory.%0a%3c [@%0a%3c $ cd /home/hopm%0a%3c $ doas -u hopm tar zxf hopm-1.1.6.tar.gz%0a%3c @]%0a%3c %0a%3c Navigate into the extracted path and run configure within it.%0a%3c [@%0a%3c $ cd hopm-1.1.6%0a%3c $ doas -u hopm ./configure%0a%3c @]%0a%3c %0a%3c Run ''gmake'' as per instructed. Then ''gmake install'' which will install into its ''$HOME/hopm'' by default.%0a%3c [@%0a%3c $ doas -u hopm gmake%0a%3c $ doas -u hopm gmake install%0a%3c @]%0a%3c %0a%3c Copy ''hopm/etc/reference.conf'' as ''hopm/etc/hopm.conf'' and edit with **your own favourite text editor**. In my case I use ''vim''.%0a%3c [@%0a%3c $ cd ../hopm/etc%0a%3c $ doas -u hopm cp reference.conf hopm.conf%0a%3c $ doas -u hopm vim hopm.conf%0a%3c @]%0a%3c %0a%3c Make necessary adjustments within the ''hopm.conf'' to suit your server/network configuration. Save and exit out of **your own favourite text editor**. In the first few running instances, I would enable debug mode to see if there were any issues with the configuration.%0a%3c [@%0a%3c $ cd ../bin%0a%3c $ doas -u hopm hopm -dd%0a%3c @]%0a%3c %0a%3c !! Troubleshooting%0a%3c Getting hopm configured right can be tricky. So, here are some few hints and tips.%0a%3c %0a%3c # Ideally, for the initial testing/trialling phase, you do not want hopm to be running in the background. This is especially true if you aren't familiar with UNIX. To workaround this, you can run hopm with -d, e.g.%0a%3c [@%0a%3c $ ./hopm -d%0a%3c @]%0a%3c You can specify the -d however many times needed but its usefulness typically stops after the second "d",%0a%3c [@%0a%3c $ ./hopm -dd%0a%3c @]%0a%3c Also see [[https://github.com/ircd-hybrid/hopm/blob/master/README|here]]%0a%3c %0a%3c If you see this error:%0a%3c %0a%3c [@%0a%3c [2021-01-23T09:59:14-0600] IRC -> connect(): error connecting to username.coconut.ircnow.org: Connection refused %0a%3c [2021-01-23T09:59:14-0600] IRC -> Connection to (username.coconut.ircnow.org) failed, reconnecting. %0a%3c [2021-01-23T09:59:14-0600] IRC -> connect(): error connecting to username.coconut.ircnow.org: Connection refused%0a%3c @]%0a%3c %0a%3c This may be due to a configuration issue with ngircd. In particular, if the hostname has an AAAA record, hopm may be trying to connect via IPv6 but ngircd does not listen to IPv6 connections.%0a%3c %0a%3c !! Run Hopm as System Daemon%0a%3c Create a file at /etc/rc.d/hopm%0a%3c %0a%3c Add the following script to it:%0a%3c %0a%3c [@%0a%3c #!/bin/ksh%0a%3c daemon="/home/hopm/hopm/bin/hopm"%0a%3c . /etc/rc.d/rc.subr%0a%3c rc_cmd $1%0a%3c @]%0a%3c %0a%3c Run these commands to start hopm immediately and also make sure that it is started on boot:%0a%3c %0a%3c [@%0a%3c doas rcctl start hopm%0a%3c doas rcctl enable hopm%0a%3c @]%0a%3c %0a%3c Additional details can be found on this page https://ircnow.org/kb/doku.php?id=openbsd:rc.d%0a%3c %0a%3c '''Troubleshooting:''' Syntax errors when hopm is running in foreground: this is either the result of missing brackets where needed in config file, or that the file has DOS encodings. See [[https://github.com/ircd-hybrid/hopm/issues/22#issuecomment-301276082]] here. The missing brackets where it was needed may come from the previous section, compared to the line/s where it is indicated by hopm when executed.%0a\ No newline at end of file%0a
24 aa513bf8 2023-01-22 jrmu host:1620390347=179.228.49.181
