Nvidia FreeBSD Server, FreeBSD v2 Server User Manual
Nvision.com, Inc.
FreeBSD Server to FreeBSD v2
Server
Self Migration Process
for FreeBSD v2 Server Administrators
First Edition
September, 2003
Nvision.com, Inc. Migrating from a FreeBSD Server to a FreeBSD v2 Server
Table of Contents
Introduction .................................................................................................................................................................1
Starting the Shadow Process....................................................................................................................................... 1
Creating Users .............................................................................................................................................................1
Adding Virtual Hosts and Other Apache Changes...................................................................................................1
Migrating Sendmail and Mail programs...................................................................................................................3
Vinstalling Additional Add-ons.................................................................................................................................. 5
Perl Modules...............................................................................................................................................................5
Migrating Databases....................................................................................................................................................6
Moving Your Custom Digital Certificate ..................................................................................................................7
Migrating Time-Sensitive Material............................................................................................................................ 8
Document Conventions .............................................................................................................................................10
Table of Contents
ii
Nvision.com, Inc. Migrating from a FreeBSD Server to a FreeBSD v2 Server
Introduction
The shadow process for a FreeBSD Server to a FreeBSD v2 Server is meant to be a selfmigration for users with VPS experience. This document does not explain the differences
between a FreeBSD Server and a FreeBSD v2 Server. However, this document steps you
through the basics of how to migrate your FreeBSD Server to a FreeBSD v2 Server.
If you have made significant changes to your FreeBSD Server, this document may not be
helpful.
The FreeBSD Server to FreeBSD v2 Server migration process takes several hours, maybe
even days, depending on your knowledge of the FreeBSD Server and FreeBSD v2 Servers,
and the amount of changes you have made to a standard FreeBSD Server server.
Starting the Shadow Process
The Shadow process creates a new FreeBSD v2 Server account with same account owner (the
administrative user) and a root user. The root and account owner passwords will be the same
as the FreeBSD Server account owners. The following files and directories are created on
your new FreeBSD v2 Server:
• /.migrate – directory
• /.migrate/bin – directory
• /.migrate/accountname – directory containing copy of file system from old account
• /.migrate/bin/addaccounts.pl – file for creating user accounts
• /.migrate/bin/migratesm – file for migrating Sendmail
• /.migrate/bin/README – instructions for addaccounts.pl and migratesm
Introduction
1
Nvision.com, Inc. Migrating from a FreeBSD Server to a FreeBSD v2 Server
Creating Users
Your first task after the shadow process is to create your users by running the addaccounts.pl
script. To do this:
1. SHH to your new FreeBSD v2 Server and in the command line, type:
% cd /.migrate/bin
%./addaccounts.pl accountname
where “accountname” is your old FreeBSD Server account owner.
This script creates all the user accounts that were on the old server and their home directories
at /home/username on the new server, with FTP and mail access and no shell access. Users
with FTP and mail access will be added to the ftp and mail groups respectively, and each user
will have a group created for them. The quota for each user remains as it was. If you want to
grant shell access to a user, run the pw command. An example follows:
% pw usermod joe –s /bin/csh
2. To check the amount of disk space being used by a specific user on your server, type:
% quota username
where “username” is the name of your user
Adding Virtual Hosts and Other Apache Changes
After you have added the users, re-create the Virtual Hosts that you are hosting. In the past
Virtual Hosts were generally stored in the vhosts directory for FreeBSD Server. For FreeBSD
v2 Server we strongly suggest that you associate each Virtual Host with a user and put the
Virtual Host site under that user’s home directory. For example, if you have a Virtual Host for
test2.com and bob owns that site you would want to add the site to user bob’s home directory.
You cannot simply copy over the httpd.conf file or the VirtualHost blocks of the httpd.conf
file. The format for each is completely different between a FreeBSD Server and a FreeBSD
v2 Server. You will need to run vaddhost again for each Virtual Host.
An example follows of how to add a Virtual Host with the best settings.
1. Connect to your FreeBSD v2 Server using SSH and type vaddhost.
2. Proceed through the script, supplying the requested information. Press Enter to accept
the [default values].
a. The user who is to be associated with the virtual host (subhosted domain). (Example:
bob)
b. Type y or press Enter if the information is correct.
c. Type the hostname (example: grizzles.com) and press Enter.
d. Type www. and the same domain name you just typed, and press Enter. (example:
www.grizzles.com)
e. Press Enter once more to move to the next step.
f. Type y or press Enter if the hostname information is correct.
g. Type the e-mail address of the Web site administrator and press Enter. The default
value is webmaster@domain.name. If accepted, the e-mail address of the Web site
administrator becomes webmaster@grizzles.com.
h. Press Enter, then type the document root for this user.
(example: /home/joe/www/grizzles.biz)
Creating Users
1
Nvision.com, Inc. Migrating from a FreeBSD Server to a FreeBSD v2 Server
i. Press Enter to create the directory.
j. Press Enter or type y if the information is correct.
k. Select a location for the transfer logs.
l. Press Enter or type y if the information is correct.
m. Select a location for the error logs.
n. Press Enter or type y if the information is correct.
o. Select an option for CGI execution for this virtual host.
p. Press Enter or type y if the information is correct.
q. Review the virtual host entry, and Press Enter or type y if the information is correct.
Virtual Host (Subhost) information submitted in this step automatically updates the
/www/conf/httpd.conf file.
3. Make any additional changes to the httpd.conf file that you may have made on your
FreeBSD Server account. Do not just copy the httpd.conf file.
4. Copy the contents of each hosts htdocs directory and cgi-bin directory.
5. To copy the htdocs directory, go to the /.migrate/accountname/
www/vhosts/www.test1.com/htdocs/. Type the following to copy the contents:
% cd /.migrate/accountname/www/vhosts/www.test1.com/htdocs/
% cp –rp * /home/user/www/test1.com/
6. To copy the cgi-bin directory, go to the /.migrate/accountname/
www/vhosts/www.test1.com/cgi-bin/. Type the following to copy the contents:
% cd /.migrate/accountname/www/vhosts/www.test1.com/cgi-bin/
% cp –rp * /home/user/www/cgi-bin/
The log files can be copied over to the user’s home directory if desired.
7. If you are using FrontPage Extensions, install these now by typing:
% cd
% vinstall frontpage
Be sure to install the extensions for each Virtual Host who uses FrontPage.
8. If you are using PHP you will need to it now by typing:
% cd
% vinstall php4
Be sure to follow the instructions thoroughly and choosing the needed components to
install.
9. If you are using any other programs such as mod_rewrite or other apache modules, you
will need to install these at this time as well.
Creating Users
2
Loading...