Sysquake Remote for Windows

This section describes the differences between Sysquake Remote for Windows and Sysquake Remote for Posix operating systems. Please refer to Sysquake Remote Installation for the description of all options.

Remark: Sysquake Remote for Windows is provided on request as a convenience to licensees. It is not officially supported.

Sysquake Remote for Windows Installation

Install Apache with mod_so enabled

Follow the documentation of Apache. If you install Apache as a service, you can make it start automatically in the Services application in menu Start -> Settings -> Administrative Tools. Every time you change Apache configuration file (see below), you can right-click the Apache line of the Services window and select Restart.

Install mod_sqr

Copy mod_sqr.so to the directory of Apache modules, typically C:\Program Files\Apache Group\Apache\modules.

Install Sysquake Remote libraries

Copy the lib directory and its contents to a suitable location, such as C:\LME\lib, which must be matched by the SQRLibraryPath directive (see below).

Configure Sysquake Remote

Edit httpd.conf (typically in a conf directory at the same level as modules) and add the following lines:

• To load the module:

LoadModule sqr_module modules/mod_sqr.so

• To enable the module:

AddModule mod_sqr.c

• To map files whose suffix is .sqr to make them processed by the Sysquake Remote module:

<IfModule mod_sqr.c>
AddType application/x-sysquake-remote .sqr
</IfModule>

• To add the registration key which enables Sysquake Remote (copy the whole line of the registration key exactly as you received it):

SQRRegistration webserver-hostname registration-key

or

SQRRegistration webserver-hostname registration-key name

If you have not received the registration key, you can skip this step now. Each .sqr page is displayed with a message which says that Sysquake Remote is not registered and the host name of the server. Please specify this host name, exactly as it is displayed, when you order your registration key.

• Add other configuration directives (see below). Options are secure by default, so this step is not absolutely required. Note however that to have access to LME libraries, you must add a SQRLibraryPath directive, such as

SQRLibraryPath C:\LME\lib

Restart Apache

In the Services application, right-click the Apache line and select Restart.

Configuration

This section describes the configuration directives which can be added to the files httpd.conf (main configuration file, usually in C:\Program Files\Apache Group\Apache\conf) and .htaccess (in directories), and whose default values differ from other versions of Sysquake Remote. All options are described in Section Sysquake Remote Installation.

Here is a possibility for such options. Note that only the SQRRegistration line is required, and that default options are secure by default; you should read carefully the documentation below before changing the options on a server on the Internet or in an insecure environment.

SQRRegistration www.company.com 6e8a.a81f.1924.200406.a
SQRStartup useifexists stdlib, sqr;
SQRLibraryPath C:\LME\lib
SQRLocalLibraries on
SQROutputLimit 10000
SQRTimeout 1000
SQREnableStderr on
SQREnableAns on

SQRCleanImagesCmd

Syntax: SQRCleanImagesCmd command

Context: server config

Override: n/a

This directive changes the command run periodically to clear the image files. The default value is a command which deletes all image files:

C:; cd C:/tmp/sqr; del *.*

SQRImagePath

Syntax: SQRImagePath path

Context: server config

Override: n/a

This directive sets the path where image files are stored on the server. The default is C:/tmp/sqr. If the bottom-most directory does not exist, it is created.

Differences in functions

Most functions work exactly the same way in all versions of Sysquake Remote. This section describes the differences.

http

HTTP variable.

Syntax

str = http(name)

Description

HTTP variable REMOTE_PORT is not supported.

cputime

CPU time in seconds.

Description

Not supported. You can use tic, toc, and clock instead.

dos

Execute an external command.

Syntax

status = dos(str)

Description

dos(str) executes a command with the Windows command interpreter. No input can be provided, and output is discarded. dos returns the value that is returned by the command interpreter; 0 means that there is no error (or that no error is reported).

Example

dos('del *.bak');

unix

Execute Unix command.

Description

Not supported. You can use dos instead.