Client

Information on the installation of an XPhone Connect Client. Single installation and installation via software deployment.

Attention

  • If you want to use the dashboard, you have to install Webview 2 (Evergreen Bootstrapper) separately on the client machines, because this is not part of the client setup or client MSI file.

  • Parallel installation of XPhone UC 2011 (v4) and XPhone Connect (v5) Clients is not supported by C4B.

Caution

Please activate the Printer Queue (Spooler) in Windows Services from Windows 11 onwards if you want to install the XPhone Fax printer driver. Furthermore, you should set the startup type to Automatic. Otherwise, the XPhone Connect Fax printer driver cannot be installed.

Setup

Hint

Please check that all system requirements are met before installation.

Please keep in mind that administrator rights are necessary at the corresponding PC for the local installation at a workstation.

You can find the set-up under \SoftwareClients...

Start the SetupConnect.exe. The setup now appears, you will be guided through the installation process.

Hint

If the optional fax printer driver was not installed initially, it cannot be added later via a change installation. In this case, uninstall the XPhone Connect Client and reinstall it including the printer driver.

Setup via Software deployment system

The XPhone Connect Client setup runs as an MSI setup and can be processed by standard software deployment tools. You can manage all aspects of the installation by modifying the MSI database properties. Since various parameters can also be set using call parameters, a batch file can be used to manage the installation.

Hint

Because of the server functions for central administration, no separate settings are required for the specific workstations.

The following table describes all available command line parameters:

Parameter

Meaning

ALLUSERS=<1 or 0>

If this value is 1, XPhone Connect is installed for all computer users. If 0 is contained here, the installation is for the current user only. This affects the entries in the start menu and registration of Outlook AddOns.

C4BATLASIP=<IP-Adress>

List of host names or IP addresses of the XPhone Connect Server; separated by a semicolon.

e.g.:ucserver1;ucserver2

If another port other than the default port (port: 2230) is used, it must also be specified.

e.g.:ucserver1:8001;ucserver2:8002

Options for execution

/q = “quiet” installation, all dialogs are suppressed.

/qb = “quiet basic” installation, dialogs are partly suppressed.

/qn = Suppresses message about missing client during update installation (see below).

Note

The following command line installs XPhone Connect for all users on the computer and configures the XPhone Connect Server address: The default port is also changed: Msiexec /i "XPhone Connect Client.msi" /qb ALLUSERS=1 C4BATLASIP=192.168.1.1:8001

You can also change MSI database properties. You should use this method if you wish to show or hide setup features (e.g. integration in Outlook or Notes, see screenshot below and information on installation of the update) or use Active Directory group policies to install the software. The requisite programme TweakMsi.exe can be found in the same folder as the XPhone Connect Server’s setup files (see also Distribution via an adapted setup with Distribution via an adapted setup with Tweak-MSI for configuring the Client setup for automatically determining the server).

XPhone Connect Client can be installed on the target computer for distribution to all users or only for the current user; error messages during installation can be suppressed.

The list of preferred XPhone Connect Servers (see C4BATLASIP above) an also be used exclusively. Do this by activating the Use only specified list of server URIs option. Other servers are then ignored when establishing the respective server.

../../_images/xc_client_tweakmsi.png

Hint

  • The Publish provision method for software distribution via group guidelines is not supported by the XPhone Connect Client setup. Use the Assign provision method instead.

  • Please note that the fax printer driver must be distributed via a separate MSI package. Do this by using the XPhone Connect Fax Printer.msi which can be found in the FaxPrinterDriver folder.

Update installation via MSI

Hint

The MSI package cannot be opened by a user. Setup.exe must be used. Only the software deployment tool can open the MSI directly.

If you carry out the installation via MSI, please note that a direct call of the MSI file works in the same way as the installation through Control Panel/Add or Remove Programmes; in other words, it is only possible to change existing installations, NOT to update them.

If you call setup.exe or the MSI file with the REINSTALL=ALL REINSTALLMODE=voums parameters, the update or new installation uses the default settings. You cannot specify additional parameters, as this may even cause errors. If you update your current version, the existing scope of functions is updated, which means that you cannot add or remove installation features.

If you use a software deployment that uses the same call for updates and new installations, you must prepare the MSI package so that the scope of installation you require is the default for new installations.

The scope of the installation and parameters such as the IP address for the server can ONLY be specified during a new installation. If you wish to make a change, you must first uninstall the application. You can do this in the following way, for example: Msiexec /x <Arg> where <Arg> is either the MSI file or the product code:

  • Server: {EB16E878-844D-4B85-A240-C8180E414D3E}

  • XPhone Connect Client: {46DF44F6BCC1-4B88-84CCA-F3DBAA-C9552C}

Note

Msiexec /x "{AB00A952-3335-423D-890B-4BAB1913284C}" /qn``einstalls the XPhone Connect Client if it is installed. ``/qn, ensures that there is no error message if the XPhone Connect Client is not installed.

Determine the XPhone Connect Server automatically

Determine the XPhone Connect Server automatically

To avoid the effort of entering the respective server name on individual computers running an XPhone Connect Client, an attempt is made to determine the server automatically.

The first time the XPhone Connect Client is started, the integrierten Windowsanmeldung is used to try and login all XPhone Connect Servers found. If login is successful, this server is saved and used in future.

The following possibilities are available for locating the server:

Service connection point in the AD

The Active Directory (AD) provides an option via the Service Connection Point for saving information on the services running there by entering it in the AD under the corresponding host computer. The XPhone Connect Server also makes this information available in the AD. Client computers searching for an XPhone Connect Server can find them via an LDAP query in the AD.

Requirement or using the Service Connection Point: the XPhone Connect Server has been successfully registered in the AD via the Service Manager. This requires registration by an AD administrator. Furthermore, the Client must have read access to the AD which is generally the case for AD users.

Further information: https://msdn.microsoft.com/en-us/library/ms677638(v=vs.85).aspx

Determining via UDP

Another way of finding the XPhone Connect Server service is by querying via UDP using the WS Discovery protocol. The Client searching for an XPhone Connect Server sends a broadcast via UDP. Running XPhone Connect Servers receive this broadcast and answer via UDP with their server names. The UDP port 3702 is used here without it being claimed exclusively.

Requirement: This variant is only possible in the local network provided that UDP Port 3702 and in particular UDP Multicast messages are not blocked (e.g. port blocked in a firewall or exclusive use of the port by another application).

Further information: https://msdn.microsoft.com/en-us/library/dd456791(v=vs.110).aspx

Distribution via an adapted setup with Tweak-MSI

As an alternative, the server name and server port can also be saved directly in the installation file. If this option is requested, please start the TweakMsi.exe programme which is located in the same folder as the XPhone Connect Client. Please complete the C4BATLASIP and C4BATLASPORT fields if necessary; save and then distribute the setup to the Client computers.

In order to permit automatic login by the Clients at a server, please ensure that both options under Login & publication are selected at the System settings -> General server.

Have you found an mistake on this page?

Please send us a hint about this error by mail to doku@c4b.de. Thank you very much!