WizTom for the Web - Installing WizTom Web Proxy Server

This page deals with starting WizTom Web Proxy Server as a Windows NT Service to make the translated Web site or Intranet/Extranet application available to your users. However, it is recommended you read the WizTom for the Web Installation Guide for advanced options; only the basic commands are described here.

Copy all the files prepared with the Deployment Helper to the computer which will host WizTom Web Proxy Server. It may be installed on the origin Web server host, or on a different computer. We assume the files are copied to a folder named C:\WizTom on the server.

If you want to test WizTom Web Proxy Server on your computer, make sure WizTom Studio is closed. WizTom Studio already embeds WizTom Web Proxy Server, and running both at the same time may not work.

To install WizTom Web Proxy Server, the command line is as follow:

C:\WizTom>wizwebw.exe www.wiztom.com.the /install

This installs WizTom Web Proxy Server in the Windows Services and specifies the Multilingual Database to use is www.wizart.com.the. To effectively start the service, run the following command:

C:\WizTom>wizwebw.exe /start

After issuing the /start command, it is recommended to check Windows' Event Viewer to make sure the WizTom Web Proxy Server was started successfully. Please note that you may combine commands, such as e.g.:

C:\WizTom>wizwebw.exe www.wiztom.com.the /install /start

Please note: a warning message may be logged in the Event Viewer, mentionning that the WizTom Account could not be found. This account serves for security purposes but is not necessary to start WizTom Web Proxy Server. It is recommended you run the WIZUSERW.EXE utility on the production server; please refer to the Installation Guide for further information.

WizTom Web Proxy Server accepts a number of command line parameters to override the Thesaurus settings. For instance, the previous command line did not specify any port for the proxy, so users will have to specify WizTom Web Proxy Server's default port number (8080) in the URL, as in http://wiztom.server.com:8080/path/page.html for instance. It is possible to change the port of WizTom Web Proxy Server with the following command line, install and start the service all in one command:

C:\WizTom>wizwebw.exe www.wizart.com.the /proxyserverport:80 /install /start

In this case, because 80 is the default HTTP port number, users can access the translated Web site directly without specifying the port number, e.g.: http://wiztom.server.com/path/page.html. Please note that only one server at a time can use the same port number. This means that you cannot run WizTom Web Proxy Server on port 80 if the server machine already hosts a Web server, or any other server, on port 80. The configuration of one or the other server must be changed.

Finally, WizTom Web Proxy Server can be stopped with the /stop command:

C:\WizTom>wizwebw.exe /stop

and removed with the /remove command

C:\WizTom>wizwebw.exe /remove

Alternatively, you can also use the Windows Services Manager to start and stop WizTom Web Proxy Server. However, you will not be able to install or remove the proxy server with the Services Manager.

It may also be interesting to run WizTom Web Proxy Server in the console, without installing it as a service, for test purposes. In this case, the command line is exactly the same, but the commands /install and /start should not be used. For instance, this runs WizTom Web Proxy Server on port 80:

C:\WizTom>wizwebw.exe www.wiztom.com.the /proxyserverport:80

Please make sure WizTom Web Proxy Server is not already running as a service on the same port before trying to run this command.

The same remark as above, about different server software trying to use the same port, still applies.

To stop WizTom Web Proxy Server, make sure the Command Prompt window has the focus and press the combination keys Ctrl+C.