source: TI05-delivery/trunk/src/bbftp-server-3.2.0/doc/instserver @ 773

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI05-delivery/trunk/src/bbftp-server-3.2.0/doc/instserver
Revision 773, 4.3 KB checked in by spascoe, 14 years ago (diff)

Initial import of bbftp source

Line 
1
2    Configuring the server
3
4   In the bbftpd directory, run:
5   % ./configure
6
7   The configure script accepts the following standard options:
8
9   --prefix=DIR Defines the directory to install BBFTP server
10
11   The configure script accepts the following additional options:
12
13   --with-gzip Enable compression (automatic search + dynamic link)
14   (DEFAULT)
15   --with-gzip=DIR Enable compression where libs are in DIR/lib and
16   includes in DIR/include (static link)
17   --without-gzip Disable compression
18   --with-ssl Enable encryption (automatic search + dynamic link)
19   (DEFAULT)
20   --with-ssl=DIR Enable encryption where libs are in DIR/lib and
21   includes in DIR/include (static link)
22   --with-rfio Enable RFIO interface (automatic search in "/usr/local",
23   static link) (DEFAULT)
24   --with-rfio=DIR Enable RFIO interface where libs are in DIR/lib and
25   includes in DIR/include (static link)
26   --without-rfio Disable RFIO interface
27   --with-afs Use AFS for standard authentication
28   --with-afs=DIR Use AFS for standard authentication where libs are in
29   DIR/lib and includes in DIR/include
30   --without-afs Do not use AFS for standard authentication (DEFAULT)
31   --with-pam Use PAM
32   --without-pam Do not use PAM (DEFAULT)
33   --with-ephemeral-ports-range=RANGE The server will choose data ports
34   in range RANGE, defined as MINPORT:MAXPORT
35   --without-ephemeral-ports-range The server will choose data ports in
36   the system-dependent default range (DEFAULT)
37   --enable-authentication=private Use the private authentication module
38   --enable-authentication=certificates Use the certificate
39   authentication module
40
41   The following options should be used in certificate mode only:
42
43   --with-gsi=DIR Defines where to find the Globus GSI software
44   (DEFAULT=$GLOBUS_LOCATION or "/opt/globus", static link)
45   --with-x509-user-cert=FILE Defines where to find the host certificate
46   (DEFAULT=/etc/grid-security/hostcert.pem)
47   --with-x509-user-key=FILE Defines where to find the host private key
48   (DEFAULT=/etc/grid-security/hostkey.pem)
49   --with-x509-cert-dir=DIR Defines where to find the CA certificates
50   (DEFAULT=/etc/grid-security/certificates)
51   --with-gridmap=FILE Defines where to find the gridmap file
52   (DEFAULT=/etc/grid-security/grid-mapfile)
53
54    Building the server
55
56   In the bbftpd directory, run:
57   % make
58
59    Installing the server
60
61   In the bbftpd directory, run:
62   % make install
63
64    Configuration
65
66   It is possible to make the daemon start with options defined in a
67   configuration file. This file is /etc/bbftpd.conf. The syntax is the
68   same of the configuration file for client users (.bbftprc). Available
69   options are described in the BBFTPD man page
70
71    Post installation
72
73   If you have chosen to run the server through inetd
74     * Add the line
75       bbftp    CONTROLPORT/tcp
76       in your /etc/services file where CONTROLPORT is the number you
77       have set in the includes/config.h (usually 5021)
78     * Add the line
79       bbftp stream tcp nowait root ${bindir}/bbftpd bbftpd
80       in the /etc/inetd.conf
81
82   If your system authentication is PAM
83
84     * If you have a /etc/pam.conf file
85          + Verify the lines begining by other auth and other account
86            allow login. If it is not the case add special lines for
87            bbftp. The lines to be added will look like:
88            bbftp auth required /lib/security/pam_pwdb.so shadow nullok
89            bbftp account required /lib/security/pam_pwdb.so
90
91     * If you have a /etc/pam.d directory
92          + Verify the file other and allow login. If it is not the case
93            create a new file called bbftp which will contain two lines
94            looking like:
95            auth required /lib/security/pam_pwdb.so shadow nullok
96            account required /lib/security/pam_pwdb.so
97
98   The name of the PAM library may change.
99
100   If you have chosen to run the server as a daemon
101     * Modify the script ${prefix}/etc/bbftpd to add the options you need
102       and to change the values of the GSI variables if you did not use
103       the --with-x509 options during the configuration process.
104     * To start the daemon run:
105       ${prefix}/etc/bbftpd start
106     * To stop the daemon, run:
107       ${prefix}/etc/bbftpd stop
108     * To restart the daemon (stop and start), run:
109       ${prefix}/etc/bbftpd restart
110     * To see the daemon's status, run:
111       ${prefix}/etc/bbftpd status
Note: See TracBrowser for help on using the repository browser.