{section: Running Sample Lark Jobs}

{subsection: Installing Lark}

Download and install the latest Lark RPM from the Nebraska Koji.  The current build (as of the time of writing) is here:

http://koji.hep.caltech.edu/koji/buildinfo?buildID=935

We'll be doing periodic code releases.  Otherwise, you can checkout and build the source code.  If the Lark branch and your installed version are close enough (in terms of code changes), you can get away with a normal PROPER build plus the following configurations:

{verbatim}
STARTER.PLUGINS = /home/cse496/bbockelm/projects/condor-build/src/condor_contrib/lark/lark-plugin.so
STARTER = /home/cse496/bbockelm/projects/condor-build/src/condor_starter.V6.1/condor_starter
SHADOW = /home/cse496/bbockelm/projects/condor-build/src/condor_shadow.V6.1/condor_shadow
{endverbatim}

You'll also need to use the Lark version of libcondor_utils:

{verbatim}
ln -sf ~/projects/condor-build/src/condor_utils/libcondor_utils_7_9_5.so /usr/lib64/libcondor_utils_7_9_5.so
{endverbatim}

{subsection: Configuring Lark in NAT mode}

The minimum to configure lark, besides setting =STARTER.PLUGINS=, is to enable the network accounting:

{verbatim}
LARK_NETWORK_ACCOUNTING = true
{endverbatim}

This will result in a NAT configuration.

{subsection: Running jobs in NAT mode}

With a NAT configuration, a simple job is to look at the network configuration:

{verbatim}
[bbockelm@hcc-briantest lark]$ condor_run ifconfig
i_slot1   Link encap:Ethernet  HWaddr 0E:B5:9F:A2:E5:E4
          inet addr:192.168.181.2  Bcast:0.0.0.0  Mask:255.255.255.0
          inet6 addr: fe80::cb5:9fff:fea2:e5e4/64 Scope:Link
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:1 errors:0 dropped:0 overruns:0 frame:0
          TX packets:1 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:104 (104.0 b)  TX bytes:104 (104.0 b)
{endverbatim}

If you can execute =ifconfig= at the same time the job is running, the output will look like this:

{verbatim}
[bbockelm@hcc-briantest lark]$ ifconfig
e_slot1   Link encap:Ethernet  HWaddr 42:62:8D:A1:CC:E2
          inet addr:192.168.181.1  Bcast:0.0.0.0  Mask:255.255.255.255
          inet6 addr: fe80::4062:8dff:fea1:cce2/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:26 errors:0 dropped:0 overruns:0 frame:0
          TX packets:26 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:2636 (2.5 KiB)  TX bytes:2896 (2.8 KiB)
{endverbatim}

{subsection: Configuring Lark in Bridge Mode}

You need additional attributes in the machine ad to get Lark to change to bridge mode:

{verbatim}
STARTD_ATTRS = LarkNetworkType, LarkAddressType, LarkBridgeDevice
LarkNetworkType = "bridge"
LarkBridgeDevice = "eth0"
LarkAddressType = "dhcp"
{endverbatim}

In particular, you will need to adjust LarkBridgeDevice from "eth0" to match the desired ethernet device on your host.

The network available on "eth0" must have a DHCP server willing to provide IP addresses to unregistered ethernet devices.