Configuration

The initial Q-GUIDE configuration is web-based and guides you through the various steps.

Depending on the installation and configuration of the web server, the URL (http://<server>/qguide/setup.php) for the configuration may be different.

At some points and after some steps, you may see the following waiting dialog:

Simply wait until this dialog is hidden again and you can carry out the next step.

00.a) Configuration start

Configuration begins with this page, and clicking extract Q-GUIDE files starts generating the final files and directory structure.

Note:

For the installation to proceed correctly, the PHP configuration variables upload_max_filesize and post_max_size must be set to at least 20M.

00.b) Configuration start

Once the files and directories have been generated, you can proceed to the next step by clicking Continue.

01.a) Configuration

Here you define the settings for

01.b) Databases (required setting)

01.c) Email

01.d) URL Availability (required setting)

01.e) Web service

The required settings are necessary for the further process, while the other settings can also be made at a later time (in the configuration files).

Once you have configured b-e, you can save the settings via Save Settings. Finally, you can check whether the database is reachable by clicking Check Database Settings. Without a database, the configuration cannot be completed successfully.

Clicking Continue takes you to the next step.

01.b) Databases

Server name	Name or IP address of the server for the database, for example localhost or 127.0.0.1
User name	Username for database access, for example user
Password	Password of the user for database access, for example password
Database name	Name of the database to be used, for example qguide
Database type	Specify whether MySQL/MariaDB or Microsoft SQL Server (including Express) should be used

Note:

The database connection check also ensures that the database you entered (Database name) already exists. If the database does not yet exist, it must be created beforehand. For a MySQL or MariaDB database, we recommend creating it with the utf8_general_ci setting.

01.c) Email

activate eMails	Specify whether you want to use emails () or not ()
eMail Sender address	Email sender address, for example mail@localhost
eMail Displayname	Email display name, for example Q-GUIDE
Typ	Choose a sending method (PHP eMail, Sendmail, or SMTP)
SMTP Host	Address of the email server, for example localhost or 127.0.0.1
SMTP Port	TCP/IP port for sending email, for example 25
SMTP Auth	Specify whether authentication (login) is required for sending emails () or not ()
SMTP User	Authorized user for sending email
SMTP Password	Password of the user for sending email
SMTP AuthType	Choose an authentication method (LOGIN, PLAIN, NTLM, or CRAM-MD5)
SMTP Secure	Specify whether encryption is required for sending email (SSL or TLS) or not (None)
Sendmail path	The full path to the sendmail program
Timeout	Specify how many seconds to wait for a response from the email server, for example 300

01.d) URL Availability

Server URL	The full address for accessing Q-GUIDE, for example http://localhost/qguide/
Root URL	The subdirectory in which Q-GUIDE is installed, for example /qguide/ or /

This information is used for step 5 (rewrite rules).

01.e) Web service

WS URL	The full address of the web service for data exchange with the Q-Matrix™ module, for example http://localhost/qguide/webservice/rest/index.php
Key	The license key of your Q-Matrix™ license
WS User	The user to be used for authorized data exchange (see also SVC settings)
WS Password	The password of the user for authorized data exchange (see also SVC settings)

02) Database

Click Create Structure and the database structure with the default entries will be generated.

Clicking Continue takes you to the next step.

03) Configuration files

Click Write Files and the configuration files will be generated.

Clicking Continue takes you to the next step.

04) Initial user

Click Create Root Account and the initial user will be created with the information you entered. This user is then also used for the first login.

User name	Initial username for Q-GUIDE, for example root
Password	Password of the initial user, for example root
eMail	Email address of the initial user, for example [email protected]
Salutation	Salutation of the initial user, for example Mr.
First name	First name of the initial user, for example Q-GUIDE
Last name	Last name of the initial user, for example Admin

Clicking Continue takes you to the next step.

05) Rewrite rules

Click Establish URL Rewrite and the rewrite rules will be generated for the web server in use.

Clicking Clean Folder (deletes files and directories that are no longer needed) takes you to the final step.

06) Final step

Click one of the two links

QGuide Aufrufen

QGuide Administration Aufrufen

and you can use Q-GUIDE with the initial user.