The FreeBSD Diary

You may also wish to see the instructions for FrontPage 98.

See also other FrontPage articles especially FrontPage 2000 - installing the extensions.

For this example, we are creating a new virtual web called test.freebsddiary.org.

test                    IN      A       192.168.0.69

You'll notice that the above IP number is not accessible from the internet.  It is a private non-routable address.  It's here on my LAN.

Then I hup'd named, and checked the error logs, just in case.

<VirtualHost 192.168.0.69>
    ServerAdmin         webmaster@freebsddiary.org
    DocumentRoot        /www/test
    ServerName          test.unixathome.org
    ErrorLog            /www/logs/test-error.log
    CustomLog           /www/logs/test-access_log common
</VirtualHost>

Note that the IP address listed above matches the IP address assigned to test.unixathome.org.

Remember to create the directory /www/test.

Then I restarted apache via:

/usr/local/sbin/apachectl restart

# adduser
Use option ``-silent'' if you don't want to see all warnings and
                                                       questions.

Check /etc/shells
Check /etc/master.passwd
Check /etc/group
Enter your default shell: bash csh date no nologin sh [bash]: bash
Your default shell is: bash -> /usr/local/bin/bash
Enter your default HOME partition: [/home]: 
Copy dotfiles from: /usr/share/skel no [/usr/share/skel]: 
Send message from file: /etc/adduser.message no 
[/etc/adduser.message]: 
Use passwords (y/n) [y]: 

Ok, let's go.
Don't worry about mistakes. I will give you the chance later to
                                              correct any input.
Enter username [a-z0-9_-]: susan
Enter full name []: Susan Crinion
Enter shell bash csh date no nologin sh [bash]: 
Enter home directory (full path) [/home/susan]: 
Uid [1009]: 
Enter login class: default []: 
Login group susan [susan]: 
Login group is ``susan''. Invite susan into other groups: guest no
[no]: 
Enter password []: 
Enter password again []: 

Name:     susan
Password: ****
Fullname: Susan Crinion
Uid:      1009
Gid:      1009 (susan)
Class:    
Groups:   susan 
HOME:     /home/susan
Shell:    /usr/local/bin/bash
OK? (y/n) [y]: 
Added user ``susan''
Send message to ``susan'' and: no root second_mail_address 
[no]: 

Susan Crinion,

your account ``susan'' was created.
Have fun!

See also chpass(1), finger(1), passwd(1)

Add anything to default message (y/n) [n]: 
Send message (y/n) [y]: n
Copy files from /usr/share/skel to /home/susan
Add another user? (y/n) [y]: n
Goodbye!

The next step is to create the directories for the web.  In this case, Susan will have a home directory of /home/susan.  In her home directory, she will have a link to the actual website at /www/test.freebsddiary.org.  This link is named public_html.

# mkdir /www/test.freebsddiary.org
# ln -s /www/test.freebsddiary.org/ /home/susan/public_html

Here's what I put in my /usr/local/etc/apache/httpd.conf file to set the permissions on this tree:

<directory "/www">
<Directory "/www">
    Options Indexes FollowSymLinks ExecCGI
    <IfDefine FRONTPAGE>
        AllowOverride AuthConfig Limit Indexes Options
    </IfDefine>
    <IfDefine !FRONTPAGE>
        AllowOverride None
    </IfDefine>
    Order allow,deny
    Allow from all
</Directory>

[root@fred:/usr/local/frontpage/version4.0/bin] # ./fpsrvadm.exe
Type "fpsrvadm -h" for help on command line options

Please enter command:
0) quit
1) install
2) upgrade
3) uninstall
4) check and fix
5) enable authoring
6) disable authoring
7) change security settings
8) recalculate links
9) delete
10) rename
11) set directory executable
12) set directory no executable
13) putfile
14) recalcfile
15) create a subweb
16) merge a subweb into its parent web
17) full uninstall of all FrontPage information
18) chown
Your choice [1]: 

Please enter server type:
0) apache
1) apache-fp
2) ncsa
3) netscape-enterprise
4) netscape-fasttrack
5) stronghold
Your choice [0]: 1
Enter server config filename: /usr/local/etc/apache/httpd.conf
Enter host name for multi-hosting []: test.freebsddiary.org

Starting install, port: test.freebsddiary.org:80, web: "root web"

Enter UNIX username []: susan
Enter UNIX group []: susan

User name to add to FrontPage group "administrators"
                                     [administrator]: testwebsite
Password for user "testwebsite": 
Confirm password: 
Creating web http://test.freebsddiary.org
Chowning Content in service root web
Install completed.

Enter server config filename: /usr/local/etc/apache/httpd.conf Enter host name for multi-hosting []: test.freebsddiary.ort 'test.freebsddiary.ort' server is not a valid virtual server.

I have encountered interesting problems when using include files with httpd.conf.   I was putting my virtual host definitions in a separate file and including them like this:

include /usr/local/etc/apache/vhosts/vhosts.conf

My temporary solution was to not use an include file.  Effective, but inelegant.

Do not use this example.  It is wrong.

# cd /usr/local/frontpage/version4.0/bin
# ./fpsrvadm.exe -o install -t apache-fp    \
     -s /usr/local/etc/apache/httpd.conf    \
     -p 80 -m test.freebsddiary.org         \
     -u testwebsite -p password             \
     -xu susan -wg susan

Starting install, port: password, web: "root web"

Password for user "testwebsite": 
Confirm password: 
Creating web http://test.freebsddiary.org
Chowning Content in service root web

As you can see, it's installing to port "password".  Ooops.  I specified -p for the port and for the password.  Thanks Chuck.

# cd /usr/local/frontpage/version4.0/bin
# ./fpsrvadm.exe -o install -t apache-fp   \
   -s /usr/local/etc/apache/httpd.conf     \
    -port 80 -m testing.mysecretdomain.org \
    -u testuser1 -xu dan -wg dan

Starting install, port: 80, web: "root web"

Password for user "testuser1": 
Confirm password: 
Creating web http://testing.mysecretdomain.org
Chowning Content in service root web
Install completed.

Note that by omitting the password on the command line, you are prompted to enter the password.  I think this is a good security feature of fpsrvadm.exe.  In general, you should not type passwords on the command line as anyone can view the command by using the ps command.

I found I had to shutdown apache.  A simple restart was not enough to get publishing to work.

The user names don't have to be the same.   They don't have to be different.  If you are paranoid, you might make them different.  But it'll be easier for your users, I think, if the names are the same.   But I'd suggest they keep different the passwords different in either case.

# more .htaccess 
# more .htaccess 
# -FrontPage-

IndexIgnore .htaccess */.??* *~ *# */HEADER* */README* */_vti*

<Limit GET POST>
order deny,allow
deny from all
allow from all
</Limit>
<Limit PUT DELETE>
order deny,allow
deny from all
</Limit>
AuthName test.freebsddiary.org
AuthUserFile /www/test.freebsddiary.org/_vti_pvt/service.pwd
AuthGroupFile /www/test.freebsddiary.org/_vti_pvt/service.grp

If you look at the files listed on the last two lines, you'll see some interesting stuff:

# more /www/test.freebsddiary.org/_vti_pvt/service.grp
# -FrontPage-
administrators: testwebsite
authors: 

That's the login id we specifed when adding the FrontPage extensions.  We can see that it is an adminstrator of the website.  This means they can do anything.  We can also use the fpsrvadm commad to add additional adminstrators, authors, etc.   See http://officeupdate.microsoft.com/frontpage/wpp/serk98/admin.htm for more information.

# more /www/test.freebsddiary.org/_vti_pvt/service.pwd
# -FrontPage-
testwebsite:1pWXvqbWr4rx9

This file contains the encrypted passwords for this user.

He found that solution after he encountered an error when trying to install a FP web.  The error said something about FollowSymlinks not being in the right group.  After checking the Apache configuration items and finding the symlinks directive in the all the right places, he dumped the full error message into Google.  Approximately ten minutes of reading and looking, he found the fix.