|
Logging In
Please note that Telnet sessions pass information in plain text and are
therefore not considered to be secure. For secure, encrypted sessions we
recommend using the SSH protocol.
Please connect to your server with telnet or SSH. You can use Windows
2000/98/ME telnet program simply by clicking "START" -à
"Run" and enter telnet domain.com. Once a successful connection is
established, you’ll receive a login prompt. Enter the username for your server
and press Enter. Next, you’ll be asked for a password. Type in the password
that you received and press Enter. After logging in, your screen should look
something like the following:
Welcome.
login: logname
Password: ***************
Last login: Sun May 13 20:46:09 from nic-41-c31-2.mn
ARAB HOSTING NETWORK PRIVATE USE ONLY!
VISITORS ARE NOT WELCOME
machine: cassiopeia.propagation.net
Please abide by the server policies listed below.
The following items or activities are not allowed on this server:
-
Pirated software, warez or illegal MP3.
-
Porn or adult material or links to them.
-
IRC and IRC bots (BitchX, eggdrop, etc.).
-
Proxys/Port "Bouncers" etc (BNC, shelld)
-
Unsolicited or bulk email sent from the server or referencing a domain on the server.
-
Third party chat scripts (para is OK).
We provide 2 chat scripts.
-
Minivend daemons require approval and cost extra to run.
-
Any attempt to exploit, undermine, overload or adversely
affect the system or it's users.
Any violation of the above will result in loss of access priviledges.
**** Thank you! ****
You have mail.
cassiopeia:/home2/logname$
The domain name should be your actual domain name like logname.com. Once
logged in if you want to become root to do server administration, type:
Su
And hit <enter>. It will prompt you for a password. Enter the root
password sent to you in your login emails. Your screen should now look like
this:
cassiopeia:/home2/logname$ su
Password:
cassiopeia:/home2/logname#
The # denotes you are ROOT. If at any point you get confused on what username
you are logged in as simply type: whoami and unix will display your username.
Your screen will look like this if you run whoami:
cassiopeia:/home2/logname# whoami
root
cassiopeia:/home2/logname
Your Server’s File System Structure
Your server runs on UNIX and is very similar to the directory structure used
by DOS. The directory tree starts at the root, which is the lowest possible
level in the directory tree. From the root level, the file structure branches
out into sub-sections or what is know as "directories."
A directory that contains another directory is called a parent directory.
Directories can branch out into subdirectories, which in turn can branch out and
contain other subdirectories, and so on. The relationship between the root and
any directory within the system is called a path. Paths are displayed with an
initial slash (/) to denote the root, and subsequent directories are separated
by additional slashes.
If you ever get lost and do not remember where you are in the directory tree,
you can type: pwd and UNIX will display the current directory. Your screen will
look like this if you run the pwd command:
cassiopeia:/home2/logname# pwd
/home2/logname
cassiopeia:/home2/logname#
Your HOME Directory
When you first login to your server you start out in your home directory.
This is the directory on the system that contains all the files and
subdirectories pertaining to you and your server.The path to your home directory
is:
/home/username
Note that username is the same username you use to login to the server. To
understand the path to your home directory, realize that by starting at the
root, then branching off into the directory called "home" then
branching off into the directory called "username," you arrive at your
very own home directory.
In your home directory, you "own," or have permission to access,
any of the directories and files contained in or below the directory, with the
exception of a few system files that you do not have the ability to edit or
delete.
Basic UNIX Commands
man: A type of UNIX help system that displays a manual page about a specified
command.
pwd: Short for Print Working Directory. Displays the path to the current
directory.
ls (list): Displays a list of the files and directories in the current
directory.
ll (long list): Displays a "long listing" of files, directories,
permissions and file size in the current directory. Similar to the DOS command
DIR.
grep: Searches documents or directories for a specific word, phrase, or file.
cd (change directory): Used to move to a different directory. If no directory
is specified, it will take you to your home directory.
mkdir (make directory): Creates a new directory.
mv: Moves a file into another directory, or renames a file by
"moving" an existing file to a new file with a new name.
rm (remove): Removes a file or directory.
cp (copy): Copies a file or directory.
touch: Creates a new, empty file or updates the date that an existing file
was last modified.
more: Displays the contents of a text file. If the contents of the file are
larger than your screen, it will wait for you to ask for more by pressing the
space bar.
pico: Starts the PICO online text editor.
pine: Starts the PINE email program.
Basic UNIX Tutorial
--I am lost! What do I do?
This section introduces you to some helpful commands when discovering for the
first time you have absolutely no idea where you are:
The pwd command
Use the pwd command to display the full path of the directory you are
currently in.
The ls command
Use the ls command to view the files and directories contained within your
current directory.
The ls command will output like this:
19t.gif hostsentry-0.02/
1t.gif hostsentry-0_02_tar
21t.gif htac
23t.gif htsdata/
25t.gif index.html
The l command
The l command displays a "long list" of files and subdirectories
within the current directory, including file permissions, file ownership, file
sizes (in bytes), and the date each file or directory was created or last
modified. l is technically not a command, but an alias to ls –al. The l
"command" is similar to the DOS command DIR. If you run the l command
your screen will look like this:
drwxr-xr-x 3 logname lognamegr 124 Jan 1 2000 .htsdata
-rw-r--r-- 1 logname lognamegr 184320 Jan 1 2000 hostsentry-0_02_tar
-rw-r--r-- 1 logname lognamegr 165 Jul 12 2000 htac
drwxr-xr-x 3 logname lognamegr 1024 Jan 1 2000 htsdata
-rw-r--r-- 1 logname lognamegr 13253 Jul 12 2000 index.html
-rw-r--r-- 1 logname lognamegr 1499 Jul 9 2000 index.html.bak
Notice that in this view of the same directory, files that start with a dot
(.) also appear. These files are typically necessary system files and they are
not shown with the ls command.
Take a look at the first (far-left) column of this output. Note that each
line begins with one of 3 characters: a ‘d’, an ‘l’, or a dash (-). A
dash denotes a file; ‘d’ stands for directory; and ‘l’ refers to link.
--How do I create a file or directory?
The mkdir command
You can create your own directories with the mkdir command.
Example: At the command prompt, type:
mkdir testing
and hit <enter>
You have just created a directory called "testing"
The cd command
To work within a directory, you must first move into that directory using the
cd command.
Example: To check out the "testing" directory you just created,
type:
cd testing
and hit <enter>
You are now in the /testing directory. To verify this, type:
pwd Enter
The full path is displayed as /home/username/testing
Here are some other features of the cd command worth noting:
If you don’t specify a directory you will automatically be taken to your
home directory. You can perform this by just typing:
cd
and hit <enter>
You are now automatically taken back to your home directory (home/username).
The touch command
Similar to the mkdir command, which is used to create directories, the touch
command is used to create empty files. This command also can be used to update
the date that a file was last modified.
Example: Create an empty file called 1234
touch 1234
and hit <enter>
Note that the 0 bytes file 1234 has been added to the directory listing.
Searching for words with the grep command
The grep command can be used to search text files for occurrences of a word
or phrase.
Example: To search your /home/www/logname/index.html file for the word
‘hosting,’ type:
grep ‘hosting’ /home/www/logname/index.html
and hit <enter>
The output displays all of the lines that contain the word ‘hosting’
within the file.
How do I change, create or delete files or directories?
The pico command
To add text to a file, you can use pico, an online editor. Pico is a simple
text editor that comes pre-bundled with UNIX and is very easy to use. It’s
menu based and similar to the old DOS versions of MS Word.
Example: you want to create a file called index.html. You would type:
pico index.html
and hit <enter>
Pico will automatically open and create an empty file called index.html.
Whatever text you add to the file will be later saved.
Your screen should look like this:

Because the file is empty, the editing screen will look blank. Now type some
text to make it come alive:
I am testing PICO. What will this do?
And hit<enter>
To save the new contents of this file, press Ctrl+X. Pico will ask if you
would like to save the contents of the file. Press Y to do so. Finally, pico
will ask you what to name the saved file (File Name to write). By default, pico
suggests you keep the same filename, so simply press Enter to accept.
Now if you go to your web browser and open it up to http://www.domain.com/index.html
you will see:
I am testing PICO. What will this do?
While using pico, there are several key combinations that will help you view
or edit a file. Below find the most common used commands or key strokes:
Ctrl+G Open the tutorial
Ctrl+Y View previous page
Ctrl+V View next page
Ctrl+A Go to the beginning of a line
Ctrl+E Go to the end of a line
Ctrl+C Display the line number that you are currently on
Ctrl+W Search the file for a word
Ctrl+O Save the file and do not exit
Ctrl+X Exit Pico (will prompt you to save or discard changes)
The more command
The more command displays the contents of a text file. If the contents of the
file are larger than your screen, you "ask for more" by pressing the
space bar when you are ready, or quit by pressing Ctrl+C.
Example: Use the more command to verify that the new text you entered with
pico is now saved inside your "hello" file:
more index.html
And hit<enter>
The text you entered with Pico should appear:
I am testing PICO. What will this do?
The cp command
The cp command is used to copy one file to another. The format of the
cp
command is
cp source target
where the source is the original file and the target is the name of the new
file.
Example: Make a copy of your hello file and name the copy "hello2."
cp index.html index-old.html
And hit<enter>
To verify that the file was copied successfully, type:
ls
And hit<enter>
There is now a index-old.html file in addition to the index.html file. To
verify that the contents of the newly created or copied file index-old.html you
can type:
more index.html
And hit<enter>
Again, the same input appears:
I am testing PICO. What will this do?
The mv command
The mv command can be used to either move a file into another directory, or
to rename a file (by "moving" an existing file to a new file with a
new name).
Example 1: To rename the index.html file as "index-1234.html" type:
mv index.html index-1234.html
And hit<enter>
Now the file will be renamed index-1234.html and index.html will be gone.
Example 2: Create a new directory called dir1234 and move the index-1234.html
file into it:
mkdir dir1234
And hit<enter>
You have now just created a new directory called dir1234. Now lets move
index-1234.html into it:
mv index-1234.html dir1234
The index-1234.html file is now in the directory dir1234.
QUIZ: What is the full path to the file index-1234.html in directory dir1234?
Answer: /home/username/dir124/index-1234.html
Removing a file using the rm command
You can remove files with the rm command. Be very careful using this command.
Once you remove a file its gone forever.
Example: Lets remove the file called index-1234.html in the directory
dir1234. Make sure you are still in this directory. If you are unsure type pwd
and you should see:
/home/username/dir1234
rm index-1234.html
And hit<enter>
Removing a directory using the rm -R command
Using the –R option with the rm command allows you to delete directories as
well as files. Be very careful when using the -R option with the rm command.
Used incorrectly, this command can cause a lot of damage as it removes every
file in the directory in one clean swoop.
Example 1: Delete the dir1234
To do this you need to be one directory higher, do if you are in dir1234 you
need to type:
cd ..
And hit<enter>
The .. directs the operating system to take you up 1 directory level or back
to /home/username in this case. To verify you have done this correctly type pwd
and you should see:
/home/username
One note on this, the rm command alone will NOT remove a directory. To prove
this, type:
rm dir1234
And hit<enter>
The following error message appears:
rm: dir1234: is a directory
To prevent you from deleting an entire directory by accident, the rm command
requires an additional flag, or command line option, to verify that you really
want to remove the directory. Now, try removing the dir1234 directory using the
–R (recursive)flag:
rm –R dir1234
And hit<enter>
In the preceding command line, the –R option tells the rm command to
recurse–in other words, to not only remove the specified directory, but to
also remove all files and/or subdirectories that the dir1234 directory contains.
You’ll now be asked to confirm that you really want to delete the directory
and each file contained within it. Press Y, Enter to confirm.
Useful Directories
/ Is the base or root directory of the entire file system.
www: This directory, also known as the Document Root, houses your Web pages,
graphics, and any other files you want available for public view through a Web
browser. You can create any number of subdirectories within the www directory.
Those who access your server with a Web browser will have read access to the www
directory, and to every file and subdirectory that it contains. However, nobody
has the ability to write to or change any of these files unless you specifically
configure your server to allow them to do so. You can configure your server to
restrict access to certain subdirectories of your document root. This process is
discussed in a later chapter.
/www/conf All configuration files for the server.
/www/logs Contains the transfer logs for each domain. These logs are trimmed by
default every Sunday at 2:40CT to save space.
/www/logs/archive Archives of your old server logs. Helpful is trying to
retrieve information on a hacker attacker or something of similar nature.
/ftp/logs This directory houses all of the FTP transfer logs.
/www/realaudio Contains all of the RealVideo/Audio files for each domain.
/home/username/www main web directory for domain.com.
/ftp/username main ANONYMOUS ftp dir for domain.com.
/root This is the server’s root directory. Note this is not /home/root rather
just /root.
/var/spool/mail This directory contains all of the incoming mail for every user
on the server. By default every user gets 10 MB of spool space.
/home/access-log: Contains records of all the Web activity that occurs on
your server.
/home/username/www/cgi-bin Contains executable binary files and script files
that can interact with Web visitors through their Web browser. These programs
are commonly referred to as CGI programs. CGI stands for "Common Gateway
Interface."
/home/username/www/wusage Wusage online statistical files
/ftp/username/incoming This is the directory for domain.com that stores all of
the incoming anonymous FTP files transferred in from users or site visitors.
/home/username/infobots This directory is where your Mail bots are stored (email
auto-responder) files
/home/username/maillists Contains all mailing lists for domain.com
/usr/local/pnserver This is Real Audio/Video is installed for the server. All
binary, configuration and installation files are located in here.
/usr/local/Hughes This is the mSQL installation directory.
/usr/local/frontpage All of the FrontPage extensions and binaries are located
here
/usr/local/majordomo Majordomo Listserver files are kept in here.
/usr/local/ssl Where your SSL certificates are located.
/etc/passwd This file contains all of the users that are setup to access the
server.
/etc/shadow This file contains the encrypted passwords for the users that are in
/etc/passwd.
/etc/group Lists all of the groups and their members You can use this file to
find out who belongs to which domain.
/etc/da This file contains the server wide mail forwarding information that is
collected from each domain. If you open this file you will see:
dhudson@king.com webmaster
This means that any mail that comes into the server for dhudson@king.com will
automatically be placed in the spool file for the user webmaster. Do not edit
this file directly, please edit the .redirect file which is in the
/home/username directory for each domain. The server has an automated process
which collects the entries in the .redirect file every 10 minutes and places
them in this file.
/etc/da2 Works just as the /etc/da file does but this file contains information
for any email that is to be forwarded OFF the server. If you open this you might
see:
test@king.com king993@aol.com
This means that any email that comes to test@king.com will automatically be
forwarded on to king993@aol.com
The simplest way to distinguish /etc/da and /etc/da2 is that they are both
mail forwarding configuration files but /etc/da2 forwards off the server while
/etc/da keeps mail on the server.
/etc/domains This file contains a list of all of the virtual domains on the
server, the default username and the group name for that domain. If you edit
this file your screen will look like this:
king.com 63.249.159.44 kinggrp
/etc/domains2 This file lists domain aliases, or domain pointers. It will show
you the aliased domain and the master domain. For example you might see:
king.com 63.249.159.44 fakeking.com
This shows that king.com which is located at the IP address 63.249.159.44 on
this local server also has a aliased domain fakeking.com which will bring users
to the same space. Simply put, in a web browser if someone types king.com or
fakeking.com they will pull up the files located at king.com on this server.
/etc/.ipaliases.data This file will show you every IP address bound to your
server.
/etc/named/ipnums This file will show you a list of just the UNUSED IP addresses
on your server.
Other important files and their directories:
/etc/sendmail.cw: Contains a list of domain names that you wish to be able to
provide email service for on your server.
/etc/sendmail.cf: A very important file that allows your server to handle
email. Do not edit unless you are extremely versed in UNIX. All of the automated
software on your server can update and edit this as needed for you.
/etc/hosts: This file shows you every domain on the server and the IP address
assigned to it. It will also show you which IPs are bound to your server to use
for future addition of virtual domains.
/usr/bin: This directory contains many of the commands that you use on your
server. Because of the way your server is configured, these commands are
accessible from any directory. For example, the files ls and pwd are actually
stored in this directory, but you can use them from any directory on your
server. You should never need to change any of the files in this directory, and
it's a very good idea not to try.
/usr/log: This directory contains an important file, called xferlog and
httpd.
The xferlog file contains a record of all the FTP activity that takes place on
your server and the httpd log records every web hit.
/var/spool: This directory contains a subdirectory called mqueue, which
stores any mail that is waiting to be sent from your server. Because mail is
usually sent immediately, this directory will be empty most of the time.
However, if there is a temporary delivery problem, mail may queue up here for
later delivery.
/ftp: This directory contains files for email and FTP users that you add to
your VServer. In some cases, a directory will be created in here with the user's
name and will act as that user's home directory.
/var/spool/mail: This directory contains stored email messages for your
Administrative Email account, and for any POP users you have added to your
server.
/home/www/httpd.conf: The main configuration file for your server’s Web
service. This is the configuration file that is modified most often. You can
edit it to configure your server’s Virtual Hosting capabilities, to modify the
way your log files are managed, and to configure many other advanced features.
This file is very complicated to edit. Please use the proprietary domain
provisioning tool installed on your server by typing account at any root level
prompt.
The /home/www/conf/httpd.conf file is the main configuration file for your
Web service. It contains directives relating to the operation of the server as a
whole, and is therefore the file you are most likely to make changes to.
Some of the more useful or important directives in your httpd.conf file are:
HostnameLookups: This directive turns on or off reverse DNS lookups in your
log files. When off, the Web server responds more quickly. When on, the server
performs DNS lookups every time a user hits the page. Although it can provide
useful information, the HostnameLookups option causes the Web server to respond
more slowly. For this reason, HostnameLookups is turned off by default.
ServerName: Specifies the name of your server. The server name MUST be a
valid domain name that was assigned to you. By default this will end in .propagation.net
which is the network your server is housed on.
ServerAdmin: This directive denotes the email address that a visitor should
contact in case of server problems. The address is displayed through the browser
in some error messages and is also available in CGI scripts as a variable called
SERVER_ADMIN. By default, the ServerAdmin is set as the webmaster@yourdomain.com,
but can be any valid email address.
ErrorLog: Specifies the location of the file where you want to log your Web
server errors. It is useful for debugging CGI programs and finding broken links
on your Web site. By default, this directive is set to logs/error_log.
TransferLog: Specifies the location of the file where you want to log
information about requests (often called "hits") that are made to your
Web service. By default, this directive is set to logs/access_log.
AgentLog: Specifies the location to log information about the types of Web
browsers that are being used to visit your site. By default, this directive is
set to logs/agent_log
RefererLog: Specifies the location to log information about where your Web
visitors are being "referred" from–in other words, where they were
before they came to your Web site. The misspelling of the word referer is
intentional for historical reasons. By default, this directive is set to logs/referer_log.
<VirtualHost></VirtualHost>: This directive allows you to host
additional domains on your server. Directives that are placed between <VirtualHost>
and </VirtualHost> apply only to that specific virtual host. By default,
there should be a <VirtualHost> entry present for your main domain name.
Most directives can be applied to a <VirtualHost> entry.
/home/www/srm.conf: Contains important configuration data concerning Web
directories and file names. One part of this file that you may want to modify is
a section that allows you to specify custom error pages for you server Web
service. Please use the proprietary domain provisioning tool installed on your
server by typing account at any root level prompt.
The /home/www/conf/srm.conf file contains directives that relate to names and
resources in the file system—file paths, directory indexes, aliases, and so
forth.
DocumentRoot: Specifies the directory where your HTML documents are to
reside. Your Web service will not function without this directive. By default,
this is set to /www
DirectoryIndex: Specifies the name of the file or files to look for as the
default home page. If the file named here is not present, an "index"
of the directory will be created if the Options directive that pertains to that
directory allows indexing. By default, this directive is set to allow the
follwing files to execute by default if someone just types http://domain.com in
a browser:
default.htm index.cgi index.html index.htm index.shtml index.shtml
index.mv index.htmv index.php index.php3 /missing.html
NOTE: the /missing.html is added in there so if you don’t have an
index.html or one of these other files in a directory someone cannot get a
directory listing of the files in there. This is just another security
precaution we take to ensure your files stay safe from potential hackers.
UserDir: This directive is used to enable to disable the use of user
directories inside your Web site URLs. If you define a name here, and FTP users
that you have added to the /home/username directory tree can serve Web documents
from your Web site by creating a directory by that name in their home directory
and using username in URLs. By default, this option is off. Typically, the
directive is set to public_html to enable this service.
AccessFileName: Specifies the name of the file to look for in each directory
for access control information. The contents of the file named here can override
the global access control settings that are contained in /home/www/conf/access.conf
if the AllowOverride directive that pertains to that directory allows overrides.
By default, this is set to .htaccess.
Redirect: Allows you to redirect clients to a different area of the Web site,
or even to a different Web site.
AddType: Allows you to define new media types and associate them with a file
extension, and optionally, an executable program such as a CGI.
ErrorDocument: Allows you to specify an alternate document to display when
Web server errors occur.
Alias: Allows you to create directories that can contain Web-servable
contents but are physically located outside of the document root. By default an
alias for the icons directory that contains the images for server-generated
index files is defined as:
Alias /icons/ /www/icons
ScriptAlias: Allows you to create directories that can contain executable
programs that are available to the Web server but are physically located outside
of the document root. This is used both to enable CGI-BIN capabilities on your
primary Web site, and on virtual hosts when used inside <VirtualHost>
directives. By default a script alias for your /home/username/www/cgi-bin
directory is defined as:
ScriptAlias /cgi-bin/ /www/cgi-bin/
access.conf: Defines the general access settings for your server. This file
determines who is able to access your server and what visitors are able to do in
certain directories. You can edit this file in order to restrict access to
specific directories of your document root to specific people, groups, and
passwords. Please use the proprietary domain provisioning tool installed on your
server by typing account at any root level prompt.
The acces.conf file divides the Web server space into several sections using
<Directory></Directory> directives. Options, restrictions, and other
settings pertaining to the specific sections are placed within these directives.
For security reasons, the most important directive may be the AllowOverride
directive. By default, the document root allows unrestricted overrides. If this
is a concern to you, you should change the AllowOverride directive to None, or a
combination of the following:
All. Removes restriction on access control files within the specified
directory.
None. No access control files are allowed within the specified directory.
AuthConfig. Enables the use of AuthType, AuthUserFile, and AuthGroupFile
directives.
FileInfo. Enables the use of the AddType and AddEncoding directives.
Limit. Enables the use of the Limit sectioning directive.
Options. Enables the use of the Options directive.
Another directive that is important for security reasons is the Options
directive. This directive defines what can be done in the directory.
By default, the Options setting for main Web directories is set to allow
auto-generated indexes, symbolic link navigation, and Server Side Includes. For
the /home/username/www//cgi-bin directory it is set to allow CGI execution and
symbolic link navigation.
This directive can be set to any of the following, alone or in combination:
All. All features are enabled for this directory.
None. No features are enabled for this directory.
ExecCGI. CGI scripts can be executed in this directory.
Includes. Enables server-side include files in this directory.
IncludesNoExec. Enables server-side include files, but disables the exec
server-side include command.
FollowSymLinks. Allows the server to follow symbolic links.
SymLinksIfOwnerMatch. Allows the server to follow a symbolic link only if
the target file or directory is owned by the same user ID as the link.
mime.types: Defines the media types for your server. You may edit this file
to add new file types to your server as new multimedia extensions become
standardized.
An example of a mime.type would be this:
application/commonground dp
Virtual Domain Provisioning Tools
--Account Bot
This is a proprietary tool constructed to help you administer your server with
very little knowledge of the inner-workings of UNIX. You can do pretty much
anything you need to do by using the account bot.
To start the account bot simply type:
account
and hit <enter>
Your screen should look like this:
There are currently 0 domains on this server.
Main menu:
1. Add a new domain.
2. Add a new user.
3. Setup menu.
4. Add an Email only account(POP access).
5. Delete/modify user/domain.
6. Add members to an existing group.
7. Add/modify disk quotas.
8. Update nameserver only.
9. Add an ftp only account.
10. Realaudio.
11. Point domain A to domain B.
12. Move domain
13. Move_domain_batch.(read from /root/batchmove)
20. Add a DNS entry
25. IP Usage
You can now choose anything you want from the menu based system. If at any time
you wish to exit out of the program you hit CTRL+C.
First lets setup a new virtual domain on this server. Lets call it king.com
Choose option number 1 by typing
1
and hit <enter>
Your screen will now ask you a series of questions.
The first question will ask you for the domain name. Enter
king.com
And hit <enter>
Next the account bot will ask you the username for this domain. You will see
[king] next to the answer. In UNIX the [ ] denotes DEFAULT so by hitting
<enter> it will automatically type whatever is between the [ ] for you. So
just hit <enter> here because we want the username of the king.com domain
name to be just king. You always want the username of each domain to be just the
domain without the extension this way you can organize the /home drive easier
because each directory will have a unique name. NOTE: all virtual domains will
have their own group. In this case, the group is "kinggrp". All new
users added to king.com will automatically belong to the group "kinggrp"
The next question will ask for the Full Name. This is just used for
accounting purposes and you can enter the name of the client who owns this
virtual domain name here if you wish or you can leave it blank. By default it is
always blank.
Next the account bot will ask you for the password for this domain. The
password can be any combination of UPPER case letters, lower case letters,
numbers, or symbols. The password can be up to 8 characters long. Please make
the password relatively difficult to ensure proper server security.
Next up the account program will ask you to choose a disk quota for this
domain. A disk quota is the amount of space in megabytes a virtual domain can
occupy on the hard drive. This is especially useful to charge clients additional
monthly fees when they run out of server space.
Next it will ask you for the default email address for the domain king.com.
By default this is the username@domain.com or in this specific case king@king.com.
The next item on the list will ask if you want to install the business site
scripts. These are just the 15 free CGI scripts that come with each virtual
domain. These include a BBS, guestbook, counters, formmail, shopping cart and
other scripts. If you are setting up this domain for retail use we suggest you
give the client the extra scripts.
Next the bot will prompt you to select if you want FrontPage extensions
installed on the domain.
Lastly, the account bot will ask if you want the remaining free site scripts
installed. The default selection here is y because it will install things such
as the Miva empresa engine and PHP4.
The domain king.com is now ready to setup. The account bot will prompt you
one last time to make sure you are satisfied with your choices. If you made a
mistake simply press n and hit <enter> to redo the setup process or hit y
and press <enter> and the domain will be setup instantly.
Your screen should look like this:
Your choice? 1
Full domain name? king.com
who is the owner(username) of the domain?[king]:
Full name(can be blank):
Password:1234
Select disk quota for this domain:
(a)2 megs
(b)5 megs
(c)10 megs
(d)25 megs
(e)50 megs
(f)75 megs
(g)100 megs
(h)150 megs
(i)500 megs
(j)1000 megs
(k)1500 megs
(l)2000 megs
(m)No quota
Your choice ?: m
Default email address in .redirect[king@king.com]:y
Install full business site scripts?[y/n]:y
Install frontpage(using the above username/password)?[y/n]:y
Install new scripts?[y/n]:y
Domain: king.com
Username: king
Password: 1234
Disk quota: None
Default email address: y
Basic site scripts: Yes
New scripts: Yes
Frontpage: Yes
Cgiwrapper: Yes
Satisfied with the above choices?[y/n] y
The account bot will not setup the domain and assign an IP address to it. It
will edit all appropriate files on the server and setup the virtual domain
completely ready to use.
Your screen should now show something similar to this:
Guestbook installed.
WWWboard installed.
Installed click and go.
Installed graphic counter.
Shop cart installed.
Anonymous ftp dir is /ftp/king
wusage installed.
Starting install, port: 80, web: "root web"
Creating web http://www.king.com
Install completed.
Frontpage installed.
htmlscript installed.
Assigned IP number: 63.249.159.44
Notice the Assigned IP address for this domain is now 63.249.159.44. This is
the IP address you can use to access the domain via the web. This is the IP that
will be added to DNS so you can access king.com without having to know it is
housed at 63.249.159.44 on your server. Our DNS is automated and will pick up
the new domain king.com from your server within 10 minutes and add it to DNS.
Should you change the IP of king.com in the future, the DNS will automatically
refresh for you.
You are now ready to use the account bot to setup a new domain or administer
a current one. Explore the bot a little on your own, its full or useful tools
for you, the webmaster.
--Setup bot
This is a another proprietary tool constructed to help you administer your
server with very little knowledge of the inner-workings of UNIX. The setup bot
is used to fix problems with virtual domains on your server.
To start the account bot simply type:
setup
and hit <enter>
Your screen should look like this:
noir:/www/conf# setup
Setup menu:
1. Install/reinstall features
2. Mysql
3. Msql
4. Install a SSL certificate
5. Restart the RealAudio and Video server
6. Miscellaneous
q. Quit.
Your choice?
If you select option number 1 the setup bot will prompt you to enter a domain
name that resides on the server to administer. Once you do this will see a menu
similar to this:
Install Menu
1. All standard scripts
2. Guestbook
3. Wusage
4. Simple Search
5. Click and Go query box
6. Random text script
7. WWW Board Menu
8. Free For All Links page
9. Whois Query
10. Formmail.cgi
11. Cgiemail
12. Miva
13. ShopMonster
14. Banner Rotation
15. Resellers Scripts
16. W:Mail 3.0
17. MonsterControls
18. Password protected web page
19. Boutique shopping cart
20. Graphic Counter
21. Volano Chat
22. Miva Order 1.14
23. Sitepop (now part of monstercontrols)
24. Let's Take an Order
25. Miva Merchant 3.01
26. PHP 3
27. Miva Merchant 2.22
28. Auction
29. Mail.cgi
30. SiteInfo
32. Monsterbook
33. Raw Access Logs
34. BWI (Banner Wheel Industrial)
35. Index.cgi creation tool
q. Quit.
<enter> Return to main menu.
Your choice?
You can now choose from the 35 options above to install, re-install or repair
broken scripts, PHP, Miva empresa and other things.
If you hit <enter> it will return you back to the main menu and your
screen will once again show:
noir:/www/conf# setup
Setup menu:
1. Install/reinstall features
2. Mysql
3. Msql
4. Install a SSL certificate
5. Restart the RealAudio and Video server
6. Miscellaneous
q. Quit.
Your choice?
From here you can choose option 2 if you wish to setup, administer, create or
delete mySQL databases or users who can access certain databases.
From here you can choose option 3 if you wish to setup, administer, create or
delete mSQL databases or users who can access certain databases.
From here you can choose option 4 if you want to setup SSL certificates for
the server or for particular domains. NOTE: you must first run
gencert domain.com
And hit <enter>
from a regular root prompt to generate the SSL keypair to send off to Thawte
or Verisign.
Option 5 from the menu will stop and restart the Real Audio/Video server for
you automatically.
If you choose option 6 your screen will display:
Misc. menu:
1. Reinstall /ftp/supportteam directory
2. Limited-access user
q. Quit.
<enter> Return to main menu.
Which lets you reinstall a FTP account or setup a limited-access user.
The limited-access user function allows you to setup a FTP user to have only
access to certain directories within your domain.
For example, if you have king.com and you want an additional FTP to user to
access only /home/www/king/newuser you could setup a limited-access user and
they would only be able to FTP into that /newuser directory inside king.com.
They could never accecss the index.html or other files that are stored in your
/home/king/www directory.
MANAGED DEDICATED SERVER F.A.Q
General information about your server:
Operating system: Red Hat Linux 5.2 (CUSTOM)
Web server: Apache 1.3.19
mSQL server: version 2.0.9
FrontPage: version 4.0.4.3 (FrontPage 2000)
Wusage: 7.0
Majordomo server: version 1.94.3
PHP: 4.0.4
1. How do I change a user's password? Type
passwd someusername
and hit <enter>
2. A customer forgot the password. How do I find out what it was?
Each password is encrypted so there is no way to determine what the password
was. You will simply have to change it to a new password.
3. How do I restart the web server? Type:
httpd.reload
and hit <enter>
This will gracefully restart the server. In most cases, this is all that's
necessary. There is also a more forceful method of restarting the server. Use
this method only as a last effort to save the server without having to do a
reset. You can type:
httpd.restart
And hit <enter>
This will completely kill the current server and then restart it. Be careful
with restarting the web server. It may take up to 30 seconds or more to restart
and no one will be able to connect to the server during that time. Also,
restarting the web server is especially bad for FrontPage users. They will get a
timeout error message if they were in the process of publishing to the web they
will get .lock files and will be prevented from re-uploading until certain steps
are taken to repair the webs and child webs.
4. How do I restart sendmail? Type:
sendmail.reload
and hit <enter>
You can run this as often as you need. It will not affect any email or users
on the server. Run this is the mail server seems to be stalling or timing out.
5. How do I change the message that gets displayed when I first telnet in?
Edit the following file:
/etc/motd
6. How can I tell who is currently logged in or using my server? Type
w
and hit <enter>
This will show you can users who are telneted to the server and what time and
day they logged on and which commands they are running.
7. What about the ftp users? How can I tell which are logged in? Type
ftpwho
and hit <enter>
8. My connection seems to be bad, how do I check it?
You can use "ping" and "traceroute".
Examples:
"ping yahoo.com"
"traceroute yahoo.com"
If you run a trace route by typing
traceroute yahoo.com
and hit <enter>
Your screen should show this:
noir:/home/www/conf# traceroute yahoo.com
traceroute: Warning: yahoo.com has multiple addresses; using 216.115.108.245
traceroute: Warning: Multiple interfaces found; using 63.249.159.34 @ eth0
traceroute to yahoo.com (216.115.108.245), 30 hops max, 40 byte packets
1 fa0.core.propagation.net (63.249.128.1) 0.510 ms 0.656 ms 0.670 ms
2 gi5.core.propagation.net (66.34.255.1) 0.899 ms 0.929 ms 0.917 ms
3 s4-0-1.ar1.DAL1.gblx.net (208.49.125.161) 2.096 ms 2.126 ms 2.152 ms
4 pos2-0-155M.cr2.DAL1.gblx.net (206.132.119.117) 2.001 ms 2.383 ms 2.173 m
s
5 pos7-0-2488M.cr2.SNV.gblx.net (208.50.169.86) 48.764 ms 49.366 ms 51.682
ms
6 206.132.254.41 (206.132.254.41) 60.256 ms 48.930 ms 48.578 ms
7 bas1r-ge3-0-hr8.snv.yahoo.com (208.178.103.62) 49.497 ms 48.793 ms 49.030
ms
8 img5.yahoo.com (216.115.108.245) 50.006 ms 48.735 ms 48.860 ms
noir:/home/www/conf#
If you see any astericks (*) in the results that means the ping requests
timed out and did not return back to the server. This means there is a problem
somewhere between your server and yahoo.com. If you see this * in the first 2
hops:
1 fa0.core.propagation.net (63.249.128.1) 0.510 ms 0.656 ms 0.670 ms
2 gi5.core.propagation.net (66.34.255.1) 0.899 ms 0.929 ms 0.917 ms
That mans there is a problem with the network your server is located on or
with your server itself. Good trace route times should be under 100ms at every
hop.
If you run the ping command by typing:
ping yahoo.com
and hit <enter>
Your screen will show this:
PING yahoo.com (216.115.108.243): 56 data bytes
64 bytes from 216.115.108.243: icmp_seq=0 ttl=248 time=49.3 ms
64 bytes from 216.115.108.243: icmp_seq=1 ttl=248 time=50.0 ms
64 bytes from 216.115.108.243: icmp_seq=2 ttl=248 time=49.7 ms
64 bytes from 216.115.108.243: icmp_seq=3 ttl=248 time=49.6 ms
64 bytes from 216.115.108.243: icmp_seq=4 ttl=248 time=49.6 ms
64 bytes from 216.115.108.243: icmp_seq=5 ttl=248 time=49.8 ms
64 bytes from 216.115.108.243: icmp_seq=6 ttl=248 time=49.7 ms
64 bytes from 216.115.108.243: icmp_seq=7 ttl=248 time=49.6 ms
--- yahoo.com ping statistics ---
8 packets transmitted, 8 packets received, 0% packet loss
round-trip min/avg/max = 49.3/49.6/50.0 ms
noir:/home/www/conf#
The server will continue to ping forever. To stop it and view the results
just press CTRL+C. You should not see any packet loss or times over 100ms.
Notice above we had 0% packet loss: 8
packets transmitted, 8 packets received, 0% packet loss <--
and the highest ping time was 50.0 ms. So there are no problems to report
here.
Alternatively, you can check the connection between your desktop computer (the
computer you are using to remotely connect to your server) with ping.exe or
tracert.exe from any Windows 95/98/2000/ME computer. Please note you type
Ping yahoo.com
Tracert yahoo.com
From a Windows computer.
Traceroute yahoo.com
Will not work.
9. How do I check what processes are currently running? Type
ps aux
and hit <enter>
Your screen should look something like this:
root 31985 0.1 0.2 1336 708 ? S 04:24 0:00 expect /usr/spectro/l
root 31986 0.0 0.2 1232 528 p0 S 04:24 0:00 bash /usr/spectro/gra
root 31989 0.0 0.1 868 360 p0 S 04:24 0:00 rcp nbbmls.propagatio
root 31994 0.1 0.2 1336 708 ? S 04:24 0:00 expect /usr/spectro/g
root 31996 0.0 0.2 1232 528 p2 S 04:24 0:00 bash /usr/spectro/gra
root 31999 0.0 0.1 868 360 p2 S 04:24 0:00 rcp web.nistor.propag
root 32077 0.0 0.1 864 356 r8 S 22:06 0:00 rsh beryl.propagation
root 32079 0.0 0.1 864 356 r8 S 22:06 0:00 rsh beryl.propagation
root 32082 0.0 0.2 1336 708 ? S 04:25 0:00 expect /usr/spectro/l
root 32083 0.0 0.2 1232 528 p9 S 04:25 0:00 bash /usr/spectro/gra
root 32086 0.0 0.1 868 360 p9 S 04:25 0:00 rcp skeksis.propagati
root 32091 0.0 0.1 952 416 pd R 04:25 0:00 ps aux
These are all of the processes that are running on your server and the time
at which they started. The second column is the ID which the server assigned to
the process when it started. If you wish to terminate a runaway process you can
do so by typing
kill ID
and hit <enter>
For example, if we want to kill the first process on the list, ID 31985 we
would type:
kill 31985
and hit <enter>
10. How do I check the memory on the server? Type
free
and hit <enter>
Your screen should look like this:
total used free shared buffers cached
Mem: 254992 240676 14316 128220 77180 69292
-/+ buffers/cache: 94204 160788
Swap: 72256 112 72144
Here, 94204 Kbytes of memory are in use, and 160788 Kbytes are free. There
should always be enough free memory available. If not, it's probably time to
upgrade your server. When your server runs low on memory services will not
start, clients will get time out messages when trying to get to your web site
and your email will not process. The amount of memory needed depends on how many
domains there are and how busy they are.
11. How do I add cronjobs?
Edit /root/cronfile. After you add the new entry, type "crontab cronfile".
Here are some sample entries:
* * * * * /usr/bin/someprogram
Run /usr/bin/someprogram every minute, everyday.
06 * * * * /usr/bin/someprogram
Run it everyday, every hour, at 06 minute.
06 17 * * * /usr/bin/someprogram
Run it everyday at 17:06
06 17 * * 0 /usr/bin/someprogram
Run it every SUNDAY at 17:06
12. Why won’t cgi script ending in .pl run from outside the /cgi-bin
directory?
The way the server and the cgi-wrapper are configured, scripts ending in .pl
must be ran from within the /cgi-bin directory. If you wish to run scripts
outside the /cgi-bin directory you must rename the file to end in .cgi.
13. I want to point multiple domains to the same IP address (or domain), how
do I use the fakeip script that comes with my dedicated server?
Simple run the fakeip script from any root level prompt by typing:
fakeip
and hit <enter>
Your screen should look like this:
cassiopeia:~# fakeip
Main Domain(Ex. domain1.com): bob.net
Fake Domain(Ex. domain2.com): test.com
Directory of HTML files: test
Directory of HTML files doesn't exist in the dir /home/www/bob.
(/test)
Would you like to create it or chose a new one(y/n): y
Can not find an index file in /home/www/bob/test
What file would you like to use(number or "n" to create one): n
Name of file: index.htm
1. Main Domain: bob.net
2. Fake Domain: test.com
3. Home: /home/www/bob
Location of index.cgi: /home/www/bob/index.cgi
4. Dir: /home/www/bob/test
5. File: index.htm
Link to: http://www.bob.net/test/index.htm
6. File: index.html
Link to: http://www.bob.net/index.html
Choose a number or push enter to proceed:
Email address of client: test@bob.net
Now the fakeip script will automatically make a redirect CGI-script, called
index.cgi and place it in the domain to that traffic that comes in for bob.net
will automatically be redirected to the sub-directory /bob on your main domain.
The final step in this process is to use the account bot’s option #11 to park
the domains to each other and add them to the DNS.
You can accomplish this by typing:
account
and hit <enter>
Your screen should look like this:
cassiopeia:~# account
There are currently # domains on this server.
Main menu:
1. Add a new domain.
2. Add a new user.
3. Setup menu.
4. Add an Email only account(POP access).
5. Delete/modify user/domain.
6. Add members to an existing group.
7. Add/modify disk quotas.
8. Update nameserver only.
9. Add an ftp only account.
10. Realaudio.
11. Point domain A to domain B.
12. Move domain
13. Move_domain_batch.(read from /root/batchmove)
25. IP Usage
(q) Quit.
You need to choose option #11 from the menu. You should now see this:
Your choice? 11
domain B: Full domain name? bob.net
domain A: Hit return to keep the same domain.
full domain name?[bob.net] test.com
Now make sure you enter the FAKE DOMAIN as domain B, in this case bob.net. And
then the main domain on the server where you will be storing bob.net files is in
this case just test.com
Once you complete this, your domains will be parked and automatically
redirected.
14. With respect to my mySQL databases, what should the correct ownership on
those be set to?
MySQL databases and all of their files in /usr/local/mysql/data should be owned
by msql.groupname.
Do perform ownership change, you need to type:
chown owner.group
and hit <enter>
Example: for the domain "sample.com", DB name "schedule" and
group "samplegrp"
So you would type:
chown msql.samplegrp
and hit <enter>
No matter what the domain name owner is the DBs must be owned by msql
drwxrwx--- 2 msql samplegrp 1024 Dec 8 00:16 schedule
cd /usr/local/mysql/data/schedule
chown msql.samplegrp * (NOTE: be sure you're in the domain's DB directory first)
server:/usr/local/mysql/data/schedule# l
total 24
drwxr-xr-x 2 msql samplegrp 1024 Sep 24 1998 .
drwxrwx--- 43 msql root 1024 May 11 17:50 ..
-rw-rw---- 1 msql samplegrp 210 Sep 23 1998 testaa.ISD
-rw-rw---- 1 msql samplegrp 1024 Sep 23 1998 testaa.ISM
-rw-rw---- 1 msql samplegrp 8574 Sep 23 1998 testaa.frm
|