Configuring SwyxWare

After the installation the Konfigurationsassistent will be started. Use this Wizard to define the configuration parameters for the installed components.

The Configuration Wizard can also be started again later in an existing installation, e.g. in order to make changes to the SwyxWare configuration.


	Please note that the SwyxWare Configuration Wizard suspends all SwyxServer services. Even active calls are interrupted. It is not possible to telephone during configuration with the Configuration Wizard! If the Configuration Wizard is interrupted, all services remain suspended. If you terminate the Configuration Wizard, all services are restarted.

Under Configuration Wizard "Start|Programs|SwyxWare|SwyxWareConfiguration Wizard “ you can start the.

Enter here the SQL Server instance on which you want to set up the database for SwyxWare.

Select this form of authentication if the user currently logged on has administrative rights on the SQL Server.

Alternatively, select authentication with the name and the associated password of an SQL Server user.


	The Windows user account specified here must have administrator rights on the SQLServer instance to create a new database. If an existing database is to be updated, then administrator rights on this database ('db_owner') are necessary.

This is only possible if an SQL Server is installed locally. The standard settings are used in this case and the SwyxWare database schema is installed.

Enter a name for the new SwyxWare database and a user name with password. The user account under which the Configuration Wizard now accesses the SQL Server needs the rights of an SQL Server administrator ('sysadmin') in order to create the SwyxWare database.

Select an existing database from the drop-down list. For this, the user account specified in step (1) needs at least the rights of a database owner ('db_owner').

SwyxServer needs only restricted rights for database access. If you have selected an existing database, specify here the user name and password with which the SwyxServer should access the database.

For the rest of the installation the Configuration Wizard awards the necessary rights (db_datawriter; db_datareader; IpPbxUser) to the user account specified here.

You can also use "Restore" here to restore an existing local database, e.g. from an older SwyxWare installation.

You can create a backup copy of your database later (see chapter Backing up the SwyxWare Database).


	Please note that when using an existing database the update of the database is irreversible. The Konfigurationsassistent automatically updates the existing database of an older SwyxWare installation. In addition, a backup copy is made before the update of a local database. You can find this backup copy in the SwyxWare program directory under "\Documents and Settings\All Users\Application Data\Swyx\Backup".

Only local databases can be restored or backed up here. A database that is installed on another computer cannot be backed up or restored by the Konfigurationsassistenten. Use the mechanisms provided by Microsoft for this

Choose here whether you want to carry out a standard installation, or an installation for a scenario with enhanced failure safety (SwyxStandby option pack). In a standby scenario you enter the licenses only during the configuration of the master server.


	Always install and configure first the standby system and then the master system. This procedure is recommended, because for the configuration of the replication the standby system must already be installed and must run.


	If you already have configured a server as a master or standby server, this option will not be available when you run the Configuration Wizard again.

Here you set the user account which should be used to start the SwyxWare system services (for example ’ippbx’).

different components are installed on different computers (e.g. a separate gateway)

The user name should be selected by using the “Browse” button. You then only enter the password. The validity of your entries will be checked by the Setup program. This check may take several seconds. If there is an error in the entries an error message will appear and you can repeat the procedure.

If SwyxServer does not need a domain user account, you can let the Configuration Wizard create a local user account.

The service account will also be added to a locally created group called ’SwyxWare Services’. This group is used exclusively for the SwyxWare services.

The Konfigurationsassistent gives an overview of the user account used, and the created group.

If you chose the standard installation in step (5) (i.e. no standby scenario), you can choose here between

The current system (back end server) is configured as licensing server. The SwyxWare for Data Center license is read in on this system. All other SwyxWare for Data Center installations (front end servers) contact this installation to license themselves in turn. The reporting service must be activated on this server.

Enter here the name of the licensing server. The configured system then contacts the licensing server regularly to license itself.

Specify the SQL Server instance on which a reporting database was set up. Specify whether the Configuration Wizard should log on there with the current user account or with user name and password. For updating an existing reporting database, administrator rights ('db_owner’) on this database are needed in any case.

Select a previously created reporting database. The user account specified in (10) must be ’db_owner’ in this database.

The reporting service, which regularly records the license data of all servers, accesses the reporting database with restricted rights. Specify the user name and password for this access.

If you want to insert license keys, click on "Add License...". Another window, "Add SwyxWare License Key" will now open. Indicate whether you will enter a limited or a permanent license from your license certificate (PDF). The limited license key is sent to you as a PDF.

Enter the limited license or the name of the file containing the permanent license.

If you are licensing a SwyxWare for Data Center licensing server, you need only one license key.

The license key (PDF) supplied is limited to a period of 30days and includes the number of users and channels you have ordered. After the key is entered, the corresponding licenses will be shown.

Install SwyxWare with these limited keys and request permanent keys after installation. You then insert this permanent license key into the SwyxServer configuration at this point by activating the option "File with permanent license keys" (see chapter Managing licenses).

If you are configuring a master SwyxServer, enter here the name of the computer on which the standby SwyxServer is installed.

If this computer is not yet present or the name of the computer is not yet known, you must run the Configuration Wizard again after the installation of the standby SwyxServer.

A list of the Swyx services installed on the current computer appears. As default, all services on a computer work together with the other services on the same computer.

SwyxServer needs an email server to send voice mails, fax mails and usage reports (for SwyxWare for Data Center).

Enter the name of the mail server to be used for email delivery in the field “Name of the SMTP Mail Server”.

Every Email which is sent by the SwyxServer contains the Email address entered in the field “Voicemail originating address” as the sender. Enter here the email address of the SwyxWare administrator, for example.

From the selection list, choose the time zone that is applicable for the default location of this SwyxServer.

Enter your area code here without the preceding '0', for example, '231' for Dortmund or '40' for Hamburg. For Dortmund e.g. '231' or '40' for Hamburg.

The code for international calls is entered in this field. In Germany, this code is '00'.

Here you enter the digit(s) which must be dialed in order to make a long distance call. In Germany, the digit required for long distance calls is always '0'.

This is the number that SwyxWare users must first dial in order to make external calls. Default value: '0'.

You can integrate the SwyxWare user administration into a Windows Active Directory environment.

If the log-in user account doesn't have the according rights, please enter under "Register" a user account (name and password) which has the authorization to change the Active Directory configuration, e.g. a domain administrator account.

If you would like to set up your own FTP server, you can enter the required data in the SwyxWare Administration.

Define the user under which the KonferenzManager will later log on to the SwyxServer (default name: Conference).

The user "Conference" is always created. For SwyxWare Cconference rooms and conferences with more than three participants are only possible if you install the option pack "SwyxConference".

In a SwyxWare for Data Center installation, conferences become possible with the "SwyxAdHocConference" option.

If internet connections to new generation clients are required, activate the checkbox "Enable internet connections".

In the respective fields, enter the public server address (or port), which clients will use to connect to SwyxServer via Internet. (For further information please refer to chapter Connections to new generation clients.).

In the next step you let a master and a server certificate to be generated and set a password for the root certificate.

Via the SwyxWare Administration user interface, you'll be able to generate client certificates for the users desired.


	To generate the client certificates, maintain the password ready you used to protect the master certificate.

Only select this mode if you have your own certificates. The destribution of certificates is your task. SwyxWare stores no certificates but merely thumbprints

In the next step, you'll have to select the master certificate and the server certificate inferred from the master certificate in the corresponding dropdown list.

Should you not yet have imported your certificates in the Windows certificate storage, you can do so via the "..." button.


	If you change the mode for certificate generation and management at a later time, then all client certificates assigned to the users will become invalid.

23. After installation, set up ISDN trunks in the SwyxWare-Administration. The link to SwyxGate is via the name of the computer on which the service was installed.

You can specify here where the users' fax documents are stored. You can choose between

In this case please remember that there is a memory limitation depending on the type of database.

Thus, all files are stored in a local directory (default: C:\ProgramData\Swyx\IpPbxServer\Data\FileData). If the files should be stored in a network directory, a user account and password giving access to this directory must also be entered here.

If the memory location in the file system is changed from one directory to another, a prompt appears asking you to copy the files directly now. Please do not continue with the Configuration Wizard until all files are copied. The Configuration Wizard then checks the access to the files at the new memory location.


	If an existing installation is being updated, the change of memory location from the database to the file system or vice versa may take some time, depending on the quantity of files already present. In particular, all fax documents that the user has not yet (locally) archived will be loaded into the database.

Please note that when the database is backed up, these files must be backed up by the administrator. For further information please refer to chapter Backing up the SwyxWare Database.

28. Configuring the fax settings (This step is not required in SwyxWare for Data Center)

The displayed SwyxFax configuration takes place. As many fax channels are created as licenses are present. The configured Fax Station ID is configured on all fax channels, and can be changed later in the properties of the individual fax channels.

You should create a Windows task for the daily automatic updating of the licenses for system phones (the whitelist).
Activate the checkbox “Create planned task”. A new task “PhoneWhitelistUpdate” is created in the Windows task planning and executed once only. That is to say, the whitelist is updated immediately. For further information please refer to Install and update Whitelist.


	If you leave the checkbox “Create planned task” deactivated, any possibly existing tasks for automatic whitelist updating will be removed.

If you have installed a standby scenario, then after this Configuration Wizard the Configuration Wizard for the standby configuration is started (see chapter Standby-SwyxServer).

All services (SwyxServer, SwyxConfigDataStore, SwyxGate, PhoneManager, SwyxWareHelper, ConferenceManager) will be started automatically during the configuration and are ready for operation after the configuration.


	If you change the name of the server computer after the installation, please follow the instructions contained in this Technet article: https://technet.microsoft.com/library/ms143799.aspx

You will find information on how to install SwyxWare Administration in Chapter Installation of the SwyxWare Administration.

The Configuration Wizard creates a trace file ConfigWiz-<time in format yyyy.mmdd-hhmmss>.log. You will find this, like all other trace files, in the directory <common_app_data>\Swyx\Traces. Here, <common_app_data> is the standard application directory of Windows, e.g. C:\Documents and Settings\All Users\Application info.