Haack's Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
-------------------------------------------
  * **freeBSD** 
  * **Jonathan Haack**
  * **Haack's Networking**
  * **netcmnd@jonathanhaack.com** 

-------------------------------------------

After installation, run:

  /usr/sbin/pkg

With no internet, you must build from source (if you even still want it):

  cd /usr/ports/ports-mgmt/pkg
  make
  make install 
  make clean

Update ports after you have internet:

  portsnap fetch
  portsnap extract

As of 10.X > freeBSD will automatically allow the native pkg manager to install ports.  This allows the user to avoid compiling from source and navigating to directories.  Therefore, there is now a reason to build pkg from source - it will do this work for you more effectively.  (So what?  You can now search ports and geek out, and then use those names with pkg and sit back while it does the work!)

  pkg install <pkgname>

And of course installing pkg from source is but one example of the whole ports system, which is a set of binaries ready to compile.  They are sorted by intuitive names in the directory below, and it is wise to look around and then switch back to pkg, or if you know what you are doing, build from source as follows:

  cd /usr/ports/<pkgname>
  make install 
  make clean

freeBSD has other port managers besides portsnap

  pkg install portmaster
  pkg install portupgrade

You can set up a DE by installing nano, xorg, & mate-desktop, xfce, gnome3, kde, etc., and an appropriate window manager and window server.  I choose gnome3 on bigger machines and xfce on smaller, but everyone has their preference.  For servers, I leave it off.  I always use xorg and slim for xfce, and gnome has its own when using that.  Anyway, here goes:

  pkg install mate mate-desktop [or]
  pkg install gnome3 [or]
  pkg install xfce [or]
  pkg install xorg
  pkg install slim

Add the following like below the last device (/dev):

  nano /etc/fstab
  proc /proc procfs rw 0 0

Then, edit your rc.conf file:

  dbus_enable="YES"
  hald_enable="YES"
  mate_enable="YES" [or]
  xfce_enable="YES" [or]
  gnome3_enable="YES" [or]
  slim_enable="YES"

Add .xinitrc to ~ and /root, enter the syntax listed below the nano commands.

  nano /root/.xinitrc
  exec start gnome3
  nano /home/username/.xinitrc
  exec start gnome3

Now, fine tune your user settings for your regular user.  Edit /etc/group 

  su - root
  cd /etc
  nano group

Once inside the editor nano, please edit the operator and wheel lines as follows:

  operator:*:5:root,<add-username>
  wheel:*:0:root,<add-username>

Or, edit the group file directly from the command line:

  pw group mod <username> -m <username>
  
Or, alternately, you can install sudo (recommended):

  pkg install sudo
  nano /usr/local/etc/sudoers

In that file that you just opened called sudoers, there is a line that reads "root ALL=(ALL) ALL."  You want to create a line directly underneath that similar to this:

  username ALL=(ALL) ALL
  
Close and save the file and reboot:

  reboot

Basic updating:

  freebsd-update fetch
  freebsd-update install

To upgrade to a new major release:

  freebsd-update -r 9.1-RELEASE upgrade
  freebsd-update install

After either updating or installing a new release:

  shutdown -r now

After restarting, run the update again to remove old shared libraries and objects

  freebsd-update install
  
-- FEMP Stack on BSD --


  
-- Dokuwiki on BSD--
  
Setting up dokuwiki on freeBSD and securing data directory (required on BSD).  (Only making BSD specific permission changes at present.)

  su - root
  cd /usr/ports/www/dokuwiki
  make install clean
  mv /usr/local/www/dokuwiki /usr/local/www/nginx/dokuwiki
  sudo chmod -R 755 /usr/local/www/nginx/dokuwiki/conf
  sudo chown -R www /usr/local/www/nginx/dokuwiki/conf
  sudo chown www /usr/local/www/nginx/dokuwiki/data
  sudo chmod -R 775 /usr/local/www/nginx/dokuwiki/data
  sudo chmod -R 755 /usr/local/www/nginx/dokuwiki/lib
  sudo chown -R www /usr/local/www/nginx/dokuwiki/lib
 
Now, go to https://domain.com/dokuwiki/install.php and run the installer. Now, it is time to move the data directory and to configure dokuwiki's main .php configuration file to "see" that move.  

  mv /usr/local/www/nginx/dokuwiki/data /usr/local/www/data
  cd /usr/local/www/nginx/dokuwiki/conf/
  nano local.php

Ok, inside the .php main configuration file for dokuwiki that you just opened, add the following line below that others that specify other global parameters.

  $conf['savedir'] = '/usr/local/www/data/';
  
When you moved the data directory it likely lost its permissions from the above changes.  If not, or if you are unsure, execute:

  sudo chmod -R 775 /usr/local/www/data
  sudo chown www -R /usr/local/www/data
  
Remove the original data directory and restore root as owner of the main configuration directory.

  sudo rm -r /usr/local/www/nginx/dokuwiki/data
  sudo chown -R root /usr/local/www/nginx/dokuwiki/conf

Reload the primary page, make a test submission.  Also, log in and select Admin and you should see the security warning removed now.  At this point, follow these standard permission recommendations from dokuwiki.  (The user is www for nginx, not www-data, and the group is wheel, but do not specify the group.):

  chmod g+rwx /usr/local/www/nginx/dokuwiki
  chmod -R 775 /usr/local/www/data
  chown -R www /usr/local/www/data
  chmod -R 2775 /usr/local/www/data/attic /usr/local/www/data/cache /usr/local/www/data/index /usr/local/www/data/locks /usr/local/www/data/media /usr/local/www/data/meta /usr/local/www/data/pages /usr/local/www/data/tmp
  chown -R www /usr/local/www/data/attic /usr/local/www/data/cache /usr/local/www/data/index /usr/local/www/data/locks /usr/local/www/data/media /usr/local/www/data/meta /usr/local/www/data/pages /usr/local/www/data/tmp
  
Probably a good idea to restart php, nginx.

  service nginx restart
  service php-fpm restart

Dokuwiki details their permission recommendations here:  [[https://www.dokuwiki.org/install:permissions|Install Permissions]].  The page is a bit complicated so the above is a simpler (but longer in syntax) version of the whole page, including the partial synopsis they put at the end, which I reprint below.

  yourwiki> chmod -R 775 data/
  yourwiki> chown -R www-data:foo data/
  everything below the data directory:
  yourwiki/data> chmod 2775 {attic,cache,index,locks,media,meta,pages,tmp}
  yourwiki/data> chown www-data:foo {attic,cache,index,locks,media,meta,pages,tmp}

This tutorial is a designated "Invariant Section" of the "Technotronic" section of Haack's Wiki as described on the [[https://jonathanhaack.com/dokuwiki/doku.php?id=start|Start Page]].

 --- //[[netcmnd@jonathanhaack.com|oemb1905]] 2019/01/06 20:00//
Haack's Wiki

User Tools

Site Tools

Page Tools
