Goozbach's tech tips

Movable Type dynamic pages

2009-03-29T16:10:00Z

Keeping my site up to date

I was having trouble keeping my Projects and Presentation pages up to date. I was always creating new projects, and presentation materials, however I always forgot to update the corresponding pages in Movable Type. I decided to make it easier to keep those pages updated.

The system I use is based on Mod_Include, MultiMarkdown and Movable Type.

Enabling per-directory Server-Side Includes

The first step in this process is to enable server side includes. You can make it so EVERY .html page is parsed for SSI, but that can be a resource drain and cause slow page delivery times. I chose to enable SSI for all .shtml files in just two separate directories on my site.

Apache Config -- Enable SSI

The Apache configuration I use on my site is pretty simple. Here's how I enabled SSI on my /projects/ directory:

    <location /projects/>
        Options +Includes
        AddType text/html .shtml
        AddOutputFilter INCLUDES .shtml
        XBitHack Full
    </location>

Filesystem tweaks

In order to make Movable Type "create" .shtml files I cheated. I just created symlinks from the index.html file to index.shtml in each location I wanted my SSI to work.

    cd /var/www/blog/projects/
    ln -s index.html index.shtml

Apache Config -- Rewrite Fun

To make the request ALWAYS use the .shtml file I created a simple rewrite rule which invisbly proxied the requests for / and index.html to the proper index.shtml file.

    RewriteEngine On
    # rewrite rule which makes /projects/index.html SSI enabled
    RewriteRule ^/projects/index.html  /projects/index.shtml [P,L]
    RewriteRule ^/projects/$  /projects/index.shtml [P,L]

Create your include

The next step is to actually create an include file which will be what is used when the SSI directive is parsed. As I'm trying to include the contents of a completely different site (projects.friocorte.com VS blog.friocorte.com) I used wget to fetch a copy of that page locally. I did this with a cronjob so the include is always up to date.

    0 0 * * * wget -q -O /var/www/html/blog/projects/projects-include.html http://projects.friocorte.com/projects/

Movable Type page contents

The last step is to actually create an SSI directive in your Movable Type page. Here's the contents of my projects page:

    <p style="margin-top: 0px;">As an opensource advocate I use, and suggest that others use opensource projects.<br />
    Here are a few of my open source projects:
    <!--#include virtual="projects-include.html" -->

That's all there is to it. Now I have a site which keeps up with my projects, and my presentations automatically.

Cobbler Presentation and re-vamped pages.

2009-03-28T00:13:15Z

Cobbler presentation

I've finally posted the first draft of my cobbler presentation materials. I'm not done with them, as I need to finish my remote-control system to do some screencasts. You can find the materials here.

Re-vamped pages on my site

Speaking of presentations, I've re-vamped some of the pages on this site. The two I've updated are the Presentations and Projects pages. These pages were long neglected, and weren't updated as new projects or presentation materials were made available. Now these pages will no longer get out of date as I've made them automatically update as new projects or presentation materials are posted. Watch for a forthcoming blog post about how to accomplish the same thing with your own Movable Type installation.

Until next time.

-- Goozbach

Cookie lumps.

2008-10-11T23:54:29Z

A chocolate chip cookie recipe

Inspired by the likes of Joseph Hall and Alton Brown. I have spend the last few years working on a chocolate chip cookie recipe. People have been asking about how I make these cookies for a long while. To respond to all of them, I'm going to post my recipe and methods here.

While I do follow most of the guidelines of the above mentioned recipes. I'm not going to delve into what all of the terms mean. Read those links above and thereby learn how to do what I mention here.

The Stars (ingredients)

The Dry

2 1/2 to 3 cups Bread flour
1 tsp baking soda
1 tsp salt
2 cups semi-sweet chocolate chips

The Wet

1 stick (1 cup) butter flavour shortening
2 large whole chicken eggs
1 Tbsp Vanilla Extract
1 Tbsp honey
1 1/2 cups dark brown sugar (packed)

Getting Started

Cream together the shortening and brown sugar, scraping the mixing bowl down a couple of times. Take your time doing this.

Add the eggs, one at a time. Scraping the sides after each one. Mix well.

Add the honey and vanilla.

Set this mixture aside.

Setting up the Dry

Sift together the flour, salt, and baking soda. Do a good job here as the better it's mixed prior to being combined with the wet, the better the cookie is afterwords. I like to use a wire colander and a wire whisk.

Combining

Slowly add the dry ingredients into the wet, one half-cup at a time. Pause after each cup of flour and scrape down the sides of your bowl (seeing a pattern yet?). I add just enough flour until the mixture pulls away from the sides of the mixing bowl and starts to form up. I like a fairly dry dough. Mix in the chocolate chips.

Portioning

Prepare a half baking sheet by lining it with parchment paper. Using a # 30 disher, not a spoon, form balls approx 1.5 inches in diameter and lay them all together on the baking sheet. Freeze these cookie "lumps" solid(1 hour minimum).

Baking

Preheat your oven to 350° F. Place 6-9 frozen cookies onto a parchment lined baking sheet and bake from 10-12 minutes, until the tops of your cookies start to dry out and turn darker brown. Immediately remove the cookies from the sheet to a cooling rack upon removing them from the oven.

ENJOY!

The reasoning

If you've followed Alton Brown's show, or spent any time talking to any cookie fanatic, you'll notice that this recipe is pretty close to the Toll House one. I've made a few adjustments. Here's the reasoning behind them.

Pure brown sugar and honey

I went with 100% pure brown sugar to up the molasses content of the cookie. Molasses helps keep your cookies moist. Honey is hygroscopic as well. This was a change I made for a chewier cookie which stayed moist for as long as possible.

Bread flour

Bread flour contains the proteins needed to develop gluten. Gluten helps make a baked good chewy. By using 100% bread flour, and working the dough quite a bit(all the pausing and scraping, and mixing). You add a good deal of gluten.

Shortening vs butter

I decided to use shortening in my cookie because I like my cookies to not spread out very much. Shortening has a much higher melting point which allows the cookie to rise a bit before it finishes baking.

Freezing the partitioned dough

Freezing the dough solid also helps keep the cookie from spreading too much. If you partition the dough into balls prior to freezing it allows you to bake just the right amount of cookies. Frozen dough will keep for weeks in an airtight container in the freezer.

I hope you enjoy these cookies.

MultiMarkdown Apache handler.

2008-08-12T02:09:33Z

The "What?" and the "Why?"

I've been a fan of the MultiMarkdown for quite a while now. I keep all of my important notes in this format, which is easy to write with just a simple text editor.

I wanted to be able to copy or sync my *.mark files to my web server and have them automatically be rendered as XHTML. I looked into a couple of ways of doing this. One of which is the Text::MultiMarkdown::ApacheHandler Perl module Apache handler. The downside is that this handler doesn't work out of the box in Apache2.2.

Read on to see my solution. I've also seen a cgi based apache handler done by reppep as chronicled here. The only problem is that he's using the original Markdown. I've long been a fan of the extended syntax, and output formats I can get from MultiMarkdown. So I've build a similar script to what reppep has done.

The "How?"

Prereqs.

You'll need at least these Perl modules installed on your system.

File::Slurp
CGI
Text::MultiMarkdown

You'll also need Apache and mod_cgi installed.

The script

The CGI script I use is pretty straightforward. Here it is in it's entirety:


#!/usr/bin/perl
use warnings;
use strict;
use CGI qw/:standard/;
use Text::MultiMarkdown qw/markdown/;
use File::Slurp qw/slurp/;

my $file = $ENV{PATH_TRANSLATED};
my $text = slurp($file);
my $mark;
if (param('_text')) {
  print header('text/plain');
  print $text;
} else {
  print header;
  $text .= "\n\n[See the Source](?_text=1)\n\n";
  if (param('_partial')) {
    ##TODO test for Format: complete header and warn
    my @lines = split /\n/, $text;
    if (@lines = grep (!/^([Ff][Oo][Rr][Mm][Aa][Tt]):\s*(.*)$/, @lines)) {
       print "<h4>Overriding metadata to generate partial XHTML</h4>\n";
    }
    $text = join("\n",@lines);
    $mark = markdown($text);
  } else {
    $mark = markdown($text, {
      document_format => 'complete'
      }
    );
  }
  print $mark;
}
__END__

=head1 Name

multmd.pl

=head1 DESCRIPTION

A simple cgi script which is used as an action handler for the Apache HTTP
Server.

=head1 USAGE

Place this file into your cgi-bin directory and add a stanza like this to
/etc/httpd/conf/httpd.conf

    Action markdown /cgi-bin/multimd.pl
    AddHandler markdown .mark
    AddType text/html .mark

Now any MultiMarkdown file you serve which has the extenstion .mark will
automatically get rendered as xhtml.

This script will honor all of the metadata you place in your markdown file
with the exception of the Format: header which is always assumed to be 
complete

=head1 OVERRIDES

You can override the default actions of this script by passing some
parameters encoded into the URL.

=head2 TEXT

Pass a parameter of _text=1 to get the raw MultiMarkdown file.

    http://example.com/foo.mark?_text=1

=head2 PARTIAL

To override the default action of rendering an entire XHTML file, pass a
parameter of _partial=1 to get just the partial XHTML.

    http://example.com/foo.mark?_partial=1

This will override any Format: headers in your source MultiMarkdown file.
And the default format of the handler (which is complete).

Place this script into your cgi-bin directory and make sure it's executable by your web server's process. I named mine multimd.pl. Here's a downloadable link of multimd.pl

The config

To make your new script do exactly what you want it to (render *.mark files as XHTML to the browser), you'll need to modify your Apache config. I placed this config section into a file named /etc/httpd/conf.d/multimarkdown.conf

Action markdown /cgi-bin/multimd.pl
AddHandler markdown .mark
AddType text/html .mark

Testing

Make sure your Apache configs are proper by running the command apachectl configtest. If all checks ok, you should be good to restart your Apache server, upload a MultiMarkdown-formatted file to your web server with the extension of *.mark, and see it rendered in it's full XHTML glory.

You can see examples of how this MultiMarkdown handler works by clicking on the links below.

Presentation on presentations

After action report from my presentation

As you have probably noticed, there is a "See the source" link on each rendered page. This is part of the CGI script I created. Add the parameter _text=1 to the url and the handler passes the MultiMarkdown source file straight to the client without any rendering, like so.

I hope you enjoy the simplicity of editing decent web documents in a simple format.

Next time I'll share how I keep all of my files in sync using Bazaar-ng and bzr-push-and-update.

Everybody Should go to UTOSC -- 2008

2008-07-31T21:15:29Z

This year I'm not going to be able to make it to the Utah Open Source Conference. This makes me sad. So to get everyone excited. I'm FINALLY blogging about the videos which were taken of my presentation at last year's event.

You can watch an interview which I gave for OpensourceTV here:

The first part of my presentation on Virtualization here:

and the second part here:

Powerful Presentations

2008-04-16T04:53:05Z

I'm doing a presentation for ALE Central this Thursday

Here's the blurb

In our professional lives we often spend a great deal of time in one sort of presentation or another. A PowerPoint slide show for work, a story to our children at bedtime, "selling" your boss on your next big idea, or simply "selling" yourself as an entrepreneur.

A properly created presentation can be extremely powerful. It can mean the difference between getting that new contract with the Johnson firm and spending the next four months trying to find new customers. Perhaps your sub-par presentation is all that's keeping your small business from catching the eye of some big venture capital firm.

Presentations are a big part of being involved in the Open Source movement. Conferences, user group meetings, etc. Being a proponent of open source gives us quite a few opportunities to present.

Come an learn how a proper presentation is more than "not putting everybody to sleep". We will cover everything from preparation to handouts, PowerPoint decks to no slides whatsoever, handing "that guy in the second row" to "Wowing the room. You might even learn what a "bathroom review" is.

I promise you won't be disappointed.

And here's the important stuff

Date and Time

Thurs April 17th 7:30pm to ~9:30pm

Location

Gambrell Hall Classroom 1C

Emory University School of Law
1301 Clifton Road
Atlanta, GA 30322

Great Quote -- Sir Ken Robinson

2008-03-03T16:57:20Z

I had a great idea

I've been a big fan of the TED talks for a while now and listening to them just inspired me to do something new.

Every so often I will post to this blog one of the great quotes I've stumbled across during my day.

Sir Ken Robinson on creativity

Taken from his TED Talk.

If you are not prepared to be wrong; you'll never come up with anything original

Hope you enjoy this new feature of my blog.

EDIT: 2008-03-03 14:00

Fixed my links. Sorry

Good "Hack Music"?

2008-02-27T18:29:30Z

I work in an office with four other people. This is a good thing when it comes to communicating and working together. However it can be a bit detrimental when it comes to entering into "The Zone".

To combat this, I've been listening to music through headphones... There is a bit of a problem with the solution I have noticed, not all music is conducive to entering "the zone".

Here's a list of artists whom I've decided are great for "Hack Music". Artists whose music is great for reducing ambient noise, while not distracting you too much.

Muse
Blue Man Group
Thievery Corporation
MC 900ft Jesus
Daft Punk
Basement Jaxx

What is your favorite "hack music"? Post a comment and we'll make a big list for everyone's enjoyment.

Thoughts while working with a Cisco switch

2008-02-05T19:51:53Z

I've just racked and installed my newest toy at the datacenter: a Cisco Catalyst 4948 switch .

Prior to working here I have never had the experience of working with a Cisco switch other than to plug myself into it and run on the network it provides.

I'm keeping this log to document how I've set up my switch.

Let's start out with what I've done up to this point.

I have unpacked, racked, connected power to, connected to the serial port and booted/powered on my new switch.

In order to do this I've needed the following pre-requsites.

Pre Reqs

cisco switch
console cable
USB serial cable adapter
minicom

First Time Configuration

You need to configure your terminal emulator of choice (I've chosen minicom) to listen with the following settings:

# Machine-generated file - use "minicom -s" to change parameters.
pu port             /dev/ttyUSB0
pu baudrate         9600
pu bits             8
pu parity           N
pu stopbits         1

Make sure your switch's serial cable is plugged in to the console port on the switch, and into your laptop/desktop.
Make sure you have your terminal emulator running.

Power on your switch. You will see a great deal of text fly by on your terminal, you will have to wait for a few minutes as your switch does a power-on self test. Once the switch has finished booting and running its POST you should see some text like this:

Press RETURN to get started!
00:00:01: %C4K_IOSSYS-3-BLANKSTARTUPCONFIG: Blank or invalid startup-config, bos
00:00:16: %SPANTREE-5-EXTENDED_SYSID: Extended SysId enabled for type vlan
00:00:17: %C4K_IOSMODPORTMAN-6-MODULEONLINE: Module 1 (WS-C4948 S/N: FOX11440P2e
00:00:37: %SYS-5-RESTART: System restarted --
Cisco IOS Software, Catalyst 4000 L3 Switch Software (cat4000-I5S-M), Version 1)
Technical Support: http://www.cisco.com/techsupport
Copyright (c) 1986-2007 by Cisco Systems, Inc.
Compiled Thu 25-Oct-07 16:46 by kellythw

At this point your switch should be ready for your initial setup.

Press ENTER to enable your switch's console. You should see a prompt like this:
```
Would you like to terminate autoinstall? [yes]:
```
Press ENTER again to terminate the autoinstall and bring up your command line interface (CLI)
This is your CLI:
```
Switch>
```
Enter the command enable to put the CLI into privileged mode. Your prompt should change like this:
```
Switch>enable
Switch#
```
You may have to enter a password, if so, the default password is: password
The next step is to set the clock, which is done with the clock set command:
```
Switch#clock set 20:27:00 5 Feb 2008
```
you can check if your clock setting was successful by running the show clock command:
```
Switch#show clock
20:28:32.551 UTC Tue Feb 5 2008
Switch#
```
You will want to give your switch a hostname do this with the hostname command. The hostname command only works in the configuration system. Enter the configuration system by using the configure command:
```
Switch#configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.
Switch(config)#
```
Set the hostname:
```
Switch(config)#hostname gigswitch-02
gigswitch-02(config)#
```
Your switch has two passwords, one for secure administration and one for clear text. you need to set them by using the enable secret and enable password commands:
```
gigswitch-02(config)#enable secret supersecretpasswd
gigswitch-02(config)#enable password notsosecretpasswd
```
Unless you want to always configure your switch using the serial cable, you'll want to create a management port on the switch. This port is usually the highest-numbered port on the switch. On my switch it is port 48. You change the network settings on a switch port using the interface command:
```
gigswitch-02(config)#interface gigabitEthernet1/48
gigswitch-02(config-if)#no switchport
gigswitch-02(config-if)#no shutdown
gigswitch-02(config-if)#ip address 10.0.0.42 255.255.255.0
gigswitch-02(config-if)#exit
```

You are now done with the basic configuration. You'll want to exit configuration mode, check your settings, then apply them.

gigswitch-02(config)#exit
gigswitch-02#
01:07:06: %SYS-5-CONFIG_I: Configured from console by console
gigswitch-02#

Check your settings using show run:

gigswitch-02#show run
. . . <snip> . . .
line vty 0 4
!
!
end
gigswitch-02#

Apply your settings using the copy command

gigswitch-02>copy system:running-config nvram:startup-config

Your switch is now ready to go.

Enabling ports 47 and 48

On my switch, the copper Ethernet ports 47 and 48 are shared with the fiber-optic Base-X ports, I purchased my switch without any fiber modules, therefore I want to enable the copper ports instead. I do this by changing the media type.

Begin by making sure you are logged into your switch, and have enabled privileged mode:
```
gigswitch-02>enable
Password: <enter your secret password here>
```

Enter configuration mode:

gigswitch-02#configure terminal
Enter configuration commands, one per line.  End with CNTL/Z.

Enter the configuration mode for the interface you want to change:

gigswitch-02(config)#interface gigabitEthernet1/47
gigswitch-02(config-if)#

Change the media type

gigswitch-02(config-if)#media-type rj45
01:46:59: %C4K_IOSINTF-5-RJ45ACTIVE: Slot= 1 Port= 47:  RJ45 connector has become active
gigswitch-02(config-if)#exit

Repeat the last step for port 48.

Exit configure mode and save your changes.

gigswitch-02(config)#exit
01:49:17: %SYS-5-CONFIG_I: Configured from console by console
gigswitch-02#copy system:running-config nvram:startup-config
Destination filename [startup-config]?<enter>
Building configuration...
Compressed configuration from 2334 bytes to 1013 bytes[OK]

Congratulations your switch is now configured, and all 48 ports are active.

Using Virt-clone

2008-01-24T21:38:09Z

Using the libvirt tool virt-clone is pretty simple to make a new guest image.

virt-clone -o ORIGINAL_GUEST -n NEW_GUEST_NAME -f /new/guest/disk/file

There's not much more to it. Virt-clone takes care of all the unique stuff (uuid, mac address, etc).

I am a genious (SIC)

2008-01-07T23:54:10Z

I have two Debian servers, One is the old one, running on hardware that dell is no longer supporting (without us shelling out again) in a couple months. The other -- the new one-- is a virtual instance I have just installed on top of Citrix XenServer. Both are running Debian 4.0 "Etch".

The application we have running on the old server has quite a few dependencies, and the Operating system hasn't been re-installed in quite some time. As a matter of fact, it is running an image which was based off an image which was based off an image. In other words, I needed a quick and dirty way of installing all the packages which are needed on the new server, without using the old image.

Here's what I did:

First, on both servers I made a list of the packages which were installed. I did this by running the command:

root@oldhost # dpkg -l > packages.old

and on the new server:

root@newserver # dpkg -l > packages.new

I then combined the lists using text tools such as 'cat' 'sort' 'uniq' etc...
Then I used vimdiff to find the differences between the two servers and make choices as to which packages I wanted installed. All in all I ended up with a third list which was my cleaned list of packages.

After copying the clean list to the new server, I ran this command:

perl-01:/tmp# for i in `cat packages.final` ; do dpkg -l $i &>/dev/null && echo "found package: $i, doing nothing" || apt-get install $i; done

This command will install a package if it's not currently on the system, and output "found package $foo, doing nothing" if it is already installed. You have only to sit at the prompt and answer any of the dpkg-configure questions which may pop up.

Cool, no?