CHAPTER 5. Optional Features

5.1. RealAudio/Video®
5.2. Volano® Java Chat
5.3. Additional users on your domain
5.4. mSQL
5.5. MySQL


5.1. RealAudio/Video™


Real Audio or Real Audio/Video is available for an extra charge. See our fee schedule for details.

Real Audio is a real time audio transmission/player system. 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://machine-name.siteprotect.com/domainname/file.ra

You can find the machine name by telnetting into your account. You will
see a prompt such as "haydn:~$".  In this case "haydn" is your
machine-name.

Place your .ram and .ra files in the realaudio subdirectory under your
web directory. Remember that .ram files must be uploaded in ASCII mode while .ra files must be uploaded in BINARY mode. You may then access these files via a web browser at:

http://www.[yourdomain].com/realaudio/file.ram

 

5.2. Volano® Java Chat

You can order Volano Java Chat to be installed by filling out the form
at http://HostAvenue.com/support/add.htm

Instructions:

You will receive following information in your email:

 

DOMAIN NAME..........: [yourdomain]
Volano Chat has been added to your account.

FTP Host Name........: volano.siteprotect.com
Username.............: [username]
Password.............: [passwd]
URL of your chat room: http://volano.siteprotect.com/[username]/chat.htm


Getting Started

Add a link on your home page to point to the chat room. The link should
be to http://volano.siteprotect.com/[username]/chat.htm

An example html code for this is as follows:

<a href="http://volano.siteprotect.com/[username]/chat.htm">Enter Chat Room</a>


IMPORTANT: You must use above specified url only. Any other url will not work. For example, http://www.volano.siteprotect.com/[username]/chat.htm will NOT work.

You are done! You are now ready to use your own chat room.

Customizing Your Chat Room
When Volano Chat is installed, a default chat.htm page is created. This
is fully functional page and you can start using the chat room right
away. If you wish to modify your chat.htm page, you can do so by
following instructions below.

Step 1.
Please upload all your graphic files to /www/volano/xyz directory and
change the chat.htm file to something like this (do not try to upload to
the vcclient subdirectory, you won't be able to)

<p align=center>
<applet codebase="http://volano.siteprotect.com/xyz/client"
archive="COM/volano/MyVolanoChat.zip"
code="COM.volano.MyVolanoChat.class" width=500 height=130>
<param name="cabbase" value="COM/volano/MyVolanoChat.cab">
<param name="color" value="#FFFFFF">
<param name="group" value="The XYZ Chat Line">
<param name="text" value="english.txt">
<param name="color.background" value="#808080">
<param name="color.foreground" value="#000000">
<param name="font.default" value="Helvetica-13">
<param name="banner.code" value="COM.volano.BannerPlayer.class">
<param name="banner.param.banner.1" value="60
http://www.xyz.com/yourbanner1.gif
 http://www.xyz.com/">
<param name="banner.param.banner.2" value="60
http://www.xyz.com/yourbanner2.gif
 http://www.xyz.com/">
<param name="banner.param.banner.3" value="60
http://www.xyz.com/yourbanner3.gif
 http://www.xyz.com/">
<param name="image.button.width" value="88">
<param name="image.button.height" value="31">
<param name="image.button1" value="button2.gif">
<param name="banner.param.background" value="#000000">
<param name="banner.param.foreground" value="#000000">
</applet>
</p>


IMPORTANT: The name of page should be "chat.htm".  Any other name will NOT work. Make sure you replace [username] with your own username.

You will need to modify and add parameters to the applet tag to
customize your chat room. Modify the parameters you wish to change or
add new parameters inside the MyVolanoChat applet tag. We recommend that you do this only if you know what you are doing. If we have to rebuild your chat room, it will be charged at $45 per incidence rate.

Parameter Definitions:

<param name="color.background" value="#C000FF">
This parameter changes color of the chat room window, with color values
defined in the format #RRGGBB.

<param name="color.foreground" value="#000040">
This parameter changes the color of the chat text and the chat room
borders, with color values defined in the format #RRGGBB.

<param name="font.default" value="Helvetica-13">
This parameter changes the font type and font size. The font
specification is in the format name-style-size. For the best cross
platform support, the name should be limited to Helvetica, TimesRoman,
Courier, or Dialog. The style is one of italic, bold, or bolditalic, and
should be omitted for a plain style. The size is the font point size.
For example, you could specify: Helvetica-bold-13 or
Helvetica-italic-14. Be sure to use the correct cases as shown in this
example.

<param name="banner.code" value="COM.volano.BannerPlayer.class">
This parameter points to the ad banner player applet that rotates banner ads in your chat room. To turn your banner ads off, add this parameter and leave it blank. For example: <param name="banner.code" value=>

<param name="banner.param.banner.1" value="60 welcome.gif
http://www.volano.com/">
This parameter changes the first banner ad that shows up in your chat
room. Ads can be GIFs, standard GIFs or JPEG images. The numeric suffix
on each property (banner.param.banner.1, banner.param.banner.2,...,
banner.param.banner.n) must be sequential and start with the number 1. This suffix gives the sequence of the advertisement banners.

You must define at least 3 banner ads in order to override each of the 3
default Volano banner ads. For instance, if you only define
banner.param.banner.1 and banner.param.banner.2, then users will see the default Volano banner ad banner.param.banner.3. If you want to have only 1 banner ad, just list that one banner three times. Each banner must have three items, separated by spaces or tabs. The first item is the time (in seconds) to display the ad. The second item is the path to the image file (relative to the applet codebase or URL). The third item is the location of the Web page to display when the user clicks on the ad.

<param name="banner.param.banner.2" value="60 help.gif help.html">
This parameter changes the second banner ad that shows up in your chat
room.

<param name="banner.param.banner.3" value="60 chatwithme.gif null">
This parameter changes the third banner ad that shows up in your chat
room.

<param name="image.button.width" value="88">
This parameter defines the width in pixels of the button image that
appears on your chat.html Web page to allow entry into your chat room.

<param name="image.button.height" value="31">
This parameter defines the height in pixels of the button image that
appears on your chat.html Web page to allow entry into your chat room.

<param name="image.button1" value="button2.gif">
This parameter defines the button image that appears on your chat.html
Web page when you move your mouse cursor over the button. The image may be in GIF or JPEG format. This image should have the same dimensions as image.button.1.

<param name="banner.param.background" value="#C0003F">
<param name="banner.param.foreground" value="#000080">
This parameter defines the foreground and background color of the cell
where your banner ads are placed.

Step 3.

Upload the newly created chat.htm page using your FTP program. You
should use following information to log onto your Volano Chat account:

Host server name: volano.siteprotect.com
Username: [username]
Password: [passwd}
Directory: /www/volano/[username]/

[username] and [passwd] are provided in the email described above.

IMPORTANT: Only following file types are allowed to be uploaded: html,
jpg, gif. Any other file types will be rejected by the server.

Step 4.

To make sure that you are viewing your most recent chat room changes.
Hold your 'shift' key and then choose the 'reload' or 'refresh' option
on your browser to ensure that you download the latest applet when you reenter your your chat room. You may even need to clear your browser cache/temp files or restart your computer.

 

5.3. Additional users on your domain


If you have asked for additional POP/FTP/Telnet accesses on your domain, the users of these additional accounts can access the server via FTP, Telnet, and Email with the following parameters:

Hostname: yourdomain.com
Username: their unique username
Password: their unique password
POP Account: their unique username@yourdomain.com
SMTP Server: yourdomain.com
When they login via FTP or Telnet, they will be taken to the domain's
home directory.

 
5.4. mSQL

mSQL database can be setup by filling out the form here.
Here are some relevant information:
1. Directory paths to mSQL related files: /usr/local/Hughes/bin
2. Installed components: msql.pm, w3-msql, lite,Msql.pm perl module
 
Here's a sample way to connect to mSQL using Perl:

---------------------

#!/usr/local/bin/perl
use DBI;
$drh = DBI->install_driver( 'mSQL' );
die "Cannot install driver: $DBI::errstr\n" unless $drh;
$dbh = $drh->connect( "your_database_name:localhost" );
die "Cannot connect: $DBI::errstr\n" unless $dbh;

-----------------------

You can find more mSQL resources at http://www.hughes.com.au
Another resource for mSQL is at http://blnet.com/msqlpc/
IMPORTANT: There is a limit of 5MB for your database. You can purchase additional 2MB of disk space for $5/mo. If you have a large database that needs to be hosted, we invite you to contact our sales department to discuss customer solution for you.

NOTE: Support for mSQL means that you can use run mSQL database on our servers. It does not mean that we provide any technical assistance nor tutorial on the subject.

 
5.5. MySQL

MySQL database can be setup by filling out the form here.
Here are some relevant information:
IMPORTANT: Your MySQL database will be hosted on a dedicated MySQL server. There is a limit of 5MB for your database. You can purchase additional 2MB of disk space for $5/mo. If you have a large database that needs to be hosted, we invite you to contact our sales department to discuss customer solution for you.
 
1. Hostserver for MySQL: mysql5.siteprotect.com
2. You can access the database using Perl DBI (with DBD::mysql) or
Mysql.pm module.  You can also access it from the command line via
Telnet using mysql command.  The path is /usr/local/mysql/bin/mysql).
You can find more MySQL resources at http://www.mysql.com
Sample Script to Test Your MySQL Connection:

----------------------BEGIN---------------------------------------------
#!/usr/local/bin/perl
use DBI;
$server = "mysql_server_name"; #i.e., mysql5.siteprotect.com
$database = "your_database_name";
$user = "your_user_name";
$pass = "your_password";
$dbh = DBI->connect("DBI:mysql:$database:$server",$user,$pass);
die "Cannot connect: $DBI::errstr\n" unless $dbh;
----------------------END---------------------------------------------
NOTE: Support for MySQL means that you can use run MySQL database on our servers. It does not mean that we provide any technical assistance nor tutorial on the subject.