X-Git-Url: http://git.rot13.org/?p=BackupPC.git;a=blobdiff_plain;f=configure.pl;h=ec63ebbd8dcfdfedffbb7e8e08753eeba90f5052;hp=1fea712f427e42ef676a5555276c3a90f23b45b4;hb=17dcbbebb871212f90b81bb97f8d1feb528bdc43;hpb=8d7768574bb328c669a44c6efbff01e8a7e93d7e diff --git a/configure.pl b/configure.pl index 1fea712..ec63ebb 100755 --- a/configure.pl +++ b/configure.pl @@ -9,13 +9,17 @@ # # perl configure.pl # +# To read about the command-line options for this configure script: +# +# perldoc configure.pl +# # The installation steps are described as the script runs. # # AUTHOR # Craig Barratt # # COPYRIGHT -# Copyright (C) 2001-2003 Craig Barratt +# Copyright (C) 2001-2004 Craig Barratt # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -33,7 +37,7 @@ # #======================================================================== # -# Version 2.0.0_CVS, released 18 Jan 2003. +# Version 2.1.0beta1, released 9 Apr 2004. # # See http://backuppc.sourceforge.net. # @@ -44,13 +48,27 @@ no utf8; use vars qw(%Conf %OrigConf); use lib "./lib"; -my @Packages = qw(ExtUtils::MakeMaker File::Path File::Spec File::Copy - DirHandle Digest::MD5 Data::Dumper Getopt::Std - BackupPC::Lib BackupPC::FileZIO); +my @Packages = qw(File::Path File::Spec File::Copy DirHandle Digest::MD5 + Data::Dumper Getopt::Std Getopt::Long Pod::Usage + BackupPC::Lib BackupPC::FileZIO); foreach my $pkg ( @Packages ) { eval "use $pkg"; next if ( !$@ ); + if ( $pkg =~ /BackupPC/ ) { + die < 0, -verbose => 2) if $opts{man}; + +my $DestDir = $opts{"dest-dir"}; + if ( $< != 0 ) { print < Do you want to continue?", "y") =~ /y/i; + exit(1) if ( prompt("--> Do you want to continue?", + "y") !~ /y/i ); + exit(1) if ( $opts{batch} && !$opts{"uid-ignore"} ); } print < Full path to existing conf/config.pl", - $ConfigPath); + $ConfigPath, + "config-path"); last if ( $ConfigPath eq "" || ($ConfigPath =~ /^\// && -r $ConfigPath && -w $ConfigPath) ); my $problem = "is not an absolute path"; @@ -95,6 +140,10 @@ while ( 1 ) { $problem = "is not readable" if ( !-r $ConfigPath ); $problem = "doesn't exist" if ( !-f $ConfigPath ); print("The file '$ConfigPath' $problem.\n"); + if ( $opts{batch} ) { + print("Need to specify a valid --config-path for upgrade\n"); + exit(1); + } } my $bpc; if ( $ConfigPath ne "" && -r $ConfigPath ) { @@ -104,7 +153,7 @@ if ( $ConfigPath ne "" && -r $ConfigPath ) { %Conf = $bpc->Conf(); %OrigConf = %Conf; $Conf{TopDir} = $topDir; - my $err = $bpc->ServerConnect($Conf{ServerHost}, $Conf{ServerPort}, 1); + my $err = $bpc->ServerConnect($Conf{ServerHost}, $Conf{ServerPort}, 1); if ( $err eq "" ) { print < "PerlPath", - 'gtar/tar' => "TarClientPath", - smbclient => "SmbClientPath", - nmblookup => "NmbLookupPath", - rsync => "RsyncClientPath", - ping => "PingPath", - df => "DfPath", - 'ssh/ssh2' => "SshPath", - sendmail => "SendmailPath", - hostname => "HostnamePath", + perl => "PerlPath", + 'gtar/tar' => "TarClientPath", + smbclient => "SmbClientPath", + nmblookup => "NmbLookupPath", + rsync => "RsyncClientPath", + ping => "PingPath", + df => "DfPath", + 'ssh/ssh2' => "SshPath", + sendmail => "SendmailPath", + hostname => "HostnamePath", + split => "SplitPath", + par2 => "ParPath", + cat => "CatPath", + gzip => "GzipPath", + bzip2 => "Bzip2Path", ); foreach my $prog ( sort(keys(%Programs)) ) { my $path; foreach my $subProg ( split(/\//, $prog) ) { - $path ||= FindProgram("$ENV{PATH}:/bin:/usr/bin:/sbin:/usr/sbin", - $subProg); + $path = FindProgram("$ENV{PATH}:/bin:/usr/bin:/sbin:/usr/sbin", + $subProg) if ( !length($path) ); } - $Conf{$Programs{$prog}} ||= $path; + $Conf{$Programs{$prog}} = $path if ( !length($Conf{$Programs{$prog}}) ); } while ( 1 ) { @@ -149,7 +203,7 @@ I found the following locations for these programs: EOF foreach my $prog ( sort(keys(%Programs)) ) { - printf(" %-11s => %s\n", $prog, $Conf{$Programs{$prog}}); + printf(" %-12s => %s\n", $prog, $Conf{$Programs{$prog}}); } print "\n"; last if (prompt('--> Are these paths correct?', 'y') =~ /^y/i); @@ -180,7 +234,9 @@ Please tell me the hostname of the machine that BackupPC will run on. EOF chomp($Conf{ServerHost} = `$Conf{HostnamePath}`) if ( defined($Conf{HostnamePath}) && !defined($Conf{ServerHost}) ); -$Conf{ServerHost} = prompt("--> BackupPC will run on host", $Conf{ServerHost}); +$Conf{ServerHost} = prompt("--> BackupPC will run on host", + $Conf{ServerHost}, + "hostname"); print < BackupPC should run as user", - $Conf{BackupPCUser} || "backuppc"); + $Conf{BackupPCUser} || "backuppc", + "username"); ($name, $passwd, $Uid, $Gid) = getpwnam($Conf{BackupPCUser}); last if ( $name ne "" ); print < Install directory (full path)", - $Conf{InstallDir}); + $Conf{InstallDir}, + "install-dir"); last if ( $Conf{InstallDir} =~ /^\// ); + if ( $opts{batch} ) { + print("Need to specify --install-dir for new installation\n"); + exit(1); + } } print < Data directory (full path)", $Conf{TopDir}); + $Conf{TopDir} = prompt("--> Data directory (full path)", + $Conf{TopDir}, + "data-dir"); last if ( $Conf{TopDir} =~ /^\// ); + if ( $opts{batch} ) { + print("Need to specify --data-dir for new installation\n"); + exit(1); + } } if ( !defined($Conf{CompressLevel}) ) { @@ -313,8 +382,14 @@ Leave this path empty if you don't want to install the CGI interface. EOF while ( 1 ) { - $Conf{CgiDir} = prompt("--> CGI bin directory (full path)", $Conf{CgiDir}); + $Conf{CgiDir} = prompt("--> CGI bin directory (full path)", + $Conf{CgiDir}, + "cgi-dir"); last if ( $Conf{CgiDir} =~ /^\// || $Conf{CgiDir} eq "" ); + if ( $opts{batch} ) { + print("Need to specify --cgi-dir for new installation\n"); + exit(1); + } } if ( $Conf{CgiDir} ne "" ) { @@ -334,13 +409,23 @@ The URL for the image directory should start with a slash. EOF while ( 1 ) { $Conf{CgiImageDir} = prompt("--> Apache image directory (full path)", - $Conf{CgiImageDir}); + $Conf{CgiImageDir}, + "html-dir"); last if ( $Conf{CgiImageDir} =~ /^\// ); + if ( $opts{batch} ) { + print("Need to specify --html-dir for new installation\n"); + exit(1); + } } while ( 1 ) { $Conf{CgiImageDirURL} = prompt("--> URL for image directory (omit http://host; starts with '/')", - $Conf{CgiImageDirURL}); + $Conf{CgiImageDirURL}, + "html-dir-url"); last if ( $Conf{CgiImageDirURL} =~ /^\// ); + if ( $opts{batch} ) { + print("Need to specify --html-dir-url for new installation\n"); + exit(1); + } } } @@ -360,15 +445,21 @@ exit unless prompt("--> Do you want to continue?", "y") =~ /y/i; # # Create install directories # -foreach my $dir ( qw(bin lib/BackupPC/Xfer lib/BackupPC/Zip - lib/BackupPC/Lang doc) ) { - next if ( -d "$Conf{InstallDir}/$dir" ); - mkpath("$Conf{InstallDir}/$dir", 0, 0775); - if ( !-d "$Conf{InstallDir}/$dir" - || !chown($Uid, $Gid, "$Conf{InstallDir}/$dir") ) { - die("Failed to create or chown $Conf{InstallDir}/$dir\n"); +foreach my $dir ( qw(bin doc + lib/BackupPC/CGI + lib/BackupPC/Config + lib/BackupPC/Lang + lib/BackupPC/Storage + lib/BackupPC/Xfer + lib/BackupPC/Zip + ) ) { + next if ( -d "$DestDir$Conf{InstallDir}/$dir" ); + mkpath("$DestDir$Conf{InstallDir}/$dir", 0, 0775); + if ( !-d "$DestDir$Conf{InstallDir}/$dir" + || !chown($Uid, $Gid, "$DestDir$Conf{InstallDir}/$dir") ) { + die("Failed to create or chown $DestDir$Conf{InstallDir}/$dir\n"); } else { - print("Created $Conf{InstallDir}/$dir\n"); + print("Created $DestDir$Conf{InstallDir}/$dir\n"); } } @@ -376,12 +467,12 @@ foreach my $dir ( qw(bin lib/BackupPC/Xfer lib/BackupPC/Zip # Create CGI image directory # foreach my $dir ( ($Conf{CgiImageDir}) ) { - next if ( $dir eq "" || -d $dir ); - mkpath($dir, 0, 0775); - if ( !-d $dir || !chown($Uid, $Gid, $dir) ) { - die("Failed to create or chown $dir"); + next if ( $dir eq "" || -d "$DestDir$dir" ); + mkpath("$DestDir$dir", 0, 0775); + if ( !-d "$DestDir$dir" || !chown($Uid, $Gid, "$DestDir$dir") ) { + die("Failed to create or chown $DestDir$dir"); } else { - print("Created $dir\n"); + print("Created $DestDir$dir\n"); } } @@ -389,68 +480,113 @@ foreach my $dir ( ($Conf{CgiImageDir}) ) { # Create $TopDir's top-level directories # foreach my $dir ( qw(. conf pool cpool pc trash log) ) { - mkpath("$Conf{TopDir}/$dir", 0, 0750) if ( !-d "$Conf{TopDir}/$dir" ); - if ( !-d "$Conf{TopDir}/$dir" - || !chown($Uid, $Gid, "$Conf{TopDir}/$dir") ) { - die("Failed to create or chown $Conf{TopDir}/$dir\n"); + mkpath("$DestDir$Conf{TopDir}/$dir", 0, 0750) if ( !-d "$DestDir$Conf{TopDir}/$dir" ); + if ( !-d "$DestDir$Conf{TopDir}/$dir" + || !chown($Uid, $Gid, "$DestDir$Conf{TopDir}/$dir") ) { + die("Failed to create or chown $DestDir$Conf{TopDir}/$dir\n"); } else { - print("Created $Conf{TopDir}/$dir\n"); + print("Created $DestDir$Conf{TopDir}/$dir\n"); } } -printf("Installing binaries in $Conf{InstallDir}/bin\n"); +printf("Installing binaries in $DestDir$Conf{InstallDir}/bin\n"); foreach my $prog ( qw(BackupPC BackupPC_dump BackupPC_link BackupPC_nightly BackupPC_sendEmail BackupPC_tarCreate BackupPC_trashClean BackupPC_tarExtract BackupPC_compressPool BackupPC_zcat + BackupPC_archive BackupPC_archiveHost BackupPC_restore BackupPC_serverMesg BackupPC_zipCreate ) ) { - InstallFile("bin/$prog", "$Conf{InstallDir}/bin/$prog", 0555); + InstallFile("bin/$prog", "$DestDir$Conf{InstallDir}/bin/$prog", 0555); } -# -# Remove unused binaries from older versions -# -unlink("$Conf{InstallDir}/bin/BackupPC_queueAll"); - -printf("Installing library in $Conf{InstallDir}/lib\n"); -foreach my $lib ( qw(BackupPC/Lib.pm BackupPC/FileZIO.pm BackupPC/Attrib.pm - BackupPC/PoolWrite.pm BackupPC/View.pm BackupPC/Xfer/Tar.pm - BackupPC/Xfer/Smb.pm BackupPC/Xfer/Rsync.pm - BackupPC/Xfer/RsyncFileIO.pm BackupPC/Zip/FileMember.pm - BackupPC/Lang/en.pm BackupPC/Lang/fr.pm BackupPC/Lang/es.pm +printf("Installing library in $DestDir$Conf{InstallDir}/lib\n"); +foreach my $lib ( qw( + BackupPC/Lib.pm + BackupPC/Attrib.pm + BackupPC/FileZIO.pm + BackupPC/Config.pm + BackupPC/PoolWrite.pm + BackupPC/Storage.pm + BackupPC/View.pm + BackupPC/CGI/AdminOptions.pm + BackupPC/CGI/Archive.pm + BackupPC/CGI/ArchiveInfo.pm + BackupPC/CGI/Browse.pm + BackupPC/CGI/DirHistory.pm + BackupPC/CGI/EmailSummary.pm + BackupPC/CGI/GeneralInfo.pm + BackupPC/CGI/HostInfo.pm + BackupPC/CGI/Lib.pm + BackupPC/CGI/LOGlist.pm + BackupPC/CGI/Queue.pm + BackupPC/CGI/ReloadServer.pm + BackupPC/CGI/RestoreFile.pm + BackupPC/CGI/RestoreInfo.pm + BackupPC/CGI/Restore.pm + BackupPC/CGI/StartServer.pm + BackupPC/CGI/StartStopBackup.pm + BackupPC/CGI/StopServer.pm + BackupPC/CGI/Summary.pm + BackupPC/CGI/View.pm + BackupPC/Config/Meta.pm + BackupPC/Lang/en.pm + BackupPC/Lang/fr.pm + BackupPC/Lang/es.pm BackupPC/Lang/de.pm + BackupPC/Lang/it.pm + BackupPC/Lang/nl.pm + BackupPC/Lang/pt_br.pm + BackupPC/Storage/Text.pm + BackupPC/Xfer/Archive.pm + BackupPC/Xfer/Tar.pm + BackupPC/Xfer/Smb.pm + BackupPC/Xfer/Rsync.pm + BackupPC/Xfer/RsyncDigest.pm + BackupPC/Xfer/RsyncFileIO.pm + BackupPC/Zip/FileMember.pm ) ) { - InstallFile("lib/$lib", "$Conf{InstallDir}/lib/$lib", 0444); + InstallFile("lib/$lib", "$DestDir$Conf{InstallDir}/lib/$lib", 0444); } if ( $Conf{CgiImageDir} ne "" ) { - printf("Installing images in $Conf{CgiImageDir}\n"); + printf("Installing images in $DestDir$Conf{CgiImageDir}\n"); foreach my $img ( ) { (my $destImg = $img) =~ s{^images/}{}; - InstallFile($img, "$Conf{CgiImageDir}/$destImg", 0444, 1); + InstallFile($img, "$DestDir$Conf{CgiImageDir}/$destImg", 0444, 1); + } + + # + # Install new CSS file, making a backup copy if necessary + # + my $cssBackup = "$DestDir$Conf{CgiImageDir}/BackupPC_stnd.css.pre-__VERSION__"; + if ( -f "$DestDir$Conf{CgiImageDir}/BackupPC_stnd.css" && !-f $cssBackup ) { + rename("$DestDir$Conf{CgiImageDir}/BackupPC_stnd.css", $cssBackup); } + InstallFile("conf/BackupPC_stnd.css", + "$DestDir$Conf{CgiImageDir}/BackupPC_stnd.css", 0444, 0); } printf("Making init.d scripts\n"); foreach my $init ( qw(gentoo-backuppc gentoo-backuppc.conf linux-backuppc - solaris-backuppc debian-backuppc suse-backuppc) ) { + solaris-backuppc debian-backuppc suse-backuppc + slackware-backuppc ) ) { InstallFile("init.d/src/$init", "init.d/$init", 0444); } -printf("Installing docs in $Conf{InstallDir}/doc\n"); +printf("Installing docs in $DestDir$Conf{InstallDir}/doc\n"); foreach my $doc ( qw(BackupPC.pod BackupPC.html) ) { - InstallFile("doc/$doc", "$Conf{InstallDir}/doc/$doc", 0444); + InstallFile("doc/$doc", "$DestDir$Conf{InstallDir}/doc/$doc", 0444); } -printf("Installing config.pl and hosts in $Conf{TopDir}/conf\n"); -InstallFile("conf/hosts", "$Conf{TopDir}/conf/hosts", 0644) - if ( !-f "$Conf{TopDir}/conf/hosts" ); +printf("Installing config.pl and hosts in $DestDir$Conf{TopDir}/conf\n"); +InstallFile("conf/hosts", "$DestDir$Conf{TopDir}/conf/hosts", 0644) + if ( !-f "$DestDir$Conf{TopDir}/conf/hosts" ); # # Now do the config file. If there is an existing config file we # merge in the new config file, adding any new configuration # parameters and deleting ones that are no longer needed. # -my $dest = "$Conf{TopDir}/conf/config.pl"; +my $dest = "$DestDir$Conf{TopDir}/conf/config.pl"; my ($newConf, $newVars) = ConfigParse("conf/config.pl"); my ($oldConf, $oldVars); if ( -f $dest ) { @@ -491,6 +627,41 @@ if ( defined($Conf{SmbClientArgs}) ) { delete($Conf{SmbClientArgs}); } +# +# CSS is now stored in a file rather than a big config variable. +# +delete($Conf{CSSstylesheet}); + +# +# The blackout timing settings are now stored in a list of hashes, rather +# than three scalar parameters. +# +if ( defined($Conf{BlackoutHourBegin}) ) { + $Conf{BlackoutPeriods} = [ + { + hourBegin => $Conf{BlackoutHourBegin}, + hourEnd => $Conf{BlackoutHourEnd}, + weekDays => $Conf{BlackoutWeekDays}, + } + ]; + delete($Conf{BlackoutHourBegin}); + delete($Conf{BlackoutHourEnd}); + delete($Conf{BlackoutWeekDays}); +} + +# +# $Conf{RsyncLogLevel} has been replaced by $Conf{XferLogLevel} +# +if ( defined($Conf{RsyncLogLevel}) ) { + $Conf{XferLogLevel} = $Conf{RsyncLogLevel}; + delete($Conf{RsyncLogLevel}); +} + +# +# In 2.1.0 the default for $Conf{CgiNavBarAdminAllHosts} is now 1 +# +$Conf{CgiNavBarAdminAllHosts} = 1; + # # IncrFill should now be off # @@ -505,7 +676,7 @@ if ( defined($Conf{PingArgs}) ) { if ( $^O eq "solaris" || $^O eq "sunos" ) { $Conf{PingCmd} = '$pingPath -s $host 56 1'; } elsif ( ($^O eq "linux" || $^O eq "openbsd" || $^O eq "netbsd") - && !system("$Conf{PingClientPath} -c 1 -w 3 localhost") ) { + && !system("$Conf{PingPath} -c 1 -w 3 localhost") ) { $Conf{PingCmd} = '$pingPath -c 1 -w 3 $host'; } else { $Conf{PingCmd} = '$pingPath -c 1 $host'; @@ -569,9 +740,9 @@ if ( !defined($oldConf) ) { } if ( $Conf{CgiDir} ne "" ) { - printf("Installing cgi script BackupPC_Admin in $Conf{CgiDir}\n"); - mkpath("$Conf{CgiDir}", 0, 0755); - InstallFile("cgi-bin/BackupPC_Admin", "$Conf{CgiDir}/BackupPC_Admin", + printf("Installing cgi script BackupPC_Admin in $DestDir$Conf{CgiDir}\n"); + mkpath("$DestDir$Conf{CgiDir}", 0, 0755); + InstallFile("cgi-bin/BackupPC_Admin", "$DestDir$Conf{CgiDir}/BackupPC_Admin", 04554); } @@ -596,23 +767,33 @@ will need to do: - BackupPC should be ready to start. Don't forget to run it as user $Conf{BackupPCUser}! The installation also contains an init.d/backuppc script that can be copied to /etc/init.d - so that BackupPC can auto-start on boot. See init.d/README. + so that BackupPC can auto-start on boot. This will also enable + administrative users to start the server from the CGI interface. + See init.d/README. Enjoy! EOF -if ( $ENV{LANG} =~ /utf/i && $^V ge v5.8.0 ) { +if ( `$Conf{PerlPath} -V` =~ /uselargefiles=undef/ ) { print <= 2.0.1). + # + print OUT "#!$Conf{PerlPath}\n"; } else { print OUT; } @@ -675,10 +848,15 @@ sub InstallFile sub FindProgram { my($path, $prog) = @_; + + if ( defined($opts{"bin-path"}{$prog}) ) { + return $opts{"bin-path"}{$prog}; + } foreach my $dir ( split(/:/, $path) ) { my $file = File::Spec->catfile($dir, $prog); return $file if ( -x $file ); } + return; } sub ConfigParse @@ -689,8 +867,9 @@ sub ConfigParse my($out, @conf, $var); my $comment = 1; my $allVars = {}; + my $endLine = undef; while ( ) { - if ( /^#/ ) { + if ( /^#/ && !defined($endLine) ) { if ( $comment ) { $out .= $_; } else { @@ -718,7 +897,10 @@ sub ConfigParse $out .= $_; } $var = $1; + $endLine = $1 if ( /^\s*\$Conf\{[^}]*} *= *<<(.*);/ ); + $endLine = $1 if ( /^\s*\$Conf\{[^}]*} *= *<<'(.*)';/ ); } else { + $endLine = undef if ( defined($endLine) && /^\Q$endLine[\n\r]*$/ ); $out .= $_; } } @@ -771,3 +953,189 @@ sub ConfigMerge } return $res; } + +sub prompt +{ + my($question, $default, $option) = @_; + + $default = $opts{$option} if ( defined($opts{$option}) ); + if ( $opts{batch} ) { + print("$question [$default]\n"); + return $default; + } + print("$question [$default]? "); + my $reply = ; + $reply =~ s/[\n\r]*//g; + return $reply if ( $reply !~ /^$/ ); + return $default; +} + +__END__ + +=head1 SYNOPSIS + +configure.pl [options] + +=head1 DESCRIPTION + +configure.pl is a script that is used to install or upgrade a BackupPC +installation. It is usually run interactively without arguments. It +also supports a batch mode where all the options can be specified +via the command-line. + +For upgrading BackupPC you need to make sure that BackupPC is not +running prior to running BackupPC. + +Typically configure.pl needs to run as the super user (root). + +=head1 OPTIONS + +=over 8 + +=item B<--batch> + +Run configure.pl in batch mode. configure.pl will run without +prompting the user. The other command-line options are used +to specify the settings that the user is usually prompted for. + +=item B<--bin-path PROG=PATH> + +Specify the path for various external programs that BackupPC +uses. Several --bin-path options may be specified. configure.pl +usually finds sensible defaults based on searching the PATH. +The format is: + + --bin-path PROG=PATH + +where PROG is one of perl, tar, smbclient, nmblookup, rsync, ping, +df, ssh, sendmail, hostname, split, par2, cat, gzip, bzip2 and +PATH is that full path to that program. + +Examples + + --bin-path cat=/bin/cat --bin-path bzip2=/home/user/bzip2 + +=item B<--config-path CONFIG_PATH> + +Path to the existing config.pl configuration file for BackupPC. +This option should be specified for batch upgrades to an +existing installation. The option should be omitted when +doing a batch new install. + +=item B<--cgi-dir CGI_DIR> + +Path to Apache's cgi-bin directory where the BackupPC_Admin +script will be installed. This option only needs to be +specified for a batch new install. + +=item B<--data-dir DATA_DIR> + +Path to the BackupPC data directory. This is where all the backup +data is stored, and it should be on a large file system. This option +only needs to be specified for a batch new install. + +Example: + + --data-dir /data/BackupPC + +=item B<--dest-dir DEST_DIR> + +An optional prefix to apply to all installation directories. +Usually this is not needed, but certain auto-installers like +to stage an install in a temporary directory, and then copy +the files to their real destination. This option can be used +to specify the temporary directory prefix. Note that if you +specify this option, BackupPC won't run correctly if you try +to run it from below the --dest-dir directory, since all the +paths are set assuming BackupPC is installed in the intended +final locations. + +=item B<--help|?> + +Print a brief help message and exits. + +=item B<--hostname HOSTNAME> + +Host name (this machine's name) on which BackupPC is being installed. +This option only needs to be specified for a batch new install. + +=item B<--html-dir HTML_DIR> + +Path to an Apache html directory where various BackupPC image files +and the CSS files will be installed. This is typically a directory +below Apache's DocumentRoot directory. This option only needs to be +specified for a batch new install. + +Example: + + --html-dir /usr/local/apache/htdocs/BackupPC + +=item B<--html-dir-url URL> + +The URL (without http://hostname) required to access the BackupPC html +directory specified with the --html-dir option. This option only needs +to be specified for a batch new install. + +Example: + + --html-dir-url /BackupPC + +=item B<--install-dir INSTALL_DIR> + +Installation directory for BackupPC scripts, libraries, and +documentation. This option only needs to be specified for a +batch new install. + +Example: + + --install-dir /usr/local/BackupPC + +=item B<--man> + +Prints the manual page and exits. + +=item B<--uid-ignore> + +configure.pl verifies that the script is being run as the super user +(root). Without the --uid-ignore option, in batch mode the script will +exit with an error if not run as the super user, and in interactive mode +the user will be prompted. Specifying this option will cause the script +to continue even if the user id is not root. + +=head1 EXAMPLES + +For a standard interactive install, run without arguments: + + configure.pl + +For a batch new install you need to specify answers to all the +questions that are normally prompted: + + configure.pl \ + --batch \ + --cgi-dir /var/www/cgi-bin/BackupPC \ + --data-dir /data/BackupPC \ + --hostname myHost \ + --html-dir /var/www/html/BackupPC \ + --html-dir-url /BackupPC \ + --install-dir /usr/local/BackupPC + +For a batch upgrade, you only need to specify the path to the +configuration file: + + configure.pl --batch --config-path /data/BackupPC/conf/config.pl + +=head1 AUTHOR + +Craig Barratt + +=head1 COPYRIGHT + +Copyright (C) 2001-2004 Craig Barratt. + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +=cut