Home Page Service Features Other Services The Fine Print Order FriendlyHost.com Services Users Manual Reliability Information Support Information Contact FriendlyHost.com

Users Manual


Contents

CGI Usage

User Home Page

Publishing Web Pages with FrontPage

Using Telnet

Site Home Page

FAQ

Publishing Web Pages Via FTP


CGI Usage

You can save CGI files in any directory on your site, as long as CGI is enabled, the CGI file is executable, and the file ends with a .pl or .cgi extension.

The web server is configured to execute CGI scripts using a wrapper program (cgiwrap), which preserves the permissions set for the executing script.

------------------------How To Run Under CGIwrap-------------------------

NOTE: This examples uses the following domain information.  You would replaced these with your actual domain information:

Domain:  www.friendlyhost.com

Site: 1

User: randye

  1. Put your CGI file(s) in directory: "www.friendlyhost.com/cgiwrap" aka: "/home/sites/site1/web/cgiwrap/"
  2. Make CGI files user executable: "chmod 700 program.cgi"
  3. Change CGI ownership to a valid "domainuser:" "chown randye.site1 *.cgi"
  4. In "domainuser's" web account,(/home/sites/site1/users/randye/web), make a symbolic link back to the main CGIwrap area: "ln -s /home/sites/site1/web/cgiwrap/ cgiwrap"
    (NOTE: Dirname MUST BE: "cgiwrap") !!!
  5. Make sure that "domainuser" own's it! "chown randye.site1 cgiwrap"
  6. In your html, access cgi thru "domainuser's" account: http://www.friendlyhost.com/users/randye/cgiwrap/program.cgi


User Home Page

When users on a virtual site are created using the web- based administration screens, the user's home directory is:  /home/sites/sitename/users/username

The users default web page is: /home/sites/sitename/users/username/web

The content of their web pages can be viewed at: http://sitename/~username/



Publishing Web Pages with FrontPage

If FrontPage Server Extensions are enabled on a site, any site administrator may open the site root web 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 site hostname into the Web Server field.
4. Click the List Webs button.
5. Choose the web named root web.
6. Click OK.



Using Telnet

Telnet access is available -  it can be turned on for individual
users by the site administrator (via the User Management section
of the Site Management screen).

Warning:  Do not give someone you do not know telnet access.  If you grant someone access and they try to hack into our servers or anyone else's servers, your account will be automatically locked down by our security system.  We will then review the cause of the lock down and determine if your account will be reactivated, or terminated.



Site Home Page

The document root for the virtual sites web page content is:

    /home/sites/sitename/web

For example, www.friendlyhost.com would have a document root of:

    /home/sites/www.friendlyhost.com/web

Only the site administrator can upload to this directory. Web content in this directory is associated with the URL http://sitename/. For example, a page saved as:

    /home/sites/sitename/web/testdir/test.html

would be accessed via the URL:

    http://sitename/testdir/test.html



FAQ

How do I set-up custom error pages?

Custom 404 error pages can be set up using .htaccess. All you need to do is create a file in your web directory called .htaccess and place the following line in the file:

ErrorDocument 404 /notfound.html

Now whenever there is a 404 error from your web site, the users will automaticaly be redirected to http://www.yourname.com/notfound.html.

How do I password protect a directory?

Although we do not have a browser interface to allow this feature, it can be done with a telnet session.

For this example, we will show how to password protect a users Web page. You can apply this procedure to virtual sites also by changing the directories.

1. Telnet in, and login as the User.
2. Navigate to the directory you want to password protect.
3. Create the .htaccess file, it should contain the following lines:

# Access file
order allow,deny
allow from all
require valid-user
Authname DirectoryName
AuthPAM_Enabled off
Authtype Basic
AuthUserFile /home/sites/sitename/web/directory/.htpasswd/

Replace sitename and directory as appropriate.

Note: If you want to use the systems' /etc/passwd file for authentication you can eliminate the AuthUserFile line from the .htaccess file above.

4. Now you must create the .htpasswd file using the htpasswd tool.

a. Type the following command to create the file and add a user:

htpasswd -c .htpasswd username

b. You will be prompted for the users' password twice.

5. If you need to add additional users to the file, use the command above without the -c.

I upload my pages, but they do not show up on my site.

Is there a form mail on the server?

af.cgi can be installed on your domain, contact support and have them install it.

What is the path to cgiemail on this server?

cgiemail is not installed on the servers.  Use af.cgi, it is  much more powerful.




Publishing Web Pages Via FTP

After creating your web pages, you can publish them to the server using FTP. Rename of your choice to save as your main page (the default is index.html). Then launch your FTP software, establish an FTP link to the server, and then upload your HTML files. If you need help, consult the instructions for your FTP application. By default, the files you upload via FTP are stored in your personal directory, the directory path for which is:

    /home/sites/sitename/users/username

Where sitename is the fully qualified domain name of your site
and username is your user name.

Note to site administrators: To post web pages for your site, you must upload to the directory /home/sites/sitename/web. Unless you specify this directory, your web pages will be stored in your personal directory.

Once you connect via FTP you must issue this command "cd /web".  If you "cd web" without the slash mark, you will be in the web directory for your personal web directory.  If you use a graphical ftp program and you click on the first "web" folder you see, you are in the wrong directory.   You must enter the "cd /web" command.

Site administrators may 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 may 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>/ and http://<sitename>/~<username>/.  Users who are not site administrators may edit their personal web sites in the directory web during an FTP session.


Home Page Service Features Other Services Order FriendlyHost.com Services The Fine Print Users Manual Reliability Information Support Information Contact FriendlyHost.com