Monthly Archive for July, 2006

How to configure MacOS X Server to share a PPPoE connection (or, how to not write crappy documentation)

I'm in the process of setting up a MacOS X Server box at the office, which will serve as a router/firewall/VPN/etc. I hit a roadblock yesterday when trying to configure NAT (Network Address Translation) for our ADSL connection. It turns out that Apple's Server Admin tool does not allow you to share a PPPoE (DSL) internet connection. Utter stupidity!

To top things off, while the knowledge base article explains this limitation, it fails to explain why this is the case:

You cannot configure network address translation (NAT) in Mac OS X Server when the primary Internet connection uses PPPoE, because the PPPoE network interface will not appear in the “External network interface” pop-up menu in Server Admin (located at Computers & Services > NAT > Settings).

Real helpful. ("Captain Obvious to the rescue!")

This is the recommended solution:

To work around this issue, you need a DSL modem that negotiates the PPPoE authentication itself, rather than configuring the server to do so.

The ability of a modem to operate in this manner is sometimes known as "half-bridge mode" or "DHCP spoofing."

Although MacOS X (and Server) supports PPPoE connections, we can't share them because the configuration software doesn't support it, and as a result we should go out and spend more money on hardware. Right…

Thankfully, some smart cookies have figured out that you can just override the settings.

Apple: Rather than shifting the blame and putting the onus on the administrator, why don't you fix the Server Admin tool to support what is already supported by the underlying software?

Announcing the JIRA Plugin for Quicksilver

I spend a lot of time interacting with the JIRA issue tracking software - often small tasks that need to be completed ("Add support for x recipe format", "Fix x on the website"). Though I'm fond of the web interface, the amount of clicks required to create a new issue can become tedious.

I'm also a HUGE fan of Quicksilver, so it seemed natural to leverage its productivity-foo to speed up the process.

With that in mind, I'd like to present the brand-spankin' new "JIRA Plugin for Quicksilver".

The following movie demonstrates how to configure the details of a JIRA instance and create a new issue using Quicksilver:

Watch the movie (You may need to control-/right-click on the link and download the movie.)

To create an issue, enter Quicksilver's "text entry" mode (press "."), and type in the information in the following format:

issue summary [: issue description] @ project key [> issue type]

The description and issue type (a number corresponding to the type - by default, a bug is 1, new features are 2, tasks are 3, improvements are 4) are optional.

For example, to create a new issue called "New Issue", in the project "FOO", you would type the following:

New Issue @ FOO

After that, tab across, type in "JIRA" and the "Create new issue in JIRA…" action will appear. Hitting enter on that will create the issue and open a new browser window for the issue.

Download version 0.1 here.

Notes:

  • The JIRA password is stored in the Quicksilver preferences in PLAINTEXT for the moment. I will investigate storing it in the keychain in the future.
  • It will also spit out a bunch of logs into your console. No biggie.

End of an era

The Friday before last (23/6) was my final day at Atlassian, after having the opportunity to work there for the last year on University work placements. The culture Mike and Scott have created, and the exciting work they do has made my time there extremely interesting and enjoyable.

Alas, I will be moving on and doing some exciting work with Mat at The Little App Factory. If we can create a workplace a fraction as exciting and successful as Atlassian, then I will be over the moon. I wish all the best to the Atlassian crew (though I suspect I'll be seeing them again), and thanks for the great experiences!




Creative Commons Attribution-NonCommercial-ShareAlike 2.5 Australia
Creative Commons Attribution-NonCommercial-ShareAlike 2.5 Australia