From BCCD 3.0

The BCCD does its best to automatically configure itself for your network environment using the bccd-nic-setup script. This script follows the BCCD Credo: Hit Enter Until It Works, Unless You Know Otherwise. There are some instances when you need to supply information or perform some manual steps, which means You Know Otherwise.

Here's some scenarios:

Single BCCD on a network

This follows the BCCD Credo closely. bccd-nic-setup will prompt for what network you want other BCCD systems to connect to

---you might think you only want one BCCD on the network, but one inevitably turns into more---and you should press enter. The script will then display any network information available from DHCP

to which you should hit enter. If the BCCD is unable to find network information for a NIC, it will default to skipping it.

If you know what your network information is, you can select No and supply your own IP address, subnet mask, and optionally a gateway. If you don't specify a gateway, it will default to the IP address you type in.

The system will now continue booting up, and start up a DHCP server in case you ever want other BCCD systems on this network. Note that the DHCP server only answers requests from BCCD clients, and will serve up addresses on the private 192.168.3.0/24 network so as not to interfere with other non-BCCD network clients.

Another BCCD on the network

Putting another BCCD on the network is easy. Make sure you already have a BCCD DHCP server on the network by following the steps above steps above. Then, simply bring another system on the network. You should a screen showing that your second system has found its BCCD server, and you'd just hit enter to accept those settings.

Your default route will point through the first BCCD server on the network, so you'll be able to access the Internet assuming the first BCCD server can access the Internet.

BCCD PXE booting

BCCD PXE booting is only supported from a liberated (not live CD) BCCD, and requires a NIC to have no other DHCP servers responding on it. PXE booting requires disabling the functionality that makes a BCCD DHCP server only respond to BCCD clients, so you don't want to run it on a network with another DHCP server.

Since the liberation takes your network configuration from the non-PXE-capable live CD mode, you'll have to reset your network configuration first. To do that, simply run

  sudo /bin/bccd-reset-network

as the bccd user. This will shutdown networking and any DHCP servers, and re-run /bin/bccd-nic-setup. Hit enter until you hit a NIC that is skippable, and select No.

Assign eth1 an IP address and subnet mask, and optionally a gateway.

Once you're through those steps, a screen will come up asking whether you want this NIC to be a PXE capable NIC. You should hit enter.

Any systems on the same network as the NIC you configured to be PXE-bootable will now get PXE boot traffic.