On this page you'll find detailed information and instructions about how to use the various features of your virtual server.

If you require further assistance or wish to receive additional information not listed here, please contact our friendly customer service department:

Customer service e-mail: support@starenterprise.com
Customer service telephone and fax: +49 (0) 9225/96893

Server administration [go] General directory structure
[go] FTP, FTP-over-SSH2
[go] Admin panel
[go] Data recovery *
[go] Unlimited e-mail addresses
[go] Access to logfiles
[go] Change your password
[go] Notes regarding auto updates
Web development [go] SSL encryption
[go] Multiple domains *
[go] Autoresponders *
[go] Website statistics
[go] Error handlers
[go] .htaccess
[go] Language recognition
[go] Java and multimedia files
[go] Private diskspace
Software and add-ons [go] SunnyScript software *
[go] CGI software
[go] Multimedia objects
[go] WAP
[go] UCE filter

Important note: All features which are marked with a star (*) must be set up / managed by our customer service.

General directory structure...
Path / File name
Description / URL
/ Server root (start directory for FTP).
/.<Object name> Various system related files and directories.
/www Virtual server's base directory.
/www/cgi-bin Directory for CGI software.
Example: http://www.sunnyscript.com/cgi-bin/
/www/errordocs Directory for error handlers; may be shown instead of the default error messages.
/www/htdocs Directory for websites and other public files.
Example: http://www.sunnyscript.com
/www/logs Virtual server's logfiles.
/www/mailresp Source text files for autoresponders.
/www/space Directory of the private diskspace.

Important note: Please don't remove or modify any of the files or directories listed above. Such actions may lead to unusual behavior of your virtual server.

FTP, FTP-over-SSH2...
Your virtual server's FTP service allows to transfer files and to execute various commands.

A list containing all implemented commands is available by typing remotehelp or remotehelp <command> at the FTP command prompt.

In order to transfer data securely, the virtual server also accepts connections by using FTP-over-SSH2 on the common FTP port 21.

Please contact our customer service regarding additional information.

Admin panel...
The interactive web-based admin panel allows file uploads, e-mail handling as well as some other administrative tasks you may find useful.

The login is done by using the username and password of your virtual server.

More information on how to start and work with the admin panel can be found in the mail "Technical details / virtual server configuration".

Data recovery...
If you mistakenly removed files from your virtual server, our customer service is able to recover them in most cases for you easily.

Please contact us as soon as possible within the first twelve hours; during this time, all files are kept on optical discs and can be recovered mostly free of charge.

Important note: Older versions must be taken manually from magnetic tapes which requires charging a fee because it's very time consuming to find specific file(s) on tapes.

Unlimited e-mail addresses...
Your virtual server provides an unlimited number of possible e-mail addresses (universal mail alias); so all incoming messages are surely delivered to you.

Important note: If you own multiple mailboxes, only one can use the universal mail alias at a time; the other mailboxes have access to their assigned e-mail addresses.

This feature can be also deactivated to allow just certain addresses. If you desire this way, please contact our customer service.

Access to log files...
In addition to the generated usage statistics, you also have direct access to the raw log files via FTP. They are located at the /www/logs directory:
 
Path / File name
Description
/www/logs/acccess_log Logfile containing access done via the web service.
/www/logs/error_log Logfile containing error messages; ideally suited for debugging CGI software in a convenient way.

In order to retrieve useful information from the logs, you need special software which is available for most computer platforms on market.

Both logfiles will be processed and cleared by the installed statistic software daily.

Change your password...
For security reasons it is recommended to change the password of your virtual server regularly. This can be easily done via the admin panel at any time.

Forgot your password ?

Please contact our cusomter service. They will ask for some personal details and then set back the password to a default value after successful identification.

Important note: Our customer service will never ask for your password. So please keep this information confidential and don't share it with others.

Notes reg. auto updates...
As soon as updates are available for particular system components, they become installed automatically on your virtual server.

In this way, your virtual server is kept always up-to-date; during the update procedure, the system stays alive completely, of course.

If you desire, please ask our customer service for details about recently done updates.

SSL encryption...
SSL for web services

Data transfers can be encrypted by using the powerful SSL (secure socket layer) method; recommended for e-commerce applications and during the submission of personal data.

The scheme for creating SSL-URLs matching to your virtual server can be found in the mail "Technical details / virtual server configuration".

SSL for mail services

Depending upon the used e-mail client, the following modifications are neccessary being done to the existing configuration (basic details):

1. Instead of the mail servers' domain, use the SSL one (without adding further path info).

2. Enable SSL in mail client properties, e.g. "Use secure connection" or "SSL required; alternate port" (please also refer to the concerned documentation).

3. In rare cases it is necessary to change the port numbers. Choose port 995 for the POP protocol (default value 110) and port 993 for the IMAP protocol (default value 143).

Multiple domains...
Your virtual server can manage multiple domain names, where each domain may be even pointed to a particular directory.

Please contact our customer service for details regarding this feature.

Autoresponders...
An autoresponder will automatically send a reply to incoming e-mails. For each single e-mail address you can let us configure a separate autoresponder.

You may alter the message for each autoresponder by yourself. The concerned text files are located at the /www/mailresp directory.

In order to set up autoresponders, please contact our customer service.

Website statistics...
On each virtual server we have installed MagicStatistics (graphical statistics analyzer), which creates automatically easy-to-read website usage reports.

Before you start working with MagicStatistics or modifying any of the default settings, it is strongly recommended to read the software manual carefully.

If you have questions regarding this product, please contact our customer service.

Error handlers...
During an error situation (e.g. trying to call a non-existing webpage) the virtual server will respond with a standard english system message.

But likely you want to use HTML documents fitting better to your website's layout. This is possible for the following error situations:
 
What happened
Explanation
Filename*
403 - Forbidden Client requested a document that is not accessible to the public. error403.htm
404 - File not found Requested document was not found ("wrong URL used"). error404.htm
406 - Incompatible Requested document is not available in the desired (language) type. error406.htm
500 - Server error CGI software is configured incorrectly or generated a runtime error. error500.htm

* Files must be located in the /www/errordocs directory.

Important proceeding notes

Custom error pages should state clear the occured error and also show an e-mail address to allow people getting in touch with you to report problems.

Furthermore we strongly recommend to refer to implemented images and links only in URL format (e.g. http://www.sunnyscript.com/sunny.gif).

.htaccess...
Your virtual server supports .htaccess files for configuring particular folders within the directories /www/htdocs and /www/cgi-bin.

Some popular applications
 
Command
Description
options -indexes Prevents showing a directory index, if no valid start file is available.
deny from <ip addresses>
deny from all
Specified IP addresses are not allowed to access the concerned directory.

Sample: deny from 123.45.67.89, 123.456.789.0

directoryindex <filenames> Create your own list of start files.

Sample: directoryindex alternative.htm index.txt

redirect <oldpath> <newurl> Instead of the original path, a new URL will be called.

Especially suited when having no more existing but still requested files (as an alternative to error handlers).

<oldpath>: Absolute path of the file being replaced
<newurl>: URL being redirected to instead of

Sample: redirect /www/htdocs/oldfile.htm http://www.sunnyscript.com/newfile.htm

addtype <format> <ext> Addition of a new file type.

<format>: Desired MIME type
<ext>: File extension, this type should be used for

Sample: addtype text/html htm html

The configuration done in each .htaccess file takes effect to its concerned directory as well as to all included sub-directories.

Important note: Since the usage of .htaccess requires some extensive knowledge, it is recommended only for advanced people. For that reason, we may ask you to refer to available literature for more comprehensive information.

Please contact our customer service for further details regarding this feature.

Language recognition...
Your virtual server is able to detect the preferred languages of your visitors automatically (as set in their web browsing software's preferences) and delivers the correct webpages.

This feature is especially suited for international multi-lingual websites, because it saves you from creating a manual language selection page.

How to set up the language detection feature

It is done by using so-called "type-map" files; each has the extension .var ("variants") and contains a list of the available languages and their correspondent pages to call.

In most cases only the start file (e.g. index.htm) needs to be determined by language, since the concerned version of it contains already the matching links to sub-pages.

Creating a "type-map" file

Open a text editor and type in the language definitions according the following scheme:
 

URI: german.htm First option
Content-language: de Language short-cut
Content-type: text/html File type to deliver (MIME)
An empty line separates records
URI: english.htm
Content-language: en
Content-type: text/html
...

Please note that paths must be set relatively to the "type-map" file. Now save it (as text format) with the extension .var (like index.var).

Now, instead of calling the webpage directly, just use the "type-map" file within URLs, for example http://www.sunnyscript.com/about.var.

Catching exceptional situations (language not found)

If there was no matching language found, an error situation 406 will be generated:

It may be caught by an error-handler showing a custom page (for selecting languages manually). However this only allows to have one alternative page for the entire website.

So it's recommended to add a general record like this one to each "type-map" file:
 

URI: alternative.htm Alternative page
Content-type: text/html File type to deliver (MIME)

If the virtual server doesn't find a matching language, the alternative entry is displayed instead of (the page to call may be individually for each "type-map" file, of course).

Existing language short-cuts

For most languages there are unique abbreviations available. Finally, their support mainly depends upon the used web browsing software.

However there may exist different non-standardized abbreviations for artificial languages (e.g. Klingon) as well as dialects (e.g. american English and british English).

You may contact our customer service regarding an up-to-date language list.

Additional applications

Beside language detection, the "type-map" file method provides other versatile apps (e.g. to determine files by content with/without subjective quality factors).

Since this requires extensive knowledge, it may be only interesting for advanced people. For that reason, we may ask you to refer to available literature.

Java and multimedia files...
Your virtual server is able to recognize a huge number of file types (incl. Java applications) and forwards the correct type to the web browsing software automatically.

The latest file types list is available from our customer service at request.

Private diskspace...
It is possible to store files on your virtual server, which are not available to the public (via the web service), but accessible by FTP and the admin panel.

For this purpose, we created the directory /www/space.

This feature is especially suited for business agents and closed user groups or to keep an additional backup of files from your office desktop computer.

Important note: However it is not recommended to use this diskspace for sensitive and confidential data or for providing just a single backup of important files.

SunnyScript software...
SunnyScript offers a wide range of powerful software products for various business and Internet Commerce applications.

All products are available free of charge for usage on your virtual server (incl. unlimited technical support provided by us, except software modifications).

Detailed information about all software titles are available on the SunnyScript website.

If you're interested in a product and want to get it installed on your virtual server or just have more questions, please contact our customer service department.

CGI software...
Your virtual server has the ability to run CGI applications based upon Perl. In the following you find more information about CGI (Common Gateway Interface).

Usage note: These information are intended for advanced users; in case of questions, please contact our customer service department for advice.

Installation of CGI software

CGI scripts can be installed at any directory. However we recommend to create an own folder for each software title within the pre-defined /www/cgi-bin directory.

Each CGI application needs to be configured individually. Detailed information may be available at the documentation of the concerned software product.

Server Side Includes (SSI): All HTML documents which are intended to contain SSI calls must get the file extension .shtml or .shtm to be executed correctly.

Uploading programs and files

Before transferring files to your virtual server via FTP, please ensure that the configuration has been done according the software supplier's instructions.

Important note: Upload all files using the "ASCII" transfer mode of your FTP client; don't use "Binary" or "Automatic", because these causes errors when executing the software.

Each executable file (mostly ending with .pl or .cgi) must get the file permission 755 (or higher). Otherwise the software cannot be started correctly.

Final technical notes

Your virtual server uses the default paths to internal functions and commands as they are valid in a general Unix environment (so taking over the pre-set values will work mostly).

In case of installation problems, please consult the customer service department of the software supplier first.

It's a matter of course, that our customer service also provides assistance and takes over installation of 3rd-party products at special request.

Multimedia objects...
Various multimedia file types can be implemented into websites by using the HTML command "object" together with matching parameters.

Shockwave Flash

Copy the Shockwave Flash files to your server and embed them according the following sample to your webpages:

<object width="500" height="300">
<param name="MOVIE" value="animation.swf">
<embed src="animation.swf">
</embed></object>

This shows an object with dimensions of 500*300 pixel (simply change the file name and object size according your requirements).

WAP...
WAP (Wireless Access Protocol) was developed by leading communication companies and allows the creation of websites available through mobile phones and similar devices.

You just need to create WAP-based websites, uploading them and your virtual server delivers the correct format automatically to display these files correctly.

Please refer to available literature for in-depth information and support regarding WAP.

UCE filter...
Your virtual server comes with an integrated UCE filter (unsolicited commercial e-mail), which checks incoming mails and marks possible junkmail.

The filter uses a rule based system, positive and negative lists of 3rd parties as well as a self-learning, intelligent algorithm for highest-possible detection.

Any found junkmail will be marked at the beginning subject line using three hyphens, e.g. "--- Get rich soon !").

This flag can be used by e-mail clients for further processing, like filtering or moving of mails into a separate folder. Furthermore, the mail's header will show additional status information of the UCE filter.

Intentional we avoided more extreme actions, like manipulating the mail content; in this way, also falsely marked messages can be handled as usual.

Important note: No mail filter works absolutely error free; therefore we can't recommend to delete mails marked as UCE without reviewing them.