INTRO(8)                OpenBSD System Manager's Manual               INTRO(8)

NNAAMMEE
     iinnttrroo - introduction to system maintenance and operation commands

DDEESSCCRRIIPPTTIIOONN
     The manual pages in section 8 contain information related to system oper-
     ation and maintenance.  They describe commands concerning file systems,
     such as edquota(8), fsck(8), mount(8), and newfs(8).  They also cover
     commands concerning system backup/recovery, such as dump(8) and
     restore(8).

     There are pages which document the running of the system, such as
     afterboot(8), ifconfig(8), security(8), and the configuration files lo-
     cated in _/_e_t_c.  Procedures concerning system failure are documented in
     crash(8).

     Section 8 pages also describe network services and daemons.  The rest of
     this page discusses some of the main daemons available on the OpenBSD
     system, and how to enable/disable them.

     System daemons are controlled by the script rc(8), which is in turn con-
     figured by rc.conf(8).  For example the HTTP daemon httpd(8) is con-
     trolled by the following line from rc.conf(8):

                 httpd_flags=NO

     Thus it is not started by default.  To enable or disable daemon process-
     es, administrators should edit the file rc.conf.local(8), which overrides
     rc.conf(8).  So to enable httpd(8), the following line might be added to
     _/_e_t_c_/_r_c_._c_o_n_f_._l_o_c_a_l:

           httpd_flags=""
     or
           httpd_flags="-DSSL"

     As can be seen above, this method is also used to specify additional op-
     tions.

     Below is a list of some of the daemons available.  For further informa-
     tion, see rc(8) and the individual pages for the utilities.

   AAppaacchhee wweebb sseerrvveerr ((HHTTTTPP))
     The apache web server, httpd(8).  On OpenBSD, it will chroot(2) to the
     ``ServerRoot'' path.  Detailed information is available in
     _/_u_s_r_/_s_h_a_r_e_/_d_o_c_/_h_t_m_l_/_h_t_t_p_d_/.

     Relevant rc.conf(8) variables: _h_t_t_p_d___f_l_a_g_s.

   AAuuttoommoouunntteerr ddaaeemmoonn ((aammdd))
     If using the amd(8) package, go into the _/_e_t_c_/_a_m_d directory and set it up
     by renaming _m_a_s_t_e_r_._s_a_m_p_l_e to _m_a_s_t_e_r and editing it and creating other
     maps as needed.  Alternatively, you can get your maps with YP.

     Relevant rc.conf(8) variables: _a_m_d, _a_m_d___d_i_r, and _a_m_d___m_a_s_t_e_r.

   BBIINNDD nnaammee sseerrvveerr ((DDNNSS))
     If you are using the BIND name server, check the _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f file.
     It may look something like:

           domain nts.umn.edu
           nameserver 128.101.101.101
           nameserver 134.84.84.84
           search nts.umn.edu. umn.edu.
           lookup file bind

     If using a caching name server, add the line "nameserver 127.0.0.1"
     first.

     Relevant rc.conf(8) variables: _n_a_m_e_d___f_l_a_g_s.

   CClloocckk ssyynncchhrroonniissaattiioonn
     In order to make sure the system clock is correct, it may be synchronised
     with a number of external sources.  The utilities available are: ntpd(8),
     rdate(8), and timed(8).

     Relevant rc.conf(8) variables: _n_t_p_d___f_l_a_g_s, _r_d_a_t_e___f_l_a_g_s, and _t_i_m_e_d___f_l_a_g_s.

   CCoonnccaatteennaatteedd ddiisskkss ((ccccdd))
     If you are using ccd(4) concatenated disks, edit _/_e_t_c_/_c_c_d_._c_o_n_f.  Use the
     ccccddccoonnffiigg --UU command to unload and the ccccddccoonnffiigg --CC command to create ta-
     bles internal to the kernel for the concatenated disks.  You then
     mount(8), umount(8), and edit _/_e_t_c_/_f_s_t_a_b as needed.

   BBOOOOTTPP//DDHHCCPP sseerrvveerr
     If this is a BOOTP or DHCP server, edit _/_e_t_c_/_d_h_c_p_d_._c_o_n_f as needed.  See
     also diskless(8).

     Relevant rc.conf(8) variables: _b_o_o_t_p_a_r_a_m_d___f_l_a_g_s, _d_h_c_p_d___f_l_a_g_s, and
     _d_h_c_r_e_l_a_y___f_l_a_g_s.

   HHPP rreemmoottee bboooott sseerrvveerr
     Edit _/_e_t_c_/_r_b_o_o_t_d_._c_o_n_f if needed for remote booting.  If you do not have
     HP computers doing remote booting, do not enable this.  See also
     diskless(8).

     Relevant rc.conf(8) variables: _r_b_o_o_t_d___f_l_a_g_s.

   KKeerrbbeerrooss
     If you are going to use kerberos(8) for authentication, and you already
     have a Kerberos master, change directory to _/_e_t_c_/_k_e_r_b_e_r_o_s_V and configure.
     Remember to get a _s_r_v_t_a_b from the master so that the remote commands
     work.

     Relevant rc.conf(8) variables: _k_r_b_5___m_a_s_t_e_r___k_d_c and _k_r_b_5___s_l_a_v_e___k_d_c.

   NNFFSS sseerrvveerr
     If this is an NFS server, edit _/_e_t_c_/_e_x_p_o_r_t_s.

     Relevant rc.conf(8) variables: _n_f_s___s_e_r_v_e_r and _n_f_s_d___f_l_a_g_s.

   RReellaayy DDaaeemmoonn
     A relay daemon, relayd(8), able to run as a load-balancer, application
     layer gateway, or transparent proxy.

     Relevant rc.conf(8) variables: _r_e_l_a_y_d___f_l_a_g_s.

   RRoouuttiinngg DDaaeemmoonnss
     Various daemons for managing routing tables are available: bgpd(8),
     ospfd(8), and ripd(8).

     Relevant rc.conf(8) variables: _b_g_p_d___f_l_a_g_s, _o_s_p_f_d___f_l_a_g_s, and _r_i_p_d___f_l_a_g_s.

   RRPPCC--bbaasseedd nneettwwoorrkk sseerrvviicceess
     Several services depend on the RPC portmapper, portmap(8), being running
     for proper operation.  This includes YP and NFS exports, among other ser-
     vices.

     Relevant rc.conf(8) variables: _p_o_r_t_m_a_p.

   YYPP sseettuupp
     Check the YP domain name with the domainname(1) command.  If necessary,
     correct it by editing the _/_e_t_c_/_d_e_f_a_u_l_t_d_o_m_a_i_n file (see defaultdomain(5)).
     The _/_e_t_c_/_n_e_t_s_t_a_r_t script reads this file on boot to determine and set the
     domain name.  You may also set the running system's domain name with the
     domainname(1) command.  To start YP client services, simply run yyppbbiinndd,
     then perform the remaining YP activation as described in passwd(5) and
     group(5).

     In particular, to enable YP passwd support, you'll need to add the fol-
     lowing line to _/_e_t_c_/_m_a_s_t_e_r_._p_a_s_s_w_d:

           +:*::::::::

     You do this by using vipw(8).

     There are many more YP man pages available to help you.  You can find
     more information by starting with yp(8).

SSEEEE AALLSSOO
     afterboot(8), rc(8), rc.conf(8)

HHIISSTTOORRYY
     The iinnttrroo section manual page appeared in 4.2BSD.

OpenBSD 4.5                      June 8, 2008                                3
