/* $Id$ */ /* setup.xml part of pfSense (http://www.pfsense.org/) Copyright (C) 2004, 2005 Scott Ullrich All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ 9 1 pfSense Setup Wizard true This wizard will guide you through the initial configuration of pfSense. Next submit conf_mount_rw(); unlink_if_exists('/conf/trigger_initial_wizard'); conf_mount_ro(); 2 General Information On this screen you will set the general pfSense parameters. Hostname input wizardtemp->system->hostname EXAMPLE: myserver ^[a-z0-9.|-]+$ Invalid Hostname Domain input wizardtemp->system->domain EXAMPLE: mydomain.com ^[a-z0-9.|-]+$ Domain name field is invalid Primary DNS Server input system->dnsserver yes 0 ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ Primary DNS Server field is invalid Secondary DNS Server input system->dnsserver 1 ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ Secondary DNS Server field is invalid Override DNS Allow DNS servers to be overridden by DHCP/PPP on WAN checkbox system->dnsallowoverride Next submit 3 Time Server Information Please enter the time, date and time zone. Time server hostname Enter the hostname (FQDN) of the time server. input system->timeservers ^[a-z0-9.|-]+$ Invalid Time Server Field Timezone timezone_select system->timezone Next submit 4 true Configure WAN Interface On this screen we will configure the Wide Area Network information. var selectedItem = 0; if(document.forms[0].ipaddress.value == 'dhcp') { selectedItem = 1; document.forms[0].ipaddress.value = ''; } else if(document.forms[0].ipaddress.value == 'pppoe') { selectedItem = 2; document.forms[0].ipaddress.value = ''; } else if(document.forms[0].ipaddress.value == 'pptp') { selectedItem = 3; document.forms[0].ipaddress.value = ''; } else if(document.forms[0].ipaddress.value == 'ppp' || document.forms[0].ipaddress.value == 'l2tp') { document.forms[0].ipaddress.value = ''; } else { selectedItem = 0; } document.forms[0].selectedtype.selectedIndex = selectedItem; enableitems(selectedItem); SelectedType select true General configuration listtopic true MAC Address interfaces->wan->spoofmac input This field can be used to modify ("spoof") the MAC address of the WAN interface (may be required with some cable connections). Enter a MAC address in the following format: xx:xx:xx:xx:xx:xx or leave blank. ^([0-9a-f]{2}([:-]||$)){6}$ MAC Address field is invalid true MTU input interfaces->wan->mtu If you enter a value in this field, then MSS clamping for TCP connections to the value entered above minus 40 (TCP/IP header size) will be in effect. If you leave this field blank, an MTU of 1492 bytes for PPPoE and 1500 bytes for all other connection types will be assumed. Static IP Configuration listtopic IP Address interfaces->wan->ipaddr input / true ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ IP Address field is invalid true true true Subnet Mask interfaces->wan->subnet subnet_select Gateway wizardtemp->wangateway input ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ Gateway IP Address field is invalid DHCP client configuration listtopic DHCP Hostname input interfaces->wan->dhcphostname The value in this field is sent as the DHCP client identifier and hostname when requesting a DHCP lease. Some ISPs may require this (for client identification). PPPoE configuration listtopic PPPoE Username input wizardtemp->wan->username PPPoE Password input wizardtemp->wan->password PPPoE Service name input Hint: this field can usually be left empty wizardtemp->wan->provider PPPoE Dial on demand Enable Dial-On-Demand mode checkbox This option causes the interface to operate in dial-on-demand mode, allowing you to have a virtual full time connection. The interface is configured, but the actual connection of the link is delayed until qualifying outgoing traffic is detected. wizardtemp->wan->ondemand PPPoE Idle timeout input If no qualifying outgoing packets are transmitted for the specified number of seconds, the connection is brought down. An idle timeout of zero disables this feature. wizardtemp->wan->idletimeout PPTP configuration listtopic PPTP Username input wizardtemp->wan->pptpusername PPTP Password input wizardtemp->wan->pptppassword true PPTP Local IP Address input / wizardtemp->wan->localip ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ PPTP Local IP Address field is invalid true true true pptplocalsubnet wizardtemp->wan->subnet subnet_select PPTP Remote IP Address wizardtemp->wan->gateway input ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ PPTP Remote IP Address field is invalid PPTP Dial on demand Enable Dial-On-Demand mode checkbox wizardtemp->wan->pptpondemand This option causes the interface to operate in dial-on-demand mode, allowing you to have a virtual full time connection. The interface is configured, but the actual connection of the link is delayed until qualifying outgoing traffic is detected. PPTP Idle timeout input wizardtemp->wan->pptpidletimeout If no qualifying outgoing packets are transmitted for the specified number of seconds, the connection is brought down. An idle timeout of zero disables this feature. RFC1918 Networks listtopic true Block RFC1918 Private Networks When set, this option blocks traffic from IP addresses that are reserved for private networks as per RFC 1918 (10/8, 172.16/12, 192.168/16) as well as loopback addresses (127/8). You should generally leave this option turned on, unless your WAN network lies in such a private address space, too. checkbox interfaces->wan->blockpriv Block private networks from entering via WAN Block bogon networks listtopic true Block bogon networks When set, this option blocks traffic from IP addresses that are reserved (but not RFC 1918) or not yet assigned by IANA. Bogons are prefixes that should never appear in the Internet routing table, and obviously should not appear as the source address in any packets you receive. checkbox interfaces->wan->blockbogons Block non-Internet routed networks from entering via WAN Next submit $ppp) { if ($ppp['ptpid'] == "0") { if ((substr($config['interfaces']['wan']['if'],0,5) == "pppoe") || (substr($config['interfaces']['wan']['if'],0,4) == "pptp")) { $oldif = explode(",", $ppp['ports']); $config['interfaces']['wan']['if'] = $oldif[0]; } if ($type == "pppoe" || $type == "pptp") unset($config['ppps']['ppp'][$pppid]); } } } if ($type == "pppoe" || $type == "pptp") { if ($type == "pptp") { $config['wizardtemp']['wan']['username'] = $config['wizardtemp']['wan']['pptpusername']; $config['wizardtemp']['wan']['password'] = $config['wizardtemp']['wan']['pptppassword']; $config['wizardtemp']['wan']['ondemand'] = $config['wizardtemp']['wan']['pptpondemand']; $config['wizardtemp']['wan']['idletimeout'] = $config['wizardtemp']['wan']['pptpidletimeout']; unset($config['wizardtemp']['wan']['pptpusername']); unset($config['wizardtemp']['wan']['pptppassword']); unset($config['wizardtemp']['wan']['pptpondemand']); unset($config['wizardtemp']['wan']['pptpidletimeout']); } $config['wizardtemp']['wan']['password'] = base64_encode($config['wizardtemp']['wan']['password']); $tmp = array(); $tmp['ptpid'] = "0"; $tmp['type'] = $type; $tmp['if'] = $type . "0"; $tmp['ports'] = $config['interfaces']['wan']['if']; $config['ppps']['ppp'][] = array_merge($tmp, $config['wizardtemp']['wan']); unset($tmp); $config['interfaces']['wan']['if'] = $type."0"; } unset($config['wizardtemp']['wan']); ]]> 5 Configure LAN Interface On this screen we will configure the Local Area Network information. LAN IP Address input interfaces->lan->ipaddr Type dhcp if this interface uses DHCP to obtain its IP address. ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ LAN IP Address field is invalid Subnet Mask subnet_select interfaces->lan->subnet Next submit 6 Set Admin WebGUI Password On this screen we will set the admin password, which is used to access the WebGUI and also SSH services if you wish to enable them. Admin Password password Admin Password AGAIN password Next submit if($_POST['adminpassword'] != "") { if($_POST['adminpassword'] == $_POST['adminpasswordagain']) { $admin_user =& getUserEntryByUID(0); local_user_set_password($admin_user, $_POST['adminpassword']); local_user_set($admin_user); write_config(); } else { print_info_box_np("Passwords do not match! Please press back in your browser window and correct."); die; } } 7 Reload configuration true Click 'Reload' to reload pfSense with new changes. If you changed the password, pfSense will ask you to log in again. Reload submit 8 Reload in progress A reload is now in progress. Please wait. <p> <meta http-equiv="refresh" content="60; url=wizard.php?xml=setup_wizard.xml&stepid=8" > <p> The wizard will redirect to the next step once the reload is completed. 9 Wizard completed. 'pfSense') { Header("Location: " . fixup_string("\$myurl")); exit; } ]]> Please consider donating to the project to help us with our overheads costs.

Click here to donate or purchase services offered by the pfSense team.

Click here to continue on to pfSense webConfigurator. ]]>