Your Silver account domain is hosted on a Cobalt Raq3 Internet Appliance. A full manual for the product, including details of how to use your Site Administrator's Control Panel, is available to download from http://emea.cobalt.com/support/pdf/raq3manual.pdf
It is a lengthy download (2.8Mb), but you only need to read the section entitled Chapter 4 - Site Management, which covers site administration for your domain, and Chapter 5 - Using Services on a Site, which covers the user of most of the facilities available to individual users. Chapter 5 also covers the information you need to provide to any normal (site) users you create.
NOTE: Not all the features covered in this manual are available to customers. These include SSL certificates and Telnet/Shell access.
You may alternatively read the following edited highlights from these two chapters:
Introduction
There are three types of users on the RaQ 3: the RaQ 3 Administrator, Site Administrators and site users. You, as a Cymru 1 Silver service customer, are a Site Administrator. As such, you may create additional Site Administrators and as many site users (normal email users) as your account level allows.
This chapter describes the functions that the Site Administrator normally performs. The Site Administrator accesses these functions from the Site Management screen, accessible by logging in at http://yourdomain.com/siteadmin/ ---see later.
The Site Management screen has a green strip on the left side. A Site Administrator can add or remove a site user, create a mailing list, manage disk space, back up and restore files and perform other virtual-site-related administrative tasks (your web site at www.yourdomain.com or whatever is considered a virtual site because it is hosted on the same server as other web sites).
A Site Administrator can manage a virtual site using any standard Web browser. To access the Site Management screen for your site, type the URL http://<sitename>/siteadmin/ into your browser, where <sitename> is the name of your Silver service account domain (e.g. mydomain.com). The RaQ 3 user interface (UI) promps you for your site administrator username and password.
To access the Site Management screen, click Site Management on the Server Management screen. The Site Management screen appears.
From this screen, you can access the Site Administrator functions.
The User Management section appears when you first access the Site Management screen. The User List displays the site users by user name in ascending order.
The User List has five columns which display information about the each site user, and allow the Site Administrator to manage or remove a site.
• The first column displays the full name of the site user.
• The second column displays the user name of the site user.
• The third column displays the email alias(es) of the site user.
• The fourth column displays icons to indicate which services are enabled (telnet/shell access, FrontPage Server Extensions or Secure POP3 [APOP]), to indicate that a site user is the Site Administrator, or to indicate that a site user is suspended.
• The fifth column displays icons to manage a site user or the email settings for the site user, or to remove a site user.
To access a section of the Site Management screen, click the section button along the left side of the screen. These functions are described in the following sections of this document.
User management
The User Management section on the Site Management screen allows you to perform administrative functions related to site users: setting the site user defaults, adding or removing users; entering and modifying user names and passwords; managing users’ disk space allocations and email aliases.
Setting defaults for a site user
Before assigning the default values for a site user, you must decide on the needs of your users.
Both the Site Administrator and the RaQ 3 Administrator can configure the site user default settings.
To edit the default settings for a site user:
1. On the Site Management screen, click Set User Defaults.
2. Enter the information for the site. You can set the default value for
• the maximum allowed disk space (MB) available to a newly created user for their file storage and Web pages
• the number of sites users to display at one time in the user list on the screen
Note 1: Disk space for users comes out of the total disk space allocated to your Silver account)
Note 2: If there are more site users on a virtual site than the value you enter here, navigation buttons for scrolling through the User List table become active at the top of the table.
• the format for generating user login names
initial plus last name
last name
first name
You can also enable or disable services for FrontPage user Web and Secure POP3 (APOP), if the RaQ 3 Administrator has enabled them for the virtual site.
3. Click Save Changes.
Once you have configured the default settings, you can adjust the settings for each site user that you add.
Adding a site user
You can add or remove users for a virtual site, and assign a Site Administrator for the site.
Entering user email settings and aliases, Mail Forwarding and Vacation Reply
Individual site users can choose to have their RaQ 3 email forwarded to another email account. Site users can also choose to enable a vacation-reply message that is automatically sent to each person who sends the user an email. This feature is useful when users know they will not be reading or responding to incoming email messages for a period of time.
As the Site Administrator, you can enter these email settings for site users (at their request) as described in “Changing user settings” later on.
Note: A vacation-reply email is sent only once per week to each sender.
Email aliases
The Email Alias feature allows you to create an arbitrary e-mail addresses without creating a user account on the RaQ 3. An email message addressed to the alias is forwarded to an existing email address. For example, an email alias lets you setup a temporary or permanent alias email address such as sales@mycompany.com and automatically route messages to a specific email user's mailbox.
Each registered user on the RaQ 3 must have a username that is unique across all virtual sites on the RaQ 3 (i.e. not just your Silver account domain). You cannot create two users with the same name on different virtual sites because all users share the same password database file ( /etc/passwd ). For example, if there is a user with the username <mary> on virtual site abc.com, no other registered user on the RaQ 3 can have the username <mary>.
Usernames can be similar, however. (e.g. mary, maryb, mary1, mary2 etc)
An email alias is a way to create an account so that more than one user can have the same email name on different virtual sites (<mary> on
abc.com and <mary> on xyz.com). However, the underlying username for each person must be unique.
For example, the Site Administrator of abc.com can give Mary Brown the username <mary>; her email address is mary@abc.com. The Site Administrator of xyz.com (on the same RaQ 3) can give Mary Smith the username <marys>; the Site Administrator can then set up an email alias mary@xyz.com for Mary Smith. The alias points her incoming messages to the unique username of <marys> at xyz.com."
A site user can have several email aliases that point to a unique username. For example, John Smith (username <john1>) can have john@abc.com, JS@abc.com, john.smith@abc.com, johnny@abc.com and corvette@abc.com which all point to his username of <john1> at abc.com.
A Site Administrator can also set up aliases such as webmaster@abc.com, info@abc.com, sales@abc.com, comments@abc.com or support@abc.com that point to a specific username.
To enable an email alias:
To enable an alias for a site user:
1. On the Site Management screen, click Site Settings.
2. Click the check box for “Accept email for domain.”
Note: If this option is not selected, a sender must include the host name in the recipient’s email address, for example <alias>@www.abc.com.
Changing user settings
To modify the settings for a site user (to change the name, password, disk space allocation etc for an existing user, to enable FrontPage web use or Secure POP3 [APOP], to make an existing user the Site Administrator or to suspend a site user), click the green pencil icon.
1. On the Site Management screen, click User Management on the left.
2. Click the green pencil icon for the site user. The Modify User table appears.
3. Enter the changes in the Modify User table.
4. Click Confirm Modify.
Modify email options for a site user
To set up or modify the email options for a site user (to enter a forwarding email address, email aliases and an automatic vacation reply), click the blue envelope icon.
1. On the Site Management screen, click User Management on the left.
2. Click the blue envelope icon for the site user. The Modify User table appears.
3. To add a forwarding email address, enter the email address in the Forward Email To field.
4. To add an email alias, enter the additional names that the user will receive email as in the Email Aliases window. For example, for user <john1>, enter “john.smith”, “johnny” and “corvette”.
DO NOT add the domain name to the additional names. Since the site user is part of the virtual site, he or she automatically inherits the domain name of the virtual site. If you do add the domain name in the Email Aliases field (for example, johnny@abc.com), the software gets confused. To add several aliases, enter each alias on a separate line.
5. To enable an automatic vacation reply, click the check box in the Vacation Message field and enter your message in the window.
6. Click Save Changes.
Remove a site user
To remove a site user, click the brown trashcan icon.
Suspend a site user
The Site Administrator can suspend a site user on a virtual site. The site user is denied access to FTP, POP3/IMAP/APOP services, as well as Web access to their files. The site user account continues to receive email.
To suspend a site user:
1. On the Site Management screen, click the green pencil icon next to the site user you want to suspend. The Modify User table appears.
2. At the bottom of the Modify User table, click the Suspend User check box.
3. Click Confirm Modify. The User List table appears. The entry for the suspended user shows a red X in the fourth column; the full name, the username and the email alias of the user are grayed-out.
Backup
A Site Administrator can perform different types of backups via the control Panel. Please note that Cymru 1 Limited has found this type of backup relatively unreliable. We suggest you simply keep a copy of all files in your web site (both your main domain web site and that of any users) locally so that you can restore them via standard FTP if this is ever necessary.
!!Caution!!: A backup captures data only (for example, email messages stored on the server or Web files). It does NOT back up the settings for virtual sites or users.
!!Caution!!: You can use Microsoft Internet Explorer 3.0 to backup but not to restore a backup file. Upgrade to a later version of Internet Explorer or use a different browser software to restore the backup file.
Manual backup
A Site Administrator can manually back up data stored on the RaQ 3.
1. On the Site Management screen, click Backup. The File Backup table appears.
2. In “Data to Backup,” select the type of backup:
• All email, Web and user files on this site This option backs up the files for all the site users (including the administrator) and email, as well as the site Web and FTP data.
• Files and email of user This option backs up the files and email in-box for a specific user on this site.
3. To back up all files or to back up files changed within a certain time frame, choose from the pull-down menu adjacent to “Backup files modified in the last.”
You can choose “Backup all Files,” 31 days, 14 days, 7 days, 2 days or 1 day.
4. Click Start Backup.
5. Assign a path and a file name on your computer for storing the backup data. Click Save.
The file transfer takes several seconds to several minutes.
!!Caution!!: Do not interrupt or cancel the backup process. If you do, or if the file transfer fails for any other reason, delete the partial backup file stored on your personal computer and try again. If you attempt to use a partial file to restore data, you risk corrupting the data already stored on the server.
Scheduled backup
A Site Administrator can schedule regular automatic backups.
To schedule regular, automatic backups:
1. On the Site Management screen, click Backup. The File Backup table appears.
2. Click Scheduled Backup. The Scheduled File Backup table appears.
3. In “Data to Backup,” select the type of Backup, as described in step 2 in “Manual backup”
4. To back up all files or to back up files changed within a certain time frame, choose from the pull-down menu adjacent to “Backup files modified in the last.”
5. Choose the frequency of the automatic backup:
• Daily means nightly at 1 a.m.
• Weekly means every Sunday morning at 1 a.m. (Saturday night going into Sunday morning)
• Monthly means on the first of every month at 1 a.m.
6. Choose a backup method.
• FTP Server writes the backup file to an FTP server.
• NFS places the backup file on a mountable NFS resource.
• SMB Server (Windows File Sharing) places the backup file onto a directory shared from a Windows machine.
NOTE: Cymru 1 Silver customers must use FTP and not NFS or SMB.
7. Enter a location for storing the backup data. The location you specify depends in part on the backup method you select in step 6. See “Backup File Locations” below for an explanation of locations you can enter here.
8. Click Save Changes.
Backup file locations
For a backup by an FTP Server:
• A location of <username>@ftp.server.com puts the backup file in the initial login directory.
• A location of <username>@ftp.server.com/path/to/backups/ puts the backup file in the specified path on the server, using <username> to login.
For a backup by Anonymous FTP:
• For an anonymous FTP connection, the file must be put in a directory where anonymous FTP users have write access. This is generally the /incoming/ directory.
• A location of ftp.server.com/incoming places the backup file on ftp.server.com under the /incoming/ directory.
• The “Password” field should contain the password for the specified user or be left blank for anonymous logins.
For a backup by NFS Server:
• The location should be <server>:/<share> , where <server> is the NFS server and <share> is the NFS volume to mount and write to. You must have write privileges to this directory.
• The “Password” is ignored for NFS server backups.
For a backup by SMB Server (Windows File Sharing):
• The location should be <user>@\\windowspc\<share> . This mounts the volume share on the Windows server, using <user> as the login. The “Password” field must contain the password for <user>.
• For volumes that do not require a user, the location should be \\windowspc\share .
For All Scheduled backups:
• Ensure the target location is available and has enough disk space to hold the backup archive. Failure to do this may result in zero-length or truncated archives.
Restore
You must restore data from the same machine on which the data was backed up. Site Administrators can restore files only to their own site.
!!Caution!!: The system restores data only (for example, email messages stored on the server or Web files). It does NOT restore site users to a RaQ 3.
!!Caution!: You can use Microsoft Internet Explorer 3.0 to back up a Cobalt server but not to restore a backup file. Upgrade to a later version of Internet Explorer or use a different browser software to restore the backup file.
!!Caution!: The system does not merge the current and backed up data. When data is restored, any changes made to files on the RaQ 3 since the last backup are lost.
To restore a backup file:
1. On the Site Management screen, click Restore on the left. The File Restore table appears.
2. Enter the path and filename of the backup file, or click Browse and select the file to restore.
Note: If the file does not appear in the list and you are using Netscape 4.x or Internet Explorer 4.x, you might need to change “File Type” in the desktop to “All Files.”
3. If you want to restore only some of the files, click Selective Restore.
4. Click Restore A Backup File below the File Restore table.
Note: Restoring large backup archives can cause your Web browser to timeout. If you upload the “.raq” archive with FTP to the Administrator’s home directory, it is selectable from a menu on the restore screen.
Archive restores are not possible with Microsoft Internet Explorer version 3. If you experience problems uploading an archive, use a later version of Internet Explorer or use a different browser software to restore the archive.
Do not interrupt an archive restore because this can corrupt data. If the restore process is interrupted, the user can try to restore again.
To restore a user home directory or a site, make sure the user or site already exists.
When data is restored, the RaQ 3 and its corresponding parts (site, user and email) are returned to the exact state they were in prior to backup.
Developing Web pages
CGI scripts
The RaQ 3 supports common gateway interface (CGI) scripts, such as those written in Perl, C or other languages. If CGI is enabled for your site (see the Site Settings section of the Site Management screen), you
can add CGI scripts to work with your Web content.This enables you to develop highly interactive, powerful Web-based applications by building server-side CGI scripts that generate Web pages in response to specific user inputs. These applications range from simple scheduling and conferencing applications to sophisticated electronic commerce solutions.
You can develop CGI scripts on your desktop machine and then transfer them to the RaQ 3 by means of any FTP-based application that allows permission bits to be set to “Executable”.
Use FTP to upload .cgi and .pl files; use ASCII mode to upload CGI files. Once the file is on the RaQ 3, use your FTP program to make the script executable.
The path to Perl is /usr/bin/perl. CGI scripts must use .pl or .cgi filename extensions in order to be executed by the Web server.
Publishing Web pages using FTP
By default, whether you are a Site Administrator or an ordinary user, the files you upload using FTP are stored in your personal directory; the directory path is:
/home/sites/<sitename>/users/<username>
where
<sitename> is the fully qualified domain name of your site and
<username> is your user name.
Users who are not Site Administrators can edit their personal Web sites in the directory /web during an FTP session.
Note to site administrators: To post Web pages for your site, you must upload to the directory
/home/sites/<sitename>/web.
Only Site Administrators can upload to this directory. If you do not specify this directory, your Web pages are stored in your personal directory which is not accessible from the Web. The Site Administrator can access and edit the site root content in the directory /web during an FTP session. The site web root is accessible on the Web at http://<sitename>/.
Site Administrators can edit their personal Web pages in the directory /users/<username>/web during an FTP session. Personal Web sites are accessible on the Web at
• http://<sitename>/users/<username>/
• http://<sitename>/~<username>/
Publishing Web pages with FrontPage
If FrontPage Server Extensions are enabled on a site, a Site Administrator can open the site “root web” -- that is your main domain web site (www.yourdomain.com or whatever ) - using Microsoft FrontPage software.
To publish a Web page using FrontPage:
1. Using FrontPage Explorer on a personal computer, select Open FrontPage Web.
2. Select More Webs.
3. Type the exact virtual site host name into the Web Server field.
4. Click List Webs.
5. Choose the web named root web.
6. Click OK.
For FrontPage and FrontPage Web information and technical support, see http://www.microsoft.com/frontpage/ and http://www.rtr.com/
|