- enable local DNS server by default, set primary DNS server for MyPLC
[myplc.git] / plc_config.xml
index 1a1bdb1..aea09e0 100644 (file)
@@ -1,5 +1,15 @@
-<?xml version="1.0"?>
-<!DOCTYPE configuration PUBLIC "-//PlanetLab Central//DTD PLC configuration//EN" "configuration.dtd">
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+Default PLC configuration file
+
+Mark Huang <mlhuang@cs.princeton.edu>
+Copyright (C) 2006 The Trustees of Princeton University
+
+$Id: plc_config.xml,v 1.12 2006/04/28 20:15:00 mlhuang Exp $
+-->
+
+<!DOCTYPE configuration PUBLIC "-//PlanetLab Central//DTD PLC configuration//EN" "plc_config.dtd">
 
 <configuration>
   <variables>
@@ -28,9 +38,9 @@
          not be changed.</description>
        </variable>
 
-       <variable id="root_user" type="password">
+       <variable id="root_user" type="email">
          <name>Root Account</name>
-         <value>root@test.planet-lab.org</value>
+         <value>root@localhost.localdomain</value>
          <description>The name of the initial administrative
          account. We recommend that this account be used only to create
          additional accounts associated with real
       <variablelist>
        <variable id="dns1" type="ip">
          <name>Primary DNS Server</name>
-         <value>128.112.136.10</value>
+         <value>127.0.0.1</value>
          <description>Primary DNS server address.</description>
        </variable>
 
        <variable id="dns2" type="ip">
          <name>Secondary DNS Server</name>
-         <value>128.112.136.12</value>
+         <value></value>
          <description>Secondary DNS server address.</description>
        </variable>
       </variablelist>
     </category>
 
+    <category id="plc_dns">
+      <name>DNS</name>
+      <description>MyPLC can provide forward DNS resolution for itself
+      and for its nodes. To enable resolution for MyPLC itself, set
+      the Primary DNS Server address to 127.0.0.1 and provide external
+      IP addresses for the database, API, web, and boot servers
+      below. To enable resolution for nodes, use the external IP
+      address of this machine as the primary DNS server address for
+      each node.</description>
+
+      <variablelist>
+        <variable id="enabled" type="boolean">
+          <name>Enable DNS</name>
+          <value>true</value>
+          <description>Enable the internal DNS server. The server does
+          not provide reverse resolution and is not a production
+          quality or scalable DNS solution. Use the internal DNS
+          server only for small deployments or for
+          testing.</description>
+        </variable>
+      </variablelist>
+    </category>
+
     <category id="plc_mail">
       <name>Mail</name>
       <description>Many maintenance scripts, as well as the API and
          and warnings.</description>
        </variable>
 
-       <variable id="support_address">
+       <variable id="support_address" type="email">
          <name>Support Address</name>
-         <value>root@localhost</value>
+         <value>root+support@localhost.localdomain</value>
          <description>This address is used for support
          requests. Support requests may include traffic complaints,
          security incident reporting, web site malfunctions, and
          Tracker.</description>
        </variable>
 
-       <variable id="boot_address">
+       <variable id="boot_address" type="email">
          <name>Boot Messages Address</name>
-         <value>root@localhost</value>
+         <value>root+install-msgs@localhost.localdomain</value>
          <description>The API will notify this address when a problem
-         occurs during node installation or boot. If a domain is not
-         specified, the default system domain will be used
-         name.</description>
+         occurs during node installation or boot.</description>
+       </variable>
+
+       <variable id="slice_address" type="email">
+         <name>Slice Address</name>
+         <value>root+SLICE@localhost.localdomain</value>
+         <description>This address template is used for sending
+         e-mail notifications to slices. SLICE will be replaced with
+         the name of the slice.</description>
        </variable>
       </variablelist>
     </category>
 
        <variable id="host" type="hostname">
          <name>Hostname</name>
-         <value>localhost</value>
-         <description>The fully qualified hostname or IP address of
-         the database server. This hostname must be resolvable and
-         reachable by the rest of your installation.</description>
+         <value>localhost.localdomain</value>
+         <description>The fully qualified hostname of the database
+         server.</description>
        </variable>
 
+        <variable id="ip" type="ip">
+          <name>IP Address</name>
+          <value>127.0.0.1</value>
+          <description>The IP address of the database server, if not
+          resolvable by the configured DNS servers.</description>
+        </variable>
+
        <variable id="port" type="int">
          <name>Port</name>
          <value>5432</value>
 
        <variable id="host" type="hostname">
          <name>Hostname</name>
-         <value>localhost</value>
-         <description>The fully qualified hostname or IP address of
-         the API server. This hostname must be resolvable and
-         reachable by the rest of your installation, as well as your
-         nodes.</description>
+         <value>localhost.localdomain</value>
+         <description>The fully qualified hostname of the API
+         server.</description>
        </variable>
 
+        <variable id="ip" type="ip">
+          <name>IP Address</name>
+          <value>127.0.0.1</value>
+          <description>The IP address of the API server, if not
+          resolvable by the configured DNS servers.</description>
+        </variable>
+
        <variable id="port" type="int">
          <name>Port</name>
          <value>80</value>
 
        <variable id="maintenance_user" type="string">
          <name>Maintenance User</name>
-         <value>maint@test.planet-lab.org</value>
+         <value>maint@localhost.localdomain</value>
          <description>The username of the maintenance account. This
          account is used by local scripts that perform automated
          tasks, and cannot be used for normal logins.</description>
 
        <variable id="host" type="hostname">
          <name>Hostname</name>
-         <value>localhost</value>
-         <description>The fully qualified hostname or IP address of
-         the web server. This hostname must be resolvable and
-         reachable by the rest of your installation, as well as your
-         nodes.</description>
+         <value>localhost.localdomain</value>
+         <description>The fully qualified hostname of the web
+         server.</description>
        </variable>
 
+        <variable id="ip" type="ip">
+          <name>IP Address</name>
+          <value>127.0.0.1</value>
+          <description>The IP address of the web server, if not
+          resolvable by the configured DNS servers.</description>
+        </variable>
+
        <variable id="port" type="int">
          <name>Port</name>
          <value>80</value>
 
        <variable id="host" type="hostname">
          <name>Hostname</name>
-         <value>localhost</value>
-         <description>The fully qualified hostname or IP address of
-         the boot server. This hostname must be resolvable and
-         reachable by the rest of your installation, as well as your
-         nodes.</description>
+         <value>localhost.localdomain</value>
+         <description>The fully qualified hostname of the boot
+         server.</description>
        </variable>
 
+        <variable id="ip" type="ip">
+          <name>IP Address</name>
+          <value>127.0.0.1</value>
+          <description>The IP address of the boot server, if not
+          resolvable by the configured DNS servers.</description>
+        </variable>
+
        <variable id="port" type="int">
          <name>Port</name>
          <value>80</value>
        <!-- Basics -->
        <packagereq type="mandatory">dev</packagereq>   
 
+       <!-- kernel-vserver is intended for the vserver-reference, but
+            serves the same useful purpose for MyPLC, namely, to
+            Provide: kernel without actually installing anything. -->
+       <packagereq type="mandatory">kernel-vserver</packagereq>        
+
        <!-- Sending mail -->
        <packagereq type="mandatory">sendmail</packagereq>
        <packagereq type="mandatory">sendmail-cf</packagereq>
 
+       <!-- Caching DNS server -->
+       <packagereq type="mandatory">dnsmasq</packagereq>
+
        <!-- (Optional) Synchronizing with PLC -->
        <packagereq type="mandatory">rsync</packagereq>