products support contacts about

Support Documentation

Please read on for support on the following areas.

Maintaining your Website

Maintaining your Tomcat Web Application

Sending and Receiving Email

Getting Started with RSA Shell Access

Accessing MySQL

For any other support enquiries, please contact us by email or phone.

Maintaining Your Website

To maintain the files in your website, open an ftp connection to ftp://sydney1.qnix.com.au, and provide your Qnix FTP account username and password when prompted.

Once connected type in dir, and unless you have multiple domains delegated to Qnix, you should see something like this:

200 PORT command successful.
150 Opening ASCII mode data connection for file list.
drwxr-xr-x 2 username username 4096 Apr 18 10:16 cgi-bin
drwxr-xr-x 2 root     root     4096 Apr 18 10:16 keys
drwxr-xr-x 2 root     root     4096 Apr 18 10:16 logs
drwxr-xr-x 2 username username 4096 Apr 18 10:16 html

Note: If you do have multiple domains delegated, you will see a directory listing for each domain. Each of these contains a subdirectory structure exactly like the one above.

You only have write permission to the cgi-bin and web directories: cgi-bin is for all your cgi scripts. The web directory is for all your HTML and PHP. The contents of logs is generated by apache, and files are placed in keys by Qnix only if you require Apache ssl.

Maintaining your Tomcat Web Application

Accessing and Navigating the Qnix Tomcat Directory Structure

If you have subscribed to a package with Tomcat JSP / Servlet support, your web application directory structure is rather different to the standard directory structure above. ftp access to your tomcat directory area is as above. The ftp directory structure for subscribers to packages with Tomcat JSP / Servlet support is organized as follows (for certain packages, the Tomcat directory structure is located located under a directory called java, off the root directory):

200 PORT command successful.
150 Opening ASCII mode data connection for file list.
drwxr-xr-x 2 username username 4096 Apr 18 10:16 conf
drwxr-xr-x 2 username username 4096 Apr 18 10:16 logs
drwxr-xr-x 2 username username 4096 Apr 18 10:16 webapps
drwxr-xr-x 2 username username 4096 Apr 18 10:16 work

Directory Name Directory Contents
conf

server.xml: See Tomcat Documenation on server configuration directives for more detail. Ordinarily, you will not find it necessary to modify this file.

tomcat-users.xml: The default Memory Realm configuration file. See Tomcat Documentation for more information on configuring realms.

catalina.policy: See Tomcat Documenation for more detail on how to configure the security policies implemented by the Java SecurityManager. Note that by default, Qnix do not run Tomcat with the security manager enabled.

web.xml: The default Web Application Deployment Descriptor for your application.

logs

catalina.out: output for the servlet container portion of Tomcat.

error.log: output from the standard error logger (org.apache.catalina.logger.SystemErrLogger)

tomcat.yyyy-mm-dd.log: output from the file logger (org.apache.catalina.logger.FileLogger)

webapps

This is where you should deploy your web applications, either in exploded or in war form. More information on deployment below.
work Scratch directory used by Tomcat for holding temporary files and directories

Managing your Tomcat Web Applications

Tomcat 4 includes a manager application to support the deployment and reloading of your other web applications. Your Qnix tomcat account includes access to the HTML version of this application. Full documentation of this application is available here. To access your manager application, navigate to http://yourdomain.name/manager with your browser, and use your Qnix username and password to authenticate yourself. You can change this username and password through tomcat-users.xml. The following information may help you get kick-started:

Deploy web application archive to http://yourdomain.name/appname
  • Create web application archive named appname.war. See Tomcat documentation on deployment for more information on wep application directory organization.
  • Transfer appname.war to your webapps directory.
  • Navigate to the manager application under http://yourdomain.name/manager, and login with the manager username and password defined in tomcat-users.xml
  • Type /appname in the Path field, and jar:file:/home/clients/yourdomain.name/webapps/appname.war!/ in the War-URL field. Watch out for the exclamation-mark before the trailing slash of the WAR-URL!
  • Click on install and check the tomcat and catalina logs for any errors during installation.
Deploy exploded web application to http://yourdomain.name/appname-exp
  • Warning: Do not use the same name for an exploded application as for an archive! Tomcat automatically explodes your archives into an exploded directory of the same name. At best your work will be over-written, and at works your JVM will fail!

  • Transfer your exploded application to your webapps/appname-exp directory.
  • Navigate to the manager application under http://yourdomain.name/manager, and login with the manager username and password defined in tomcat-users.xml
  • Type /appname-exp in the Path field, and file:/home/clients/yourdomain.name/webapps/appname-exp in the War-URL field.
  • Click on install and check the tomcat and catalina logs for any errors during installation.
Reload or Unload already-deployed web application
  • Warning: Do not attempt to reload or stop your manager application context. You will not be able to restart it without assistance from qnix technical support!
  • Navigate to the manager application under http://yourdomain.name/manager, and login with the manager username and password defined in tomcat-users.xml
  • Click on reload for the application context you wish to refresh.

JDBC Connection Pooling

PoolMan is a (GPL) embeddable object pooling and caching library produced by, and freely available from Codestudio.

Qnix provide a pre-installed and configured example poolman web application for each JSP / Servlet customer. This application is accessible at http://yourdomain.name/poolman. Documentation is included with this application. However, in the interest of another kick-start, the following information is provided:
  • You configure a connection pool through a file called poolman.xml, which must located in the WEB-INF/classes directory of your web application. The poolman.xml for your example application is therefore located in webapps/poolman/WEB-INF/classes.
  • poolman.jar must be located in the corresponding WEB-INF/lib directory.
  • You connect to the connection pool using a (virtual) JDBC URL of the form jdbc:poolman://poolname, and using the com.codestudio.sql.PoolMan driver.
  • Qnix provide tested JDBC drivers for MySQL (mm.mysql-2.0.8-bin.jar) and PostgreSQL (jdbc7.1-1.2.jar) in the default classpath. If you need to provide your own drivers, they should be placed in the WEB-INF/lib directory.

Sending and Receiving Email

When you first subscribe to a Qnix package which includes email, you will be allocated a default email account for each domain that you delegate to us (you may choose to a single account for multiple domains). The email address for this account is username@domain.com, where username is the your Qnix username.

To retrieve and send email using this or any other Qnix account, you can use any standard POP3 mail client (details below), or visit webmail.qnix.com.au.

POP server pop.yourdomain.com
POP user/password Your Qnix user/password
SMTP server smtp.yourdomain.com
SMTP port 587
SMTP user/password Your Qnix user/password

Note:Your email client must be configured to Authenticate outgoing SMTP connections. In Outlook Express, go to the Account properties and enable "My server requires Authentication" under the "Servers" tab

Depending upon which package you have subscribed to, you are likely to be entitled to a number of other email accounts to be created within these domains. Each account will be protected with its own username and password. Please mail support@qnix.com.au with your requirements.

Getting Started with RSA shell access

Shell access is authenticated by COMPLETELY separate mechanism to your ftp, pop and smtp, since the passwords for these protocols travel across the internet unencrypted, and can be intercepted. Instead, you access the shell using SSH with 1024-bit public and private key RSA (Rivest-Shamir-Adleman) encryption.

PuTTY is a freely available implementation of Telnet and SSH for Win32 platforms, which Qnix recommend for basic (free) shell access. More advanced users might want to consider a commerical alternative in which case, we can recommend VanDyke Software SecureCRT, which we use ourselves. For RSA access using putty you will need to download the following two applications:

Run puttygen.exe, and click on generate: The application will ask you to move the mouse around to supply some "randomness", and will then prompt you for a passphrase. This should NOT be the same as your Qnix password, which is inherently insecure.

PuTTYgen will then generate a public and private key pair. Save the generated (private) key to a secure place, not a shared drive or location where it can be accessed by anyone else. Copy the public key which comes up in the puttygen window to an email, and send it to keys@qnix.com.au.

Note:Please do not put the PRIVATE key anywhere where you think security could be breached: you will not only compromise the security of your own account, but that of the entire system.

We will then copy the public key into your home directory under .ssh/authorized_keys, and mail you back a confirmation that it is in place. Once you have received this confirmation, start putty.exe. You should see a window that looks like this:

Enter the following information:

Host name mail.qnix.com.au
Protocol SSH

Now select SSH from connection on the left hand menu. You should see a window that looks like this:

Select the private key file you generated using PuTTYgen with the Browse button, and ensure that the preferred protocol SSH protocol version is 1.

To test your connection, click Open. You will be prompted for a username, which should be supplied to you by Qnix (it is not your standard Qnix username), and the secure passphrase you specified when running PuTTYgen.

You should now be logged in to the shell! If you do not have access, please mail support@qnix.com.au with a description of your problem - we'll do our best to help.

Accessing MySQL

If you have subscribed to a package with MySQL access, you will have permission to create, maintain and drop any number of MySQL databases which adhere to the following naming convention:

username_dbname

where username is your usual Qnix username, and dbname is any string permitted by MySQL.

  • From the Shell

    Since your MySQL username is the same as your shell username, all you need to type is:

    mysql -p

    and enter your usual Qnix password when prompted.

  • From the Web

    You can manage your MySQL databases through a browser via https://www.qnix.com.au/phpMyAdmin.