Added MATE install and config walkthrough
authorvarialus <varialus@web>
Tue, 5 Aug 2014 21:21:40 +0000 (21:21 +0000)
committerCharlie Root <root@leaf.dragonflybsd.org>
Tue, 5 Aug 2014 21:21:40 +0000 (21:21 +0000)
varialus/index.mdwn

index 28baa84..e0b9df6 100644 (file)
@@ -6,8 +6,8 @@
 
 1. **Featured**
 
+* Walkthrough of MATE Installation and Configuration
 * Walkthrough of DragonFly BSD Installation and Configuration
-* (In Progress) Walkthrough of MATE Installation and Configuration
 * (In Progress) Walkthrough of Enlightenment Installation and Configuration
 * (In Progress) Walkthrough of KDE Installation and Configuration
 * (In Progress) Walkthrough of Xfce Installation and Configuration
 
 ## Featured
 
+**Walkthrough of MATE Installation and Configuration**
+
+This walkthrough describes how I install and configure the MATE desktop environment on DragonFly BSD. You should customize your installation as you see fit. This walkthrough is being run on DragonFly BSD as installed and configured in "Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
+    
+MATE is my favorite desktop environment. When currently installed and configured as described in this walkthrough, MATE works but has the following issues.
+    
+* DPorts has MATE 1.6.1 but MATE 1.8 is the current stable release. 
+* DPorts currently does not include the MATE meta package.
+* Enabling hald prevents applications from launching via the MATE menu.
+* Many non-fatal errors are logged in the /home/user and /var/log directories.
+* The process console-kit has high CPU utilization.
+
+I hope this walkthrough will make it easier for developers to properly fix these issues.
+
+    login: user
+    Password:
+    ...
+    By pressing "Scroll Lock" you can use the arrow keys to scroll backward
+    through the console output.  Press "Scroll Lock" again to turn it off.
+    > pkg search xorg
+    xorg-7.7
+    ...
+    > pkg search -f xorg-7.7
+    ...
+    This is a metaport for all the X.org packages available in the ports tree.
+    
+    WWW: http://www.x.org/
+    > sudo pkg install xorg-7.7
+    Password:
+    ...
+    The installation will require 200 MB more space
+    
+    70 MB to be downloaded
+    
+    Proceed with installing packages [y/N]: y
+    ...
+    ================================================================================
+    You installed xterm with wide chars support. This introduces some limitations
+    comparing to the plain single chars version: this version of xterm will use
+    UTF-8 charset for selection buffers, breaking 8-bit copy/paste support unless
+    you are using UTF-8 or ISO8859-1 locale. If you want 8-bit charset selections to
+    work as before, use "eightBitSelectTypes" XTerm resource setting.
+    
+    For further information refer to the SELECT/PASTE section of xterm(1) manual
+    page.
+    ================================================================================
+    ...
+    > pkg search xdm
+    ...
+    xdm-1.1.11_2
+    ...
+    > pkg search -f xdm-1.1.11_2
+    ...
+    This package contains xdm, the X.Org X Display manager.
+    > sudo pkg install xdm-1.1.11_2
+    ...
+    The installation will require 287 KB more space
+    
+    97 KB to be downloaded
+    Proceed with installing packages [y/N]: y
+    ...
+    > pkg search mate
+    ...
+    > pkg search -x "mate-[a-z]+"
+    Password:
+    ...
+    The installation will require 955 MB more space
+    
+    201 MB to be downloaded
+    
+    Proceed with installing packages [y/N]: y
+    ...
+    ===============================================================================
+    
+    In order to use the File System read/write monitor, you must chmod
+    /dev/devstat so that all users can open it read-only.  For example:
+    
+    # chmod 0444 /dev/devstat
+    
+    In order for this to persist across reboots, add the following to
+    /etc/devfs.conf:
+    
+    perm    devstat 0444
+    
+    ===============================================================================
+    ...
+    Note: in order to use the script dvipdf, dvips must be installed.
+    This program may be provided by either print/dvips or print/dvipsk-tetex
+    (print/dvipsk-tetex may be preferable since it doesn't conflict with
+    tetex things).
+    
+    Also note that FAPIfontmap and FAPIcidfmap in /usr/local/share/ghostscript/9.06/Resource/Init
+    have to be configured first.
+    ...
+    **************************************************************************
+    Congratulations!  MATE base has been successfully installed on your system.
+    For help on starting it up, as well as answers to common questions, and
+    some known issues, please see the FreeBSD GNOME homepage at:
+    
+                           http://www.FreeBSD.org/gnome/
+    
+    **************************************************************************
+    ...
+    > sudo ee /etc/rc.conf
+    ...
+
+**Add the following two lines.**
+
+    hald_enable="NO"
+    dbus_enable="YES"
+
+**Press Esc or Ctl-[**
+
+    ...
+    a) leave editor
+    ...
+    a) save changes
+    ...
+    > sudo ee /etc/ttys
+    Password:
+    ...
+
+**Find the following line.**
+
+    ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   off secure
+
+**Edit the previous line to match the following line.**
+
+    ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   on  secure
+
+**Press Esc or Ctl-[**
+
+    ...
+    a) leave editor
+    ...
+    a) save changes
+    ...
+    > sudo ee /usr/local/lib/X11/xdm/Xsetup_0
+    ...
+
+**Find the following line.**
+
+    xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
+
+**Edit the previous line to match the following line.**
+
+    #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
+
+**Add the following line.**
+
+    setxkbmap dvorak
+
+**Press Esc or Ctl-[**
+
+    ...
+    a) leave editor
+    ...
+    a) save changes
+    ...
+    > ee .xsession
+    ...
+
+**Add the following line.**
+
+    exec mate-session
+
+**Press Esc or Ctl-[**
+
+    ...
+    a) leave editor
+    ...
+    a) save changes
+    ...
+    > sudo ee /usr/local/lib/X11/xdm/xdm-config
+    Password:
+    ...
+
+**Find the following line.**
+
+    DisplayManager*authorize:       true
+
+**Edit the previous line to match the following line.**
+
+    DisplayManager*authorize:       false
+
+**Press Esc or Ctl-[**
+
+    ...
+    a) leave editor
+    ...
+    a) save changes
+    ...
+    > sudo shutdown -r now
+    Password:
+    ...
+    Login: user
+    Password: 
+    ...
+
+The MATE desktop will be displayed.**
+
 **Walkthrough of DragonFly BSD Installation and Configuration**
 
 This walkthrough describes how I install and configure DragonFly BSD. You should customize your installation as you see fit. The walkthrough is being run on VirtualBox which in turn is running on a recent MacBook with plenty of memory.
@@ -993,9 +1194,11 @@ Set the Time Zone of your physical location
 
 88. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
 
-89. Type 'pkg update' without quotes and press enter.
+89. Type 'source .cshrc' without quotes and press enter.
 
-90. The following output will be displayed.
+90. Type 'pkg update' without quotes and press enter.
+
+91. The following output will be displayed.
 
         Updating repository catalogue
         digests.txz                         100%  995KB 497.6KB/s 845.1KB/s   00:02
@@ -1003,27 +1206,27 @@ Set the Time Zone of your physical location
         Incremental update completed, 21327 packages processed:
         0 packages updated, 0 removed and 21327 added.
 
-91. Type 'pkg search sudo' without quotes, press enter and note the full name of sudo.
+92. Type 'pkg search sudo' without quotes, press enter and note the full name of sudo.
 
-92. Type 'pkg search -f sudo-1.8.10.p3' without quotes and press enter.
+93. Type 'pkg search -f sudo-1.8.10.p3' without quotes and press enter.
 
-93. Type 'pkg install sudo-1.8.10.p3' without quotes and press enter. Then when prompted, type 'y' without quotes and press enter.
+94. Type 'pkg install sudo-1.8.10.p3' without quotes and press enter. Then when prompted, type 'y' without quotes and press enter.
 
-94. Type 'rehash' without quotes and press enter.
+95. Type 'rehash' without quotes and press enter.
 
-95. Type 'visudo' without quotes and press enter.
+96. Type 'visudo' without quotes and press enter.
 
-96. Without quotes replace '# %wheel ALL=(ALL) ALL' with ' %wheel ALL=(ALL) ALL'.
+97. Without quotes replace '# %wheel ALL=(ALL) ALL' with ' %wheel ALL=(ALL) ALL'.
 
-97. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
+98. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
 
-98. Type 'pw usermod user -G wheel' without quotes and press enter.
+99. Type 'pw usermod user -G wheel' without quotes and press enter.
 
-99. Type 'exit' without quotes and press enter.
+100. Type 'exit' without quotes and press enter.
 
-100. Log in as user.
+101. Log in as user.
 
-101. You will be greeted with the following message and shell prompt.
+102. You will be greeted with the following message and shell prompt.
 
         Copyright (c) 2003-2014 The DragonFly Project.                                 .
         Copyright (c) 1992-2003 The FreeBSD Project.                                   .
@@ -1045,22 +1248,24 @@ Set the Time Zone of your physical location
                 man 1 intro                                                            .
         > _                                                                            .
 
-102. Type 'passwd' without quotes and press enter.
+103. Type 'passwd' without quotes and press enter.
+
+104. Type 'ChangeMe' without quotes and press enter, then type a new password and press enter, and then retype the new password and press enter again.
 
-103. Type 'ChangeMe' without quotes and press enter, then type a new password and press enter, and then retype the new password and press enter again.
+105. Type 'ee .cshrc' without quotes and press enter.
 
-104. Type 'ee .cshrc' without quotes and press enter.
+106. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'.
 
-105. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'.
+107. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
 
-106. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
+108. Type 'source .cshrc' without quotes and press enter.
 
-107. Type 'exit' without quotes and press enter.
+109. Type 'exit' without quotes and press enter.
 
 ## Tidbits
 * Shell/Console/Command-Line-Prompt: In the default shell, **tcsh**, ctrl-d is equivalent to tab-tab in **bash**, both of which display possible auto completions. If the list of possible auto completions has changed, running the command rehash will update it. Typing part of a previous command and then pressing the up key is equivalent to pressing ctrl-r and then typing part of a previous command, both of which search previously run commands.
 * Package-Management: **pkg**, also known as pkgng, is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
-* Text-Editor: **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save. You can get to the exit confirmation by pressing Ctrl-[ or Esc and selecting 'a) leave editor'. The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type :q! and then press enter.
+* Text-Editor: **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save. You can get to the exit confirmation by pressing Ctrl-[ or Esc and selecting 'a) leave editor'. The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type ':q!' without quotes and then press enter.
 * Manual: The command line program man, short for manual, is very handy for finding out information about programs, system files and more. One way to navigate man pages is by using your arrow keys. You can exit out of a manual page by pressing the letter q on your keyboard. To learn more about the man command, run the command man man which will show you the manual page for the man command.
 * Power-Down: sIn DragonFly BSD the command *shutdown -p now* will shutdown and turn off your computer. Using the -h switch instead of -p will shutdown and halt the computer but not turn it off. In Debian and probably other Linux distributions, the command *shutdown -h now* will shutdown and turn off your computer. The -p switch isn't available, but there may be a way to shutdown and halt without turning off your computer.
 * Find File: **grep** is great for finding text in a file and **find** is great for finding a file by name.