= FeistSetup =

`feist` is the name of the Linux OS on my new (as of 2009-01-05) desktop.

Hardware Specs:
 * RAM: 2 x 2048MB DDR2800 (PC2-6400)
   * G.Skill: F2-6400CL5D-4GBPQ
   * CL5-5-5-15
   * 1.8-1.9V
 * Motherboard: Gigabyte EP45-UD3P
 * Video Card: Sapphire ATI Radeon HD 3870
   * 512MB GDDR4
   * PCI-E
   * Dual DVI
 * CPU: E8400 Intel Core 2 Duo
   * 3 GHz
   * 45nm
   * 6MB L2 shared cache
   * LGA775 socket
   * 1333 MHz FSB
   * Product Code: BX80570E8400
   * MM #: 899035
   * FPO/Batch #: Q832A384
   * S-spec: SLB9J

Please see the following sub-guides:
 * FeistSetupNetworkClient: describes the steps necessary to make the computer a client of the DOH network
 * FeistSetupUserSettings: describes the steps necessary to setup a new user account on the computer
 * FeistSetupVirtualBox: describes the steps necessary to install !VirtualBox and use it to run `brooks`
 * FeistSetupWine: describes the steps necessary to install `wine` and Windows applications
 * FeistSetupDevelopment: describes the steps necessary to install development tools, etc.
 * FeistSetupNx: describes the steps necessary to make the computer an NX server and client


== Ubuntu 8.10 64bit Desktop, Clean Install ==

Here's what I did:
 1. Setup Vista Home Premium SP1 on drive (see BrooksSetup).
 1. Booted from Ubuntu install CD into Live CD Desktop.
 1. Moved Windows partition to front of drive (it was off by 1MB for some reason) and resized it to around 80GB.
 1. Ran Ubuntu install from Live CD environment.
    1. Used the ''Guided - use the largest continuous free space'' option in partitioner.  Please note that this may display the resulting disk layout incorrectly as only having Ubuntu-- this can be ignored.
    1. I opted to create a `localuser` account (as opposed to a `karl` account).
 1. After rebooting into the new Ubuntu system, I installed the available updates before doing anything else:
{{{
# apt-get update
# apt-get dist-upgrade
}}}


== OpenSSH Server ==

Install it:
{{{
# apt-get install openssh-server
}}}


== X Setup ==

References:
 * http://hamzakc.wordpress.com/2006/10/16/dual-monitor-setup-ubuntu-ati/
 * http://www.jumpingbean.co.za/blogs/mark/linux-ati-driver-tutorial-how-to
 * http://ubuntuforums.org/showthread.php?t=301941

Turn on the ATI drivers:
 1. ''System --> Administration --> Hardware Drivers''
 1. Select the proprietary ATI driver and click the ''Activate'' button.
 1. Restart.

Advanced setup for dual monitors:
 1. Get back to a default xorg.conf file:
{{{
# dpkg-reconfigure -phigh xserver-xorg
}}}
 1. Use `aticonfig` to enable the fglrx driver:
{{{
# aticonfig --initial --overlay-type=Xv --overlay-on=0
}}}
 1. Configure the primary monitor's resolutions:
{{{
# aticonfig --resolution=0,1600x1200,1280x1024,1024x768,800x600
}}}
 1. Configure the secondary monitor's resolutions:
{{{
# aticonfig --mode2=1280x1024,1024x768,800x600
}}}
 1. Configure the dual-head setup:
{{{
# aticonfig --desktop-setup=horizontal --sync-vsync=on
}}}
 1. Switch the secondary monitor from left to right (shouldn't be necessary, but is):
    1. Open ''Applications --> Accessories --> ATI Catalyst Control Center''.
    1. Select the ''Display Manager'' node.
    1. Switch to the ''Multi-Display'' tab.
    1. Select the ''Big Desktop right of display 1'' configuration option.
    1. Click the ''OK'' button.


== Compiz ==

Install the advanced settings manager:
{{{
# apt-get install compizconfig-settings-manager emerald
}}}


== Audio ==

Unmute all audio output channels:
 1. Right-click the volume widget and select ''Open Volume Control''.
 1. Click ''Preferences''.
 1. Check everything in the list and then click ''Close''.
 1. In the ''Volume Control'' window, go through and unmute all output channels (be sure to scroll right).
 1. Click ''Close''.


== Adobe Flash ==

Install the Adobe plugin (32 bit) from the `multiverse` repository:
{{{
# apt-get install flashplugin-nonfree
}}}

Alternatively, the 64bit Linux alpha version of Flash 10 can be installed manually: 
 1. Download the `.tar.gz` file from [http://labs.adobe.com/technologies/flashplayer10/64bit.html]. 
 1. Unzip the `.so` plugin from the `.tar.gz` file. 
 1. Copy the `.so` file to the `/usr/lib/mozilla/plugins` directory. 


== Disabling avahi ==

avahi causes problems with .local domains.  It appears the new version checks for the presence of these domains at startup, but this can still be an issue when using VPN.

To disable avahi discovery, edit the "hosts" line in /etc/nsswitch.conf as follows:
{{{
#hosts:          files mdns4_minimal [NOTFOUND=return] dns mdns4 <-- This line edited to resolve avahi and *.local DNS issues
hosts:          files mdns4_minimal dns mdns4
}}}

Restart.


== VPN Client ==

References:
 * https://help.ubuntu.com/community/VPNClient#Manually%20configuring%20your%20connection

Install the PPTP plugin for network-manager:
{{{
# apt-get install network-manager-pptp
# NetworkManager restart
}}}

Thanks to [https://bugs.launchpad.net/ubuntu/+source/network-manager-pptp/+bug/259168 Bug 259168], the following workarounds are needed:
 1. Do not save the connection password; it will be unable to connect.
 1. Enable the ''Use Point-to-Point encryption (MPPE)'' option in ''VPN Connections --> Configure VPN --> Edit --> Advanced''.
 1. Run `gconf-editor` and in the `/system/networking/connections/x/vpn` node, create a '''refuse-eap''' ''String'' key with a value of '''yes'''.


== Epson Printer ==

Install the escputil package:
{{{
# apt-get install escputil
}}}

Run the escputil command to check ink levels:
{{{
# escputil -i -r /dev/usblp0
}}}


== Gnome Do ==

Install gnome-do:
{{{
# apt-get install gnome-do
}}}

Set it to automatically start at login:
 1. Open ''Applications --> Accessories --> GNOME Do''.
 1. Right-click the icon for it by the clock and choose ''Preferences''.
 1. Enable ''Start GNOME Do at login''.


== `tracert` ==

Install the `traceroute` package:
{{{
# apt-get install traceroute
}}}


== Convert Flash (`.flv`) Videos ==

References:
 * https://help.ubuntu.com/community/AndroidVideoEncoding
 * https://bugs.launchpad.net/medibuntu/+bug/291011/comments/1

Enable Medibuntu:
{{{
$ sudo wget http://www.medibuntu.org/sources.list.d/intrepid.list --output-document=/etc/apt/sources.list.d/medibuntu.list
$ sudo apt-get update && sudo apt-get install medibuntu-keyring && sudo apt-get update
}}}

Install `ffmpeg` and the non-free codecs:
{{{
$ sudo apt-get install ffmpeg w64codecs libavcodec-unstripped-51
}}}

Convert a `.flv` file to a `.mp4` one using the mpeg4 codec:
{{{
$ ffmpeg -i get_video -s 480x320 -vcodec libmpeg4 -acodec aac -ac 1 -ar 16000 -r 13 -ab 32000 -aspect 3:2 -padtop 32 -padbottom 32 tmobileDance.mp4
}}}

Convert a `.flv` file to a `.mp4` one using the h264 codec
{{{
$  ffmpeg -i get_video -s 480x320 -b 384k -vcodec libx264 -flags +loop+mv4 -cmp 256 -partitions +parti4x4+parti8x8+partp4x4+partp8x8+partb8x8 -subq 7 -trellis 1 -refs 5 -bf 0 -flags2 +mixed_refs -coder 0 -me_range 16 -g 250 -keyint_min 25 -sc_threshold 40 -i_qfactor 0.71 -qmin 10 -qmax 51 -qdiff 4 -acodec libfaac -r 13 tmobileDance-h264.mp4
}}}


== Fonts To Install ==

Install the fonts:
{{{
# apt-get install ttf-sil-gentium ttf-dustin
}}}


== Temperature Sensors ==

Install and configure the sensors:
{{{
# apt-get install lm-sensors
# sensors-detect
}}}

When prompted by `sensors-detect`, answer `yes` to everything.

To view the current temperatures, run:
{{{
$ sensors
}}}


== VMWare Console Client ==

Follow the following steps to download and install this tool:
 1. Download the "VMware Server Linux client package" from [http://register.vmware.com/content/download.html].
 1. Extract the `/tar.gz` installer from the downloaded archive extract its `vmware-server-console-distrib` file.  
 1. Open a terminal in the folder and run the following command to start the install:
{{{
# ./vmware-install.pl
}}}
    * Accept all of the default options.
    * Accept the license agreement.
 1. Create a new menu entry for the application.
    * Name: `VMWare Server Console`.
    * Command: `/usr/bin/vmware-server-console`
    * Icon: `/usr/lib/vmware-server-console/share/pixmaps/appIcon.xpm`.

Error: `/usr/lib/vmware-server-console/bin/vmware-server-console: symbol lookup error: /usr/lib32/libgio-2.0.so.0: undefined symbol: g_thread_gettime`

References:
 * http://bugzilla.gnome.org/show_bug.cgi?id=543234

Solution:
 * Create the following script as `/usr/bin/vmware-server-console-workaround.sh`:
{{{
#!/bin/sh
unset LD_LIBRARY_PATH
/usr/bin/vmware-server-console
}}}
 * Set the script's permissions:
{{{
# chmod 755 /usr/bin/vmware-server-console-workaround.sh
}}}
 * Set all shortcuts to call the new script.


== HP Photosmart C4500 All-in-one Printer ==

References:
 * https://answers.launchpad.net/hplip/+question/45556

To setup this printer for a wireless connection, the setup software that came with it must be run once from a Windows computer connected to the printer.

Instal the PyQT libraries on the Linux computer for a graphical version of the printer setup (highly recommended):
{{{
# apt-get install python-qt3
}}}

After the printer's wireless connection has been setup, run the following on the Linux computer:
{{{
# hp-setup
}}}

If automatic discovery fails, select '''Find Manually...''' and enter the IP (likely `192.168.1.103`).  It did not have a driver listed for the 4500 series but selecting the 4400 series driver seems to have worked (though printing a test page failed).


== Video Flickering with Compiz Enabled ==

It's a known bug.  Seems that Nvidia's driver replaces large portions of X to get around it.  AMD may have a fix out in their driver, but that fix is definitely not in Intrepid as of 2009-04-02.

Here's the bug:
 * https://bugs.launchpad.net/ubuntu/+source/fglrx-installer/+bug/179042

Here's a set of workarounds that sacrifice performance to reduce seizures:
 * http://www.ubuntugeek.com/fix-for-video-playback-problem-in-compiz-fusion.html


== LaTeX and LyX ==

[http://en.wikipedia.org/wiki/LyX Lyx] is a WYSIWYM editor for [http://en.wikipedia.org/wiki/LaTeX LaTeX].  It can installed by running the following command:
{{{
# apt-get install lyx
}}}

The following LaTeX templates have been installed and use on this computer:
 * [http://tug.ctan.org/tex-archive/macros/latex/contrib/moderncv/]

To install a template:
 1. Copy it into a subdirectory of `/etc/local/share/texmf`.
 1. Run `texhash`:
{{{
# texhash
}}}
 1. Reconfigure LyX:
    1. Open LyX.
    1. Select the '''Tools > Reconfigure''' menu option.
    1. Restart LyX.