vqServer: Startup


This page tells you how to start vqServer and also describes some important configuration changes that may be necessary when you run vqServer for the first time on your computer. Most of the information on this page can be ignored the second time you start vqServer. The important steps (2 and 3 in the list below) can easily be automated using a batch file or script.

  1. Open a command-line interpreter window or console window. On a Windows 95 system, select Programs|MS-DOS Prompt from the Start menu.
  2. Change to your website directory. This is the directory you extracted vqserver.zip to. On a Windows 95 or Windows NT system type cd \website in the MS-DOS window and press the Enter key. Do not omit this very important step!
  3. Type jre -cp classes/classes.zip vq.server.console in the console window and press the Enter key. The absence of capital letters in this command is deliberate. A few initialisation messages will be displayed, followed by the vqServer console.
  4. If you are running other TCP/IP server programs (such as other web servers, ftp servers or mail servers) on your computer, you might need to change the administration server port before vqServer works correctly. If you need to do this, the message 9090: unable to listen will be displayed by the console during the startup process.
  5. If your computer is running a variant of the UNIX operating system (such as Linux or BSD) it may be necessary to change the main web server port from 80 to 8080 before vqServer works. If you need to do this, the message 80: unable to listen may be displayed on the console during the startup process.
  6. To confirm that vqServer is working correctly, start up your web browser, click on its Address box (usually under the toolbar at the top of the browser window), type http://localhost and press the Enter key. The vqServer default home page will appear in your browser. It'a a good idea to add this page to your browser's bookmarks or favourites list.
  7. Immediately after starting vqServer for the first time you should change the administrator password.
  8. Before using any Java servlets or CGI scripts you should check that vqServer knows your computer's name and IP address.
  9. To confirm that other computers can access your we site, go to another computer connected to your network, start up a web browser, type http://mycomputername/ in its Address box and press the Enter key. Your home page will be displayed.
vqServer
Register (free!)
Support

Contents

Installation
Web site management

Administration port
Main web server port
Password
Computer name

Changing the administration server port

If you are running other TCP/IP server programs (such as other web servers, ftp servers or mail servers) on your computer, you might need to change the administration server port before vqServer works correctly.

If you need to do this, the message 9090: Unable to listen will be displayed on the console during the startup process.

To change the administration server port:

  1. Activate the command-line interpreter window in which vqServer is running.
  2. Type AP and press the Enter key.
  3. Type in a number when prompted (any whole number between 1 and 32768 will do) and press the Enter key.
  4. If vqServer reports that the administration server is off, type the port number you chose and press the Enter key to switch it on. If the administration server starts successfully, this will be displayed by the console.

The remainder of this documentation assumes that you are using the default administration server port, 9090. If you are not, you will have to use the appropriate port number wherever you see 9090.

vqServer
Contents
Startup


Installation
Web site management

Changing the main web server port

On computers running variants of the UNIX operating system (such as Linux or BSD) it may be necessary to change the TCP/IP port of vqServer's main web server from 80 to 8080 before vqServer works.

If you need to do this, the message 80: Unable to listen may be displayed on the console during the startup process.

To change the main web server port:

  1. Start up your web browser, click on its Address box, type http://localhost:9090 and press the Enter key. You will be asked for a name and password.
  2. Type admin (no capital letters) for both the name and password and click on the OK button. The vqServer Control Centre welcome page will be displayed.
  3. Click on Settings underneath Main web server in the menu on the right-hand side of the welcome page. The main web server settings page will be displayed.
  4. In the edit box labelled Port, change 80 to 8080.
  5. Click on the Ok button at the bottom of the form. The servers page will be displayed.
vqServer
Contents
Startup


Installation
Web site management

Changing the administrator password

You should do this immediately after starting vqServer for the first time!

  1. Start up your web browser, click on its Address box, type http://localhost:9090 and press the Enter key . You will be asked for a name and password.
  2. Type admin (no capital letters) for both the name and password and click on the OK button. The vqServer control centre welcome page will be displayed.
  3. Click on Users in the menu on the right-hand edge of the welcome page. The users page will be displayed.
  4. Click on the icon in the Edit column to the right of the word admin. The admin user settings page will be displayed.
  5. Enter a suitable password in the Password box. You can also change the ID admin. vqServer IDs and passwords are case sensitive. Click on the Ok button. The amended users page will be displayed.
  6. The next time you click on a link in the control centre or try to start the control centre you will be prompted for a name and password. This is the name and password you entered in step 5.
vqServer
Contents
Startup


Installation
Web site management

Checking your computer name and IP address

Computers connected to TCP/IP networks such as the internet use names (often called host names) and IP addresses to identify themselves to each other. vqServer provides this information to Java servlets and CGI scripts (so that they can identify your computer to other computers accessing your web site). vqServer tries to figure this information out for itself during its startup sequence. However, there are some circumstances in which vqServer might not be able to do this or might do this incorrectly. You should therefore check and amend this information. To do this:

  1. Start up your web browser, click on its Address box, type http://localhost:9090, and press the Enter key. You will be asked for a name and password.
  2. Type in the administrator name and password and click on the Ok button. The vqServer control centre welcome page will be displayed.
  3. Click on System settings in the menu on the right-hand side of the welcome page. The System settings form will be displayed.
  4. Check the Computer name and IP Address in the first two lines of the form.
  5. If necessary, amend the information displayed and click on the Ok button.


vqServer version 1.03. Copyright © 1997-98 vqSoft and Steve Shering. Last updated 13 May 1998.

vqServer
Contents
Startup


Installation
Web site management