/* $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.
*/
81pfSense Setup WizardtrueThis wizard will guide you through the initial configuration of pfSense.Nextsubmit
conf_mount_rw();
unlink_if_exists('/conf/trigger_initial_wizard');
conf_mount_ro();
2General InformationOn this screen you will set the General pfSense parameters.Hostnameinputsystem->hostnameEXAMPLE: myserverDomaininputsystem->domainEXAMPLE: mydomain.com^[a-z0-9.|-]+$Domain name field is invalidPrimary DNS Serverinputsystem->dnsserveryes0Secondary DNS Serverinputsystem->dnsserver1Nextsubmit3Time Server InformationPlease enter the time, date and time zone.Time server dns nameEnter the name of the time server.inputsystem->timeserversTimezonetimezone_selectsystem->timezoneNextsubmit4trueConfigure WAN InterfaceOn 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 == 'BigPond') {
selectedItem = 4;
document.forms[0].ipaddress.value = '';
} else {
selectedItem = 0;
}
document.forms[0].selectedtype.selectedIndex = selectedItem;
enableitems(selectedItem);
SelectedTypeselecttrueGeneral configurationlisttopictrueMAC Addressinterfaces->wan->spoofmacinput 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 blanktrueMTUinputinterfaces->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 ConfigurationlisttopicIP Addressinterfaces->wan->ipaddrinput / truetruetruetrueSubnet Maskinterfaces->wan->subnetsubnet_selectGatewayinterfaces->wan->gatewayinputDHCP client configurationlisttopicDHCP Hostnameinputinterfaces->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 configurationlisttopicPPPoE Usernameinputpppoe->usernamePPPoE Passwordinputpppoe->passwordPPPoE Service nameinputHint: this field can usually be left emptyPPPoE Dial on demandEnable Dial-On-Demand modecheckboxThis 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.PPPoE Idle timeoutinputIf 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.PPTP configurationlisttopicPPTP Usernameinputpptp->usernamePPTP Passwordinputpptp->passwordtruePPTP Local IP Addressinput / pptp->localtruetruetruepptplocalsubnetpptp->subnetsubnet_selectPPTP Remote IP Addresspptp->remoteinputPPTP Dial on demandEnable Dial-On-Demand modecheckboxpptp->ondemandThis 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 timeoutinputpptp->timeoutIf 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 NetworkslisttopictrueBlock 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.checkboxinterfaces->wan->blockprivBlock private networks from entering via WANBlock bogon networkslisttopictrueBlock bogon networksBlock 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.checkboxinterfaces->wan->blockbogonsBlock non-Internet routed networks from entering via WANNextsubmit
if($_POST['selectedtype'] == "Static") { } else {
$_POST['ipaddress'] = $_POST['selectedtype'];
$config['interfaces']['wan']['ipaddr'] = $_POST['selectedtype'];
write_config();
}
5Configure LAN InterfaceOn this screen we will configure the Local Area Network information.LAN IP Addressinputinterfaces->lan->ipaddrType dhcp if this interface uses dhcp to obtain its ip address.Subnet Masksubnet_selectinterfaces->lan->subnetNextsubmit
$ft = split("\.", $_POST['lanipaddress']);
$ft_ip = $ft[0] . "." . $ft[1] . "." . $ft[2] . ".";
$config['dhcpd']['lan']['range']['from'] = $ft_ip . "10";
$highestip = gen_subnet_max($_POST['lanipaddress'], $config['interfaces']['lan']['subnet']);
$hi = split("\.", $highestip);
$highestip = $hi[3]-10;
$config['dhcpd']['lan']['range']['to'] = $ft_ip . $highestip;
6Set Admin WebGUI PasswordOn this screen we will set the Admin password which is used to access the WebGUI and also SSH services if you wish to enable.Admin PasswordpasswordAdmin Password AGAINpasswordNextsubmit
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;
}
}
7Reload configurationtrueClick 'Reload' to reload pfSense with new changes. If you changed the password, pfSense will ask you to log in again.Reloadsubmit8Reload in progressA reload is now in progress. Please wait. <p> The system will automatically try to access $myurl in 120 seconds. <p> You can click on the icon above to access the site more quickly.
<meta http-equiv="refresh" content="60; url=$myurl" >
reload_all();