If you want to create a new server instance (virtual PBX) for a customer, copy the existing database of the template for this customer (see also chapter 5.4, Installation of a separated database, page 25) and generate a clone of the SwyxWare template.
How to generate a new virtual instance
1. Starting from the database of the clone template, and using the Backup&Restore mechanism, create a database for the customer.
2. Open the Virtuozzo management console (VZMC).
3. In the shortcut menu, choose "Tasks | Clone".
4. Give an IP address, or an IP address range for the clone template(s) in the case of multiple new instances.
5. Corresponding clones will be created, but all with the same host name.
6. Open the properties of a virtual private server and change the name to a unique name.
7. Start the virtual instance and then trigger a restart (reboot via cmd-line 'vzctl restart <ID>'). .NET Framework then adopts the new host name. The SwyxServer installed there accepts the new name of this instance too.
8. Create a new registration key under
"HKLM\Software\Wow6432Node\Swyx\General\CurrentVersion\Options" with the name "LocalIpAddress" (REG_STRING), and enter the frontnet IP address of the virtual environment.
9. Check the settings of the time zone. If one domain is used for all systems, synchronization takes place over the domain. Otherwise the administrator must check all settings.
10. Configure the SwyxServer with the help of the program IpPbxConfig, and specify the new customer data (see Configuration with
IpPbxConfig, page 29).
Alternatively, start the Configuration Wizard, which will prompt you for all the necessary parameters.
Assign the virtual PBX at least one other license ID with the command "ipPbxConfig /r", so that this will be entered in separate reporting.
11. Configure all SwyxWare services so that they are automatically restarted
12. Open a SwyxWare Administration and connect to the new system (local and remote).
13. In the SwyxWare Administration, change the SIP Realm in the server properties on the "Client Settings" tab (see SIP realm of the
clients, page 31). This realm must be unique.
14. Create a locally managed SwyxLink, which connects the front end system to the back end server. Check the registration and the record types in the SwyxWare Administration (see SwyxLink connection to the back end
server, page 31).
15. Then define the further parameters for this customer (see chapter 5.10,
Configuration of a customer installation by the provider).
Configuration with IpPbxConfig
IPPbxConfig is a program that is called from the command line. It is used for giving new cloned SwyxWare the corresponding unique parameters, e.g. name of the database and user. The database that was also copied for this clone is used here. You will find IPPbxConfig in the SwyxWare program directory.
You have the following options here: Parameters Explanation
/? Displays an overview of the available parameters of
IpPbxConfig.
/v Displays the current configuration of the SwyxWare
database and the reporting database. /ii <SQL Server
name>
Name of the SQL Server instance
Gives the name of the SQL Server on which the SwyxWa- redatabase for this PBX is installed.
Example:
• /ii <SQL-Srv>
<Name of the PC on which an SQL Server instance is installed> (global instance)
• /ii <SQL-Srv\Instance>
<Name of the PC on which SQL Server instances are installed \ Name of the instance> (named instance)
> Installation
30
/di <Database name> Name of SwyxWare database
Sets the name of the SwyxWare database for this PBX. /ui <User> Name of the SwyxWare database user
Gives the name of the database user under whose user account the PBX accesses its database. This user must be a member of the database roles "db_datareader",
"db_datawriter" and "IpPbxUser".
/pi <Password> Password of the SwyxWare database user
Sets the password belonging to the SwyxWare database user.
/ir <SQL Server name>
Name of the SQL Server instance*
Gives the name of the SQL Server on which the reporting database for this PBX is installed.
/dr <Database name> Name of the reporting database*
Sets the name of the reporting database for this PBX. /ur <User> Name of the reporting database user*
Sets the name of the database user under whose user account the PBX stores the reporting data. This user must have writing and reading rights.
/pr <Password> Password of the reporting database user*
Sets the password belonging to the reporting database user. /r Generates a new license ID for the virtual PBX
ATTENTION: This PBX will afterwards be recorded under a different ID in reporting!
/l Local security settings
Sets the settings and permissions of the SwyxWare services for the new virtual PBX.
/start Starts all SwyxWare services
/stop Suspends all SwyxWare services
/ex Outputs expanded error messages
/y Silent installation
IpPbxConfig will run without making further inquiries. *. These values can only be set when the reporting is activated on this server.
Parameters Explanation Example 1:
Connect e.g. the server 'CustomerA' to the database 'DB_CustomerA' on the SQL Server 'DB_ServerA_F'. In doing so, you also specify the name of the database user 'DBUser_CustomerA' and his password 'Password_DB_CustomerA'.
IpPbxConfig /ii DB_ServerA_F /di DB_CustomerA /ui DBUser_CustomerA /pi Password_DB_CustomerA
Example 2:
To restart all SwyxWare services without inquiry, enter: IpPbxConfig /stop /start /y
> Installation
31