"UST Virtual Server User's Guide"
Working with your Virtual Server
(DO NOT forget the trailing forward slash behind the
'cpanel'! Also, if you have just RECENTLY signed up with us, you will, more than likely,
NOT be able to access your domain name until after it has been registered/transferred and
finished the propogation period [usually 3-7 days]. For now, you can access your domain
name via your IP address (given to you in your initial e-mail we sent you with your
account information))
Upon accessing your control panel, you will be prompted with a dialogue
box that asks for a username and password. You should fill this information out using:
USERNAME: cpanel (lower case, NOT your server
username!)
PASSWORD: same as your server password
Displayed will be a form asking for a new password and a confirmation of the new password. This is where you can change the default password set by our system administrators for your system (FTP, POP, CPANEL access). It will also change your Frontpage root password, if you have Frontpage support on your server. This option WILL NOT change your telnet password, if you have telnet access.
Enter the new password you want into the appropriate
field (6-8 chars) and re-enter it into the second field. Press the 'SUBMIT' button to
change your password to the desired one.
PLEASE NOTE: If you change your password and forget it, please be
aware that passwords are encrpyted on the server and our system administrators cannot find
out your password after you have changed it. If you cannot enter your cpanel or ftp, after
having changed your password, you will need to e-mail support@USTeam.net
to have the system administrators reset your password to the default password.
Listing existing POP/FTP
Accounts:
From the control panel, choose the "List all user accounts"
option.
The listing will look something like:
----------------------------
Username: example
Pop email access: Yes
Ftp access: Yes, with home directory:
/home/example
----------------------------
Displayed will be the list of all POP and FTP accounts that have been created on your virtual server.
Adding POP Email/FTP
Accounts:
From the control panel, go to the "Add a new account" option.
Displayed will be a form asking for username and account information. This is where you set up POP accounts and FTP accounts. Information about each form field is below:
Clicking the Add the User button will create the account for you after you have entered the appropriate information into the form. After adding a POP/FTP account, if the process was successful, it will display a message affirming this. If the message displayed notifies you of an error, check to see what kind of error it reads and act accordingly. The most common error is to add a duplicate username (you can't).
Modifying POP/FTP
Accounts:
From the control panel, go to the "Modify an existing account"
option.
This option has three purposes:
1.) to actually correct or modify an existing account
2.) to give ftp access to directories that are longer than the 8 character
username allows
3.) to change the directory access an FTP account has access to
Displayed will be a form that asks for the username to modify. Information on the form field follows:
After entering the account name to modify and clicking the Modify the User button, you will be prompted with another set of forms, that displays the current information for that account (Real name, allowed services, etc.) This is where you make the actual modifications for that particular account. Listed below is information on the form fields you can modify information in:
After making the modifications and clicking the Modify the user button, the account information change will be saved.
Since FTP accounts have a limit of 8 chars in the
username, you would not be able to have a FTP account have access to a directory with more
than 8 chars unless you modified the home directory they had access to with this option.
(ie. you have an FTP account called 'mycomp' but you wanted it to have access to the
'mycompany' directory under your htdocs directory, this is where you would make that
possible). Also, if you wanted the 'mycomp' FTP account to access a different directory
other than the default ('home/mycomp' or '/www/htdocs/mycomp') you would make the change
with this option, as well (ie. you would change the home directory information from the
default like '/home/mycomp' to some place like '/www/cgi-bin'). If you make a change to
the home directory, MAKE SURE that directory already exists on the virtual server,
otherwise, you will need to create that directory via FTP.
Deleting POP/FTP accounts
From the control panel, choose the "Delete an existing account"
option.
This option is used to do exactly what it states, delete an account. You will be prompted with a form asking for the account name to delete. Simply enter the name of the account and click the Remove the User button to delete that specific account.
System Utilities
Setting permissions on any file
From the control panel, choose the "Set File permissions on any
file" option.
This option is used to change the permissions (file
characteristics) on a certain file via the CHMOD command. Unix files have a set of
"permissions" that tell the operating system how to handle the file. In some
cases, you identify the file is being readable (able to read the file), or writable (able
to write to the file), or executable (able to execute the file as a program), or a
combination of any of these. Because some files need to be treated differently, this
option is made available to you. An example would be something like CGI scripts. CGI
scripts are executable "programs" on the server that are run to perform
functions like a guestbook or Counter. CGI scripts would be set to be readable and
executable (you have to be able to access the file [readable] and must be run as a program
[executable]). Another factor in permissions is the ability to set WHO can access the
file. The permissions allow you to grant only access from the owner (meaning only you can
access the file when you are on the server, not through the web since the web server can't
tell if you are the owner of the file just by browsing to it through your web browser).
This is where you can also set the file to be accessible by Groups and the World
(essentially meaning you allow anyone to access it even from their browsers). For more
information about permissions, check out a reference source on the UNIX Operating System
under CHMOD or PERMISSIONS.
You will be prompted with some form requesting information on the file's
location and how you want to set the permissions. Information about the form fields
follow:
It is advised NOT to change permissions on ANY file
or directory, UNLESS you have some SPECIFIC directions (for a script, etc.) that call for
you to do it.
Measure Disk
usage
From the control panel, choose the "Measure Disk Usage" option.
This option is used to show you the actual disk
usage of your virtual server. From the root directory through every sub-directory etc.
This disk usage utility will display the actual disk usage of your virtual server
(includes the server software, log files, any temp files, the configuration files, stored
e-mail, your web pages, etc...)
Untar a file
Once you have uploaded the tared file and created a directory for the
expanded files to go into.
From the control panel, choose the "Untar a file" option.
Click the Untar button to uncompress the file.
You may need to change the permissions on our servers to run the file.
Email Aliases
Configure Email Aliasing/Forwarding
From the control panel, choose the "Configure Email
Aliasing/Forwarding" option.
This option has two purposes:
1.) To let you set up e-mail aliases (multiple e-mail addresses to one POP
account)
2.) To let you set up e-mail addresses to forward to a certain POP
account, somewhere else.
You will be prompted with a number of form fields to enter information into, as well as buttons to view and/or remove aliases from the alias file. Information about the form fields are as follows:
Clicking the Add the Alias button will do
just that, add the alias/forward you wanted to setup.
Clicking the View the Alias File button will view all the aliases
and forwards setup on your server.
Clicking the Remove the Alias button after having entered an
aliased name in the "ENTER NAME" field will remove that alias from the alias
file.
Configure Email Aliasing/Forwarding to more
than one person
From the control panel, choose the "Configure Email
Aliasing/Forwarding" option.
This option has two purposes:
1.) To let you set up e-mail aliases (multiple e-mail addresses to one POP
account)
2.) To let you set up e-mail addresses to forward to a certain POP
account, somewhere else .
You will be prompted with a number of form fields to enter information into, as well as buttons to view and/or remove aliases from the alias file. Information about the form fields are as follows:
one@domain.com
two@domain.com
three@domain.com
Do not add a blank line to the end of the last email
address as this will stop the send.
Clicking the Add the Alias button will do just that, add the alias/forward you wanted to setup.
Designating a site-wide
default maildrop
From the control panel, choose the "Designate a site-wide default
maildrop" option.
This option is used to designate where the server should send e-mails addressed to somebody without a local POP account or e-mail addresses that were not defined as aliases. Displayed will be a form that asks for the e-mail address that you want setup as a maildrop for misdirected e-mail. To have mail redirected to a maildrop, enter an e-mail address in the field provided and press the "GO" button next to "Enable Maildrop". To have mail "bounced" back to the original sender rather than to a maildrop, enter an e-mail address in the field provided and press the "GO" button next to "Disable Maildrop". To view the current maildrop configuration, press the "GO" button next to "View Current Setup".
Configure Auto-responding Aliases
Autoresponders are complicated and powertool mail tools. An autoresponder is an e-mail address that when e-mailed bounces back a text message to the person that e-mailed the autoresponder. A good example is a newsletter. You could set up an autoresponding alias like 'newsletter@whatever.com' and upload your newsletter in the autoresponder area. When someone e-mails 'newsletter@whatever.com' they receive the newsletter in their e-mail account (the newsletter e-mail account, auto-responded with the newsletter as the e-mail back to the original e-mailer).
From the control panel, choose the "Configure
Autoresponding Aliases" option.
You will be prompted with a number of form fields requiring information
for the autoresponder. The information is as follows:
You must upload the autoresponder text file into the
'/usr/local/etc/responses/' directory otherwise the autoresponder will create a generic
message if it can't find the autoresponder text file you specify.
From the control panel, choose the "Block
unwanted e-mail (spam)" option.
This tool denies e-mail from unwanted addresses.
The address input box can contain a variety of entries specifying whose
e-mail you wish to refuse, including:
A specific user address - user@host.dom
Specifying an e-mail address will block any e-mail sent specifically from
that e-mail address.
A host or a domain name - host01.spam.dom or spam.dom
All addresses that end with this host or domain name are rejected. The
mail is rejected if this is either in the mail's FROM: address, or it is in the hostname
of the connecting SMTP client.
A specific IP network address - 123.123.123.123
All e-mail coming from the IP address of the SMTP client will be rejected.
To add an address to block, enter the address in the
input box (in one of the 3 formats from above) and click on the Add the blocked address.
To remove a blocked address, enter the address in the input box and click
on Remove the alias.
To modify an existing block you must first remove it and then add the
blocked address again.
Web Server Maintainace
Web statisics
From the control panel, choose the "WWW Server Information"
option.
This option is where you can find your web statistics information, as well as your logs (they work together).
Choosing the Graphical Statistics analyzer option displays:
Choosing the Examine Access Log option
displays the current access logs.
The Access log records access information to your server such as the date,
time, and identity of whoever is accessing the server.
Choosing the Examine Error Log option
displays the current error logs.
The Error log records all html and cgi errors encountered by the server.
This is particularly useful for debugging CGI scripts.
Your WWW server is set up to log all transactions to
disk files. These log files contain useful information about who is accessing your site
and what information they are looking at. On a heavily accessed site the files will grow
rapidly in size and consume your available disk space. This selection will clear the log
files and reset them back to 0 length.
(Note: This function will not work if you have manually changed your WWW
server logs from the default)
Clicking the Reset the logfiles button will
clear all the standard log files.
How to password protect directories
This option is a powerful tool in making parts of your web site secure either for personal or commercial reasons. Following the following instructions will help you in setting up the password-protected areas.
How to Password Protect Your Webpages Many of our users have parts of their website that they do not want to be available to the general public. Some have software that they want to make available only to people who have signed-up to receive it. Other might have some pages that are intended to be seen by members of their organization only. Setting up a password protected section of your website is fairly easy. This document covers the step-by-step instructions you need to follow to password-protect part of your website.
1. Tell your http server to allow .htaccess files. By default, your Apache http server controls all access to your site according to the permissions in one file. To change the permissions on a single directory, you first need to tell your server to recognize a special file, called ".htaccess" in that directory.
Here's what you need to do:
Download the server access configuration file using your FTP software. The file is located in the directory '/usr/local/etc/httpd/conf/' and is called access.conf. Edit this file and look for the line that reads:
<Directory /www/htdocs>
Find the first line after this that starts with:
AllowOverride
If this first line says 'AllowOverride All' you can skip to step 2 below. Otherwise, change this line to read 'AllowOverride All' Save your changes and FTP the file back to the server. Remember to FTP in ASCII or TEXT mode!
2. Make a directory under 'htdocs' that you want to secure. You can only password protect a directory of files, not simply a single file. (Although you can, of course, place only one file in the password protected directory.) The next step is to create the directory that you want to protect, and move or add your files to that directory. For this example, I will use the directory '/www/htdocs/protected'.
Here's what you need to do:
3. Create a .htaccess file in the protected directory. On your local machine, create a file that contains the following lines:
AuthUserFile /usr/local/etc/htpasswd
AuthGroupFile /dev/null
AuthName MyCompanyWebPassword
AuthType Basic
<Limit GET PUT POST>
require user pumpkin
</Limit>
You can change some of these lines, as follows:
When you've finished creating this file, FTP it into your protected directory, and make sure to call it .htaccess in that directory.
4. Create a password for this directory. Use the
"Set directory passwords" option in the control panel to set the password for
your directory.
You will need to give:
5. Give it a try
If you've done everything correctly up to this point, you should be ready to try it out. Point your browser to http://yourcompany.com/protected/index.html (assuming you used the same directory that I did, and that you have loaded a file called index.html to that directory in step 2). Your browser should open a window asking for a username and password. Enter the username you used in step 3 ("pumpkin" in the example), and the password you set in step 4. If the browser lets you in, you're all set. Congratulations!
If your browser just displays the file without asking for a password, make sure you set up the access.conf file correctly in step 1. Also make sure that you named your permissions file .htaccess and placed it in the correct directory.
If your browser returns an error message, make sure the password file in your .htaccess file (see step 3) is the same as the file you put the password into in step 4.
Setting up or changing usernames and passwords that
have already been created.
Set the passwords for each of the users you want to change the password
for.
From the control panel, Choose the "Set username passwords"
option.
You will need to give:
Do this for each username you want to modify in the
.htaccess file.
Create multiple usernames/passwords
After testing that a password protected directory is
functional you may add new usernames and passwords to your password protected directory.
From the control panel, choose the "Create multiple
usernames/passwords" option.
Enter the directory path to the password protected directory.
It may look something like this.
/www/htdocs/protected
You may then begin to add usernames and passwords (one at a time).
Click on "Add the user".
The username and password has now been added to the .htaccess file.
If you are adding more username and password just click your back button
to add more.
CGI Tools
Set all cgi-bin programs executable.
Any Perl or CGI scripts that you upload to your cgi-bin need to have the 'execute' permission set. If this is not done you will receive an error message in your web browser that you don't have permission to access the script when you attempt to run it. Most FTP programs have an option that lets you set execute permissions for files that you upload. If your's does not have this option you can enable execute permission for your scripts by choosing this option. You can use this option to set execute permission for ALL CGI scripts in the CGI-BIN or you can use the "Set file permissions on any file" option to choose the permissions you set specific files to.
Clicking the Set all cgi-bin programs executable
button will turn the 'execute' permission on for ALL CGI scripts in the CGI-BIN.
Checking Perl CGI scripts for common errors:
Choosing the Check Perl scripts for common errors
option from the control panel, brings up the Perl checker utility. This utility can check
and automatically correct your Perl CGI scripts for some common errors. A form will be
displayed prompting you for the full path and filename of the Perl CGI script to check.
The form field is as follows:
Enter the name and the full path to the script:
(This is usually: /www/cgi-bin/name-of-script.pl
since most scripts go into the CGI-BIN)
Clicking the Submit button will run the Perl
checker on the specified Perl script.
The Perl checker runs the following tests (and automatically corrects some
of the common errors that may be found or provide some tips on correcting the problem). If
an error is found, the line of the error(s) will be displayed to help you track the
problem.
If there are any problems with any test, the error will be displayed after that test and any errors that could/couldn't be automatically fixed.
PLEASE NOTE! DO NOT use the Perl checker on
C/C++ compiled CGI scripts (like the Count.cgi or Whois.cgi scripts in your CGI-BIN)! The
Perl checker has been known to corrupt compiled scripts and render them useless.
Reseller Information
Adding virtual host cpanel
(Note: This option is only available on Server 2
Plus configurations AND if the virtual host domain name is in UST's DNS).
From the control panel, choose the "Add virtual host cpanel"
option.
This option is used to create the vpanel for reseller client accounts.
Once you have setup the Virtual Host control panel your virtual hosts will access their
cpanel using the virtual host directory name. They will not use the username of cpanel. A
POP account for a virtual host is not email. If your client wants email they can set it up
in their WAMT or Web Administrator Management Tool (Virtual Host Control Panel). They
would use a user (POP email) account to check the email.
When accessing your clients vpanel you must use their domain name. Do not use your domain name or the IP address.
Adding Front Page extensions to a Virtual Host
(Note: This options is only available on Server 2
Plus configurations AND if the virtual host domain name is in UST's DNS).
From the control panel, choose the "Add Front Page 98 to Virtual
Host" option.
When you add Front Page extensions to your virtual host it will not make a
new copy of the Extensions. What it will do is make a subset of the config files for the
FrontPage extensions to use when they are accessed by the virtual host domain name.
The Username is for the virtual hosts and that is used when the virtual
hosts wishes to publish his Front Page Web.
The Password is also used for the virtual hosts when publishing their web.
--NOTE-- The virtual hosts needs a unique username and password to restrict their access
to their domain only.
The Home Directory is the directory for the virtual hosts inside the
htdocs directory such as: virturahostdomain.
Click on the add user button and the setup will be complete.
Configuring advanced e-mail for virtual hosts
This option is used to setup e-mail accounts (aliases/forwards) for virtual hosts under RESELLERS. The configuration is similar to the configuration of standard e-mail aliases and forwards. Using virtual hosts, many domains can share a single IP address. This causes a dilemma for e-mail as there is no default way to differentiate between webmaster@virtual-1.com and webmaster@virtual-2.com - both addresses are just delivered to "webmaster" on the server #2 domain. As most websites, would like to use e-mail addresses like "webmaster" or "sales" with their domain, another method has to be used.
From the control panel, choose the "Advanced
e-mail for virtual hosts" option.
First, either a unique POP account must be created for each virtual domain
(using the "Add a new account" option) or a valid destination e-mail address
like joe@someplace.com must be specified.
The complete address, including the virtual's domain name, must be entered in the "ALIAS" field.
The "MAILDROP" input field should contain the address of the final recipient of the mail - either the name of the POP account added for the virtual host or a valid offsite e-mail destination (like a POP account with your ISP).
To add an alias, enter the virtual host e-mail
address you want in the ALIAS field and enter the destination in the MAILDROP field and
click the "GO" button next to "ADD THE VIRTUAL ALIAS".
To remove an alias, enter the virtual host e-mail address you want removed
and click the "GO" button next to "REMOVE THE ALIAS".
To modify an existing alias, you must first remove it and then add the
modified alias as you would when first adding it.
To view the current virtual host e-mail addresses set up, click the
"GO" button next to "VIEW THE VIRTUSERTABLE FILE".
Create cgi-bin's for virtual hosts.
This feature will add a ScriptAlias to your srm.conf
configuration file.
When virtual host call the scripts they have put into their cgi-bins they
will need to call it using.
From the control panel, choose the "Create cgi-bin's for virtual host" option.
Click on "Make the Virtual Host's cgi-bin"
Your clients may now begin using the scripts in their cgi-bin.
This program will unpack and install the files
necessary to run Ultrashop on your server. Please fill in all the information requested
below and click on "Setup Shop". The program will create the Ultrashop directory
structure, unpack the program and library files, and make the necessary changes to your
server configuration to make sure the files will run. Once the files are setup, you will
be able to go into the administration program to setup your new shop.
Directory to install shop in:
URL for this directory:
This is the URL that people will use to enter your shop. This URL must point to the directory that you give above or your shop will not work correctly.
Username for shop administrator:
Shopkeeper
Password for shop administrator:
********
Re-enter password:
********
Clicking on the Setup Shop button will setup the shop for you and
you may begin adding Items to your web store.
From the control panel, choose "Create a
Guestbook" from the reseller section of your control panel.
This program will create a directory called guestbook and add files for
the guestbook to that directory.
Click "Add the Guestbook" and the Guestbook
will be added to the site.
This works for both main accounts and resller virtual host accounts.
Windows, WS_FTP, Fetch, Thawte, Verisign, PGP, and any other company
references are affiliated with their respective companies and remain
a copyright/trademark of said respective companies. UST, Inc. claims no affiliation with
any of the aforementioned companies nor claims any warranty or
support for any products mentioned herein, in regards to aforementioned companies.
Contact us:
To place an order now call: 1-888-259-6871
For Pre-sales questions call: 1-910-484-5668
sales@USTeam.net