HOWTO

SwyxWare installation guide (kb2464)

The information in this article applies to:

  • Microsoft Windows 2000 Server
  • SwyxWare all versions

[ Summary | Information | Links ]


Summary

Beside hardware requirements described in Knowledgebase article the existing network infrastructure is elemtary for a smooth working SwyxWare installation. This Knowledge Base Article briefly describes the requirements and does not explain the details of an IP based network implementation. The following description assumes that a Windows 2000 Server based Active Directory already exists. But in principle it should be possible to adopt this article on a Windows NT 4.0 based network.

Information

Common issues:

  • The PC which is used to run SwyxWare should only be used for this purpose. Running other network services (E-Mail server, DHCP- or DNS-Server) is not recommended due to performance and maintainability reasons.
  • The SwyxServer PC should have a static IP address!

 

Network infrastructure:

SwyxWare uses the internet protocol (IP) for transmission of callcontrol messages and voice data. For this each client PC needs to have a unique IP address. It's not relevant if it's a private (e.g. 192.168.1.x) or a public IP address.

For an optimal transmission of callcontrol and voice data a complete layer 2 switched network infrastructure would be advantageous. But this is not mandatory and depends on the number of SwyxWare user and the number of paralell phone calls. The other network traffic (file transfer, HTTP, FTP, ...) should be considered, too. Absolute mandatory is to connect the SwyxServer PC respective SwyxGate PC to a Switch port in order to satisfy the bandwidth needs for callcontrol and voice data.

 

Quality of Service:

To improve speech quality the implementation of Quality of Service (QoS) within the network is advantageous. Knowledgebase article

describes the procedure in detail.

 

Network Address Translation (NAT) and Firewalls:

SwyxServer and its clients (SwyxIt! and L420) uses DCOM for communication. But as described in Microsoft Knowledgebase Article 248809 (a link can be found at the end of this article) DCOM does not support NAT Servers. Therefore SwyxWare will not work across NAT Servers, too.

SwyxWare uses a lot of UDP and TCP ports. Due to this you have to configure your firewall accordingly if this firewall is placed between SwyxServer and its clients. Knowledgebase article

describes that in detail.

 

DHCP (Dynamic Host Configuration Protocol):

You should use DHCP to assure distribution of unique IP addresses. Windows 2000 Server already provides a DHCP server and can be installed as descibed:

  1. Click Start, Settings, and select Control Panel.
  2. Doubleclick Add/Remove Programs, and select Add/Remove Windows Components.
  3. Select Network Services and click Details.
  4. Activate DHCP (Dynamic Host Configuration Protocol) and click OK.
  5. Click Next, and finish the wizard.

Advantages using DHCP server:

  • Distribution of unique IP addresses
  • Automatic distribution of SwyxServers IP address to the clients.This is described in SwyxWare manual chapter 4.14 (Settings on the DHCP or the DNS Server).
  • The DHCP server supports the automatic update of client IP address changes in the DNS server. This is important for keeping the assignment of FQDN (Fully Qualified Domain Name, e.g. "host.domain.co.uk") to IP address consistent. To activate this feature follow these steps:
  1. Start DHCP administration
  2. Rightclick the server and select Properties
  3. Click DNS tab
  4. Activate Automatically update DHCP client information in DNS

Important: In order to distribute the IP address of the WINS and DNS server to the Windows client PCs you have to add following DHCP options within the DHCP server:

  • "006 DNS-Server"
  • "044 WINS/NBNS Servers

 

DNS (Domain Name Service):

An Active Direcotry requires a DNS server for operation. Active Directory uses DNS as a locator service resolving Active Directory domain, site, service names and client FQDN to IP addresses.

  • The DNS server should be configured to allow dynamic updates in order to overtake changes in clients IP address respective FQDN. Dynamic update enables DNS client computers to register and dynamically update their resource records within a DNS server whenever changes occur and reduces manual administration efforts. To activate this feature follow these steps:
  1. Start DNS administration In the console tree, click the applicable zone
  2. On the Action menu, click Properties
  3. On the General property tab make sure that zone type is Active Directory integrated
  4. Select Yes within Allow dynamic update list

Note: Dynamic update is only supported by Windows 2000 clients.

  • The DNS server should be configured to enable the WINS resolution for DNS. In this case the DNS server uses WINS to lookup queried host names it cannot answer from its data.
  1. Start DNS administration
  2. In the console tree, click the applicable zone
  3. On the Action menu, click Properties
  4. Click the WINS tab
  5. Activate Use WINS forward lookup check box, if the applicable zone is a forward lookup zone
  6. Activate the Use WINS lookup check box
  7. Type the IP address of a WINS server to be used for further resolution of names not found in DNS
  8. Click Add to add the server IP address to the list

In case of dynamic update resource records will be added by client computers during startup. In some cases these resource records will not be deleted correctly if a computer leaves the network. If for example a computer starts, it adds a host entry (A entry) to the DNS server. If this computer leaves the network in a not supported way that entry will not be deleted and may lead to address resolution conflicts. DNS server with invalid resource records may answer client requests using the invalid records which causes name resolution conflicts within the network. To avoid this, DNS server supports a mechanism called 'Aging' of resource records. Explaing this feature in its whole complexity would exceed this Knowledge Base artice. So please have a look at Microsofts documentation for further information.

 

WINS (Windows Internet Name Service):

The WINS server resolves NetBios names into IP addresses and is an important service in each Microsoft Network. As mentioned before a WINS server can support a DNS server to lookup queried host names. Therefore a WINS server should already run on Windows 2000 Server system in your network. To install a WINS server please follow these steps:

  1. Click Start, Settings, and select Control Panel
  2. Doubleclick Add/Remove Programs, and select Add/Remove Windows Components
  3. Select Network Services and click Details
  4. Activate WINS (Windows Internet Name Service) and click OK.
  5. Click Next, and finish the wizard.

 

Automatic configuration of SwyxServers ip address for SwyxPhone L420: 

The SwyxPhone L420 must be configured for operation in the network. This can either be done locally on each phone or centrally via DHCP or DNS server.
Please have a look at following knowledgebase articles for further information:

 

Automatic distribution of SwyxIt! client: 

It can be very circuitous to install SwyxIt! manually on each client PC if you have a large SwyxWare installation. Due to this it is possible to distribute SwyxIt! to the workstations of a network automatically. For detailled information please at knowledgebase atricle:

Distribution of SwyxIt! (kb2242)

 

A smooth working SwyxWare PBX will be the result if all of the above described components have been correctly implemented and configured.


Links

As far as software supplied or used by us, includes open source elements the additional terms under https://www.swyx.com/open-source apply in addition. An overview which products from the Swyx portfolio include open source elements and which open source license is relevant can be found under https://www.swyx.com/open-source.

The third-party contact information included in this article is provided to help you find the technical support you need. This contact information is subject to change without notice. Swyx in no way guarantees the accuracy of this third-party contact information nor is responsible for it's content.


Comment

Comment on this article



If we have any follow-up questions, where can we contact you?

E-Mail Address (optional)


Note

This feedback form can't be used for support requests. Those requests must be directed to your Swyx reseller or distributor.