ADMCITY MANUAL


CHAPTER ONE - General Features

1.1) OVERVIEW

1.2) WHAT DO YOU OFFER?

1.2.1) Web space

1.3) HOW DO I USE THIS PROGRAM?

1.3.1) Mail related items

1.3.2) Managing the Linux Account


1.1) OVERVIEW

1.1.1) Definition of terms

Once your domain name is activated, you will be able to use your-domain-name.com instead of the IP# assigned. We highly recommend that you use your-domain-name.com instead of IP#. It's possible this number can be changed.

1.1.2) Support contact

For support questions, contact support@admcity.com.

Please include the login name and/or domain name you are referring to when you write to support. We can't yet tell from your e-mail address, unless we happen to remember working with you before, and we may need to know in order to help. If appropriate, tell us exactly what file(s) you are referring to.

1.1.3) Billing contact

For billing questions, contact billing@admcity.com.

Pay bills via credit cards or send payments to:

2320 Bryson Road, Bradley, CA 93426, USA

1.1.4) Sales contact

For sales questions, contact sales@admcity.com.

1.2) WHAT DO YOU OFFER?

ADMCITY offers storage space for web pages with global public access to those pages over the Internet. We also offer a limited form of program execution known as "cgi-bin". Our computers are Pentium-class machines running Apache over Linux. Apache responds to web page fetch requests from remote browsers while Linux is one of several variants of the Unix operating system.

1.2.1) Web space

Every customer gets his own password-protected userid under Linux. By logging into their userid, the customer gains access to their web storage space. Every userid "owns" a structure of disk subdirectories in the Linux file system. The "root" of this structure is the "home" directory, found at path "/home/userid". Note that this is somewhat similar to the MS-DOS directory structure, except that there is no drive letter and forward slashes are used instead of backward slashes.

Inside the home directory is a subdirectory named "www". Every customer has his own separate "www" subdirectory. Files placed in "www" are visible to remote browsers over the Internet.

For example, when a browser asks for URL http://userid.com/page.html, Apache looks for the file /home/userid/www/page.html and sends it out.

Now that we know where the files have to be located in order to be visible from the Internet, just how do we put the files there? There are several ways, depending on the local computer.

For the MacIntosh, a program called "Fetch" is used. Documentation on Fetch is not yet available. However, note that the binary mode referred to throughout the manual corresponds to the 'raw' mode in Fetch.

For Microsoft Windows systems, use FTP (See 1.2.1.3). This is the easiest method.

1.2.1.4) The "home" page and HTML

The filename of your home page should be index.htm. (or .html, .shtml, etc) The web server will automatically send the file at path /home/userid/www/index.htm when a browser only pecifies http://userid.com.

To learn how to write HTML, get Laura LeMay's books "Web Publishing with HTML in a Week", and "More Web Publishing with HTML in a Week" . Both are published by SAMS.

To count accesses, we have installed "wusage." This is preinstalled for you and updates on a weekly basis and you may check your stats by going to http://yourdomain.com/wusage/ with your favorite browser.

Log files are stored in your home directory as Access-logs

What are all the files and directories in my home directory?

www
..............This is your web directory. Place all your web files in there.

infobots..........This is where you will need to put all your infobot text files.

anonftp...........This is your anonymous ftp directory.

.redirect..........This is the configuration file for mail aliases.

How do I create my own "404 Not Found" error page?

Simply create/modify the missing.html file in your main web directory.

1.2.2) FTP Space

How do I use the anonymous ftp site?

Your anonymous ftp site is completely different from your web site.

When people ftp to your domain anonymously, they will see the following directories:

bin/ dev/ etc/ incoming/ lib/ pub/

-- "pub" is where you should put all your anonymously accessible files.

--"incoming" is for the anonymous users to upload files.

For security the following applies:

•Only the incoming directory can be written to anonymously

•Subdirectories are not creatable

•The incoming directory is not readable by people dropping files there

• You are responsible for any "pirated" software uploaded by the anonymous users. The anonymous ftp sites will be periodically monitored for any abuses.

You may ignore the other directories.

1.2.3) Telnet Account

A telnet account is just another name for Unix/Linux userid. When you sign up with us, you get a userid and password. You may ask for more than one such userid. Additional telnet setups are available in the form of a POP3 for a $20.00 one-time setup charge. Each telnet account has its own separate home directory but shares the same www and ftp directories.

Some of the programs available at the shell prompt are mail, a primitive email program, and pine,a more powerful email program, ftp, to FTP onto other sites, telnet, telnet onto other sites, pico, an easy to use text editor, vi, a not so easy to use (but standard) text editor, and in general a pretty complete POSIX environment.

At the shell prompt, type man and the name of the program to get instructions for that program online. If your problem is not knowing the name of the program, try apropos subject. (i.e. apropos mail.)

1.2.4) Listserver

The latest full release of Majordomo is available and each domain may request one for £15.00/per month. Additional listservers may be opened at a cost of £15.00/per month.

1.2.5) Domain Name

Domain names are being processed by InterNic within 1-4 business days: send us e-mail if your domain isn't activated within 5 days. We'll help you solve the problem.

If you want a domain name with a foreign extension, such as .it for Italy, we can do it! We will provide name-server information as needed so that you may complete the registration required for your country of origin.

Note that InterNIC charges $35.00/year for every domain. When you first apply for a domain, InterNIC will bill $100 for the first two years.

1.2.6) Cgi-bin Access

"CGI" stands for "Common Gateway Interface", a fancy name meaning computer programs running on the web server that can be invoked from a WWW page at the browser. The "bin" part alludes to the binary executables that result from compiled or assembled programs. It is a bit misleading because cgis can also be Unix shell scripts or interpreted languages like Perl. To run your own cgi programs, just put them in the cgi-bin directory.

1.2.7) Emergency Assistance

If a web server goes down, we want to know! email emergency@admcity.com

If support@admcity.com has not answered your e-mail within 24 hours, we also consider this to be an emergency. Send such emergencies to emergency@admcity.com.

1.2.8) 9+ character names

A name of anywhere from 3-16 letters is legal for e-mail accounts, ftp accounts, and telnet accounts.

1.2.9) RealAudio

RealAudio is a real time audio transmission/player system and is an available option for $9.50/month. A digital audio stream is transmitted from the server over the internet to the destination and played immediately, rather than being stored to disk first and then played.

Each audio clip requires two files: a metafile with extension .ram, and the digital audio clip itself, with extension .ra. The .ram file holds one or more lines of ASCII text, each of which references the .ra file to be played when the .ram file is accessed by the browser.

Entries in .ram files have the form:

pnm://your-domain.com/realaudio/your-domain/name-of-clip.ra

Place your .ram and .ra files in the realaudio subdirectory under your web directory. Contact support@admcity.com if you have not been supplied with the realaudio subdirectory. (note this account carries a extra charge)

.ram files must be uploaded in ASCII mode while .ra files must be uploaded in BINARY mode.

You may then access these files at realaudio/file.ram under your www directory.

1.2.11) Mail+

ADMCITY utilizes the sophisticated Mail+ mailing system. In addition to being able to have nearly unlimited infobots by simply adding text files to a directory, you can also redirect mail for everyone in your domain by simply modifying a text file.

INFOBOT EXAMPLE

Depending on the server you are on, you may find a infobot directory. If you have this in your home directory all your text files should be placed here for your autoresponders, otherwise you would just put them in the home directory

Example:

File in your /home/infobots directory is named help and says:



We offer you help.

Mail to help@yourdomain.com will return the message "We offer you help".

These messages can be any size, even 100K!

How do I see who is using my infobots?

Assume your infobot address is info@example.com.
Just put the following line in your .redirect file.

        info example@example.com


The original email message will be sent to example@example.com, and the
original sender will get the infobot text.

Infobot-generated and simple mailing lists

1. Setup infobot. For example, setup a welcome message in your infobot file - you can name it anything you like. For our purposes, we’ll call it “welcome.”

Example: “Welcome to my list server, please send all mail to name-of-list@mydomain.com.”

This message will be automatically returned each time someone subscribes (or requests said infobot)

2. Now you need to setup a configuration file to tell the mail system to build a mailing list in your maillists folder. In your infobot directory, create a file called infolist. This is used to tell the system what to do with addresses received from each infobot response. You can have as many lists as you want, for our purposes, we will set it up to write to a list called “newsletter.”

Here’s what the file should look like: Example: welcome newsletter (first line should be welcome, followed by a space, then newsletter). That’s all you need to do to create a list called newsletter. To further clarify.. WELCOME is the infobot message that is returned when someone e-mailed welcome@yourdomain.com. NEWSLETTER is the name we gave our mailing list, as defined in the infolist.

3. To send mail to the list (all people that requested the WELCOME infobot), send your email to newsletter@yourdomain.com and the Mail System will send it to the entire list.

TO ADD PASSWORD PROTECTION:

To password protect a mailing list, add a password to the first line of your email list. In order to mail to the list this password must be in the first line in the body of the message. (it does not get seen when mailed out) Anybody that sends to the list with out the password - will have their message sent to the default address in the .redirect file. You can then decide if you want them to mail to the list.

E-MAIL ALIASING (.REDIRECT) EXAMPLE
File in your home directory named .redirect says: (created as a text file, uploaded as .redirect)

((name of e-mail alias on left, one space, then forwarding address on 
right)):)



fred 73452.452@compuserve.com

jill jmason@mci.com

mike theguy@myplace.com

default tommy@c3p0.com



This would redirect mail for fred@yourdomain.com to 73452.452@cserve.com, etc. 

Mail to a user that was not in this list would be sent to the default user, 
tommy@c3p0.com 



Note: do not list your domain name with a forwarding address in the 
.redirect file. (say, if your domain name was tech2.com, do not put a 
tech2 in the .redirect file. Use a .forward file, if desired to forward, 
so as to not cause POP problems.

****************************

TO FORWARD all mail from the POP mailbox, create a text file that looks 
like:



yourdomain you@aol.com ((note, do not use extension of .com, .net, 
.org, etc. where it says yourdomain))



1.3) HOW DO I USE THE MAIL PROGRAM?

Note that with the exception of the description of using Eudora, the commands you are told to type in this section assume you have logged on to the server with telnet or rlogin.

1.3.1) Mail related items

1.3.1.1) mail

READING Type mail to see if you have any mail. If you have any mail hit enter multiple times and all your messages will be displayed.

SENDING type mail -s "juice" admcity@admcity.com<juice.msg to send the message juice.msg with the subject "juice" to admcity@admcity.com.

Type

    mail -s "juice" admcity@admcity.com

    juice is good

    .

to send the message "juice is good" with the subject "juice" to admcity@admcity.com

Type

    mail admcity@admcity.com

    juice is good

    .

to send the message juice is good with no subject to admcity@admcity.com

1.3.1.2) pine

Type pine to enter a more advanced mail program.

Type L to select Folder List and then inbox to see what messages that you have received.

The rest of this program is quite easy to use. Why use mail instead? Mail has the advantage that it is easy to send files that you composed off line plus it is easy to read many files at once into a log file that you then read off line.

1.3.1.3) Eudora is a mail program that runs under MS Windows.

Eudora connects to the mail server over the Winsock. Mail may be composed and read offline, but make sure that Winsock is running before attempting to send or receive mail.

After Eudora has been installed, it must be configured to point to the admcity mail server. To do this, start Eudora and select "TOOLS" from the menu bar. Then select "OPTIONS." Most of the options are self explanatory.

If you have multiple email addresses, you can install a separate copy of Eudora for each email address. Eudora "Light" is freeware offered by Qualcomm and can be downloaded over the net. Eudora "Pro" must be purchased.

1.3.2) Managing the Linux Account (login via telnet)

1.3.2.1) ln (redirecting file access)

Type ln -s fred.htm index.htm to redirect all file accesses from index.htm to the file fred.htm.

1.3.2.2) passwd (changing your password)

Type passwd to change your password.

1.3.2.3) zip/unzip

Type zip to zip files and unzip to unzip files. This program is compatible with the zip program for DOS. For example:

$ zip myzip file1 file2 file3

This puts the files file1, file2, and file3 into a new zip archive called myzip.zip. On the other hand, if you had the archive myzip.zip and wanted to get back the files:

$ unzip myzip

Typing zip or unzip by itself will give you a usage summary, showing nearly all the options available.

1.3.2.4) du (disk usage)

The Unix command

du -s directory

shows how much disk space is used by a directory and everything below it. While we work on creating the complicated command needed to automatically check all the directories you are associated with, you can find out how much space is in use by the WWW files for a domain with

du -s /www/htdocs/domain

If you don't have anything much in your home directory or mail spool, this comes close to the total space you have in use. (You would know if you did have other things in your home directory, and could use du -s $HOME to check on that.)

If you have an anonymous FTP area, also check

du -s ~ftp/my.domain

For example, snoopy.com might need to run some number of the following:

du -s /www/htdocs/snoopy

du -s ~ftp/snoopy.com

du -s $HOME

and add the results to find out how much space he's using.

Return To Menu