SmartSpace version: 3.8.3

Ubisense Installation Guide for SmartSpace + DIMENSION4 + Series 7000 with Site connector

A SmartSpace + DIMENSION4 + Series 7000 installation includes the core Ubisense software and any licensed SmartSpace features alongside DIMENSION4's tag location capabilities and support for Ubisense Series 7000 sensors.

Site connector connects Ubisense platforms on separate networks using TCP/IP.

These instructions guide you through installing Ubisense SmartSpace software. They include a description of the organization and installation of Ubisense software across server, admin and client machines; prerequisites for installation; and the stages of the installation process.

SmartSpace installations can range in size from a single computer running all SmartSpace software, for example for evaluation purposes, to several servers with associated admin and client machines in a large industrial setting. SmartSpace can be installed and run on Windows and Linux computers and an installation may include a mix of these, for example with Linux servers and Windows client machines, and the instructions that follow include information for both Linux and Windows.

For Windows computers, installation files (.msi) are supplied. However, because of the variations between Linux distributions and between package management systems used by different Enterprise configurations, Ubisense do not provide an automatic installation method for Linux. Instead the instructions describe the necessary state of a Ubisense platform installation on Linux, prerequisites for the installation, the layout and permissions expected, and example scripts.

From SmartSpace version 3.8, installed Ubisense applications are 64 bit. For interoperability between 32-bit and 64-bit applications, you require the new 64-bit Ubisense Application Manager. Using an older 32-bit version of the application will prevent you from downloading other 64-bit Ubisense applications, for example SmartSpace Config.

The next section provides an overview of the installation process and subsequent sections take you through installing SmartSpace + DIMENSION4 + Series 7000 with Site connector step by step.

The Ubisense installation process

Ubisense requires software to be installed on three types of machine: server, admin and client.

  • Servers run the core and controller software, and the Ubisense platform from which you can start and stop the Ubisense servers. Ubisense servers can run on either Windows or Linux (see Requirements for supported versions).
  • The software installed on an admin machine enables you to manage the installation and deployment of SmartSpace features across your entire SmartSpace installation.
  • On client machines, you will find the SmartSpace applications available to users according to the SmartSpace features you have licensed.

Depending on your requirements, you might install all three SmartSpace machines on a single computer or you might spread the installation over a number of machines.

The following are the steps required to set up a new installation:

Install the Ubisense Software

  1. Install licenses.
  2. Install the Ubisense server software onto the relevant machine(s).
  3. Start the core server and service controllers.
  4. Install the Ubisense admin software onto the relevant machines.
  5. Install and deploy licensed SmartSpace features.
  6. Install the Ubisense client software onto the relevant machines.
  7. Download SmartSpace software to client machines.

Depending on the features you have licensed, users may access SmartSpace via a web interface, for example to view Web maps. In this case additional steps are required to set up a web server: these are described in Ubisense Installation Guide for SmartSpace Web. You do not need to install additional software for end users to access the browser-based features.

Install DIMENSION4

After you have installed the core software, you can install DIMENSION4 if this is required, by installing and deploying additional services. Follow these steps to install DIMENSION4:

  1. Install and deploy DIMENSION4 services.
  2. Download the DIMENSION4 software to client machines.

Install Series 7000 Support

After you have installed the core software, you can install support for Series 7000 if this is required, by installing and deploying additional services. Follow these steps to install Series 7000:

  1. Install and deploy Series 7000 services.
  2. Download the Series 7000 software to client machines.

Install Site connector

After you have installed the core software, you can install Site connector if this is required, by installing and deploying additional services. Follow these steps to install Site connector:

  1. Install the Site Connector for Servers service.
  2. Install the Site Connector Client or the Site Connector Client for Servers services.

Requirements

This section describes the hardware and software prerequisites for a SmartSpace + DIMENSION4 + Series 7000 with Site connector installation.

Server Hardware Requirements

Exact requirements for server hardware will depend on such things as the number of sensors and tags in your installation or the number of users querying any browser-based applications you have licensed. Contact Ubisense for further guidance on the specific requirements for your installation.

The following is an illustration of an installation with two servers running DIMENSION4 and SmartSpace with the Visibility component.

Feature Server 1 (DIMENSION4 + SmartSpace core) Server 2 (Windows server server running IIS)
Processor Quad-core Intel® Xeon® processors 3400 series 16-core Intel® Xeon® processors
Memory 8 GB 8 GB
Ethernet Interface Gigabit Network Adapter Gigabit Network Adapter
Virtualization For information about virtualization, contact Ubisense Support. For information about virtualization, contact Ubisense Support.

Server Software Requirements

Ubisense supports the following operating systems:

Windows

  • All versions of Windows server currently supported by Microsoft from Windows Server 2012 onwards.

  • Additionally, for client machines (and for proofs of concept, with the agreement of Ubisense Support), versions of Windows from Windows 8.0 which are currently supported by Microsoft.

Note: "Home" versions of Windows, e.g. Windows 10 Home, are not suitable for use as SmartSpace  servers in production environments, although they may be acceptable for evaluation purposes.

Linux

  • SUSE Linux Enterprise Server (SLES) 12 SP2
  • Red Hat® Enterprise Linux® (RHEL) 8+

If you are installing a web server for use with the Visibility component, see the additional considerations discussed in Linux Requirements for SmartSpace Web in the Ubisense Installation Guide for SmartSpace Web.

Visual C++

With the release of SmartSpace 3.8, Windows and Linux 32-bit executables were replaced with 64-bit executables. If you are installing or upgrading to SmartSpace 3.8 or higher, you need to ensure you have the latest C++ runtime dlls by installing the Visual C++ Redistributable Package from https://aka.ms/vs/17/release/vc_redist.x64.exe.

Typed API modules (.NET API)

If you built Typed API modules with versions of SmartSpace earlier than 3.8, you need to rebuild these modules using x64.

C++ API

If you have been using a version of the C++ API earlier than SmartSpace 3.8, you must upgrade to a 64-bit version of Microsoft Visual Studio 2015 or later.

ManagedBrowser (Application .NET API)

If you have ManagedBrowser clients /services that you want to rebuild against the latest SmartSpace release (not required), you will have to switch to x64.

Database Server for Reporting or RDBMS map

Either of the following are required only if the Reporting component or the RDBMS map feature is licensed:

SQL Server

Database versions: 2012 or higher.

Oracle

Database versions: 11G R2 or higher.

  • Windows servers using Oracle Instant Client 21.x library

  • Linux servers using Oracle Instant Client 21.x library

For information on configuring servers for use with the Reporting component, see SmartSpace Reporting.

For information on configuring servers for use with the RDBMS map feature, see RDBMS map configuration.

Additional Requirements for Linux Installations

The following are requirements for Linux computers onto which server or admin machines are to be installed:

  • The firewall should be disabled on the server
  • In order to work around kernel bind(0) behavior, the local dynamicport range should be changed
    • Either: place the following in an init script such as /etc/rc.d/rc.local: sysctl -w net.ipv4.ip_local_port_range=32768 49978
    • Or: place the following in /etc/sysctl.conf: net.ipv4.ip_local_port_range=32768 49978

    After reboot or applying sysctl -p, the property net.ipv4.ip_local_port_range can be checked with sysctl -a

Platform user

A user should be configured to execute platform services. We will refer to this as the platform user.

Operations group

A group should be configured for operations. Users in this group should be able to perform production operations, including starting and stopping the platform services, making and restoring backups, and performing other diagnostic and support roles, such as license management and platform service upgrades. The platform user might be in the operations group.

Windows client machine

In order to run any of the Windows-based configuration applications (SmartSpace Config , Location System Config , Location Engine Configuration ), you will need access to a Windows computer to install a client machine.

Unzipping Software to a Distribution Directory

The SmartSpace software is supplied as a zipfile with the name SmartSpace followed by numbers indicating the version of the software, for example SmartSpace_3_4_7147.zip. Before you install SmartSpace, you need to unzip this file into a distribution directory accessible to the machines on which you will be installing the software.

Installing Licenses on Windows

SmartSpace feature licenses are supplied as a zipfile with the name FeatureSetup.zip. Before you install the licenses, you need to unzip this file into a directory accessible to a server machine from which ubisense_core_server will be executed.

To install SmartSpace licenses:

  1. Go to the directory where you unzipped the licenses.
  2. Double-click the FeatureSetup.msi file and the Ubisense Feature Licenses Setup Wizard appears.
  3. Click Next and the Ubisense Feature Licenses Setup wizard appears.
  4. By default all licenses are selected for installation to the default location C:\Program Files (x86)\Ubisense 3\bin.
    • Click on the directory tree of licenses, click on individual features and choose whether or not they are to be installed
    • Click Reset to return the licenses selection to its default setting
    • Click Browse to navigate to a different directory to install the licenses in
  5. When you have selected the files and location you require, click Next and then click Install.
  6. When installation is complete, click Finish to close the wizard.

Installing Ubisense Software on Windows

Installing the Server Software

On each machine you want to use as a server, you must install the Ubisense server software.

During the installation process, for each server machine you can choose to install either the core server or service controller or both. If you intend to run SmartSpace on a single server, you need to install both the core server and service controller on that machine. For an installation with more than one server, you need to run the core server on one machine only and the service controller on the rest, and you can install the components accordingly.

To install the server software:

  1. Go to the servers\windows directory of your SmartSpace distribution directory.
  2. Double-click the UbisenseServers.msi file and the Ubisense Servers Setup wizard appears.
  3. Click Next to display the Custom Setup dialog.

    screen shot of Custom Install dialog

  4. Choose the components to install.

    By default, all features are selected. Choose whether to install or exclude items using the dropdowns beside their names. Reset returns you to the default selection.

  5. Choose the location for the software.

    You can accept the default C:\Program Files (x86)\Ubisense 3 or click Browse to select another destination.

  6. Click Next and click Install.
  7. When the installation is complete, click Finish to close the Ubisense Servers Setup wizard.

You have now installed Ubisense Platform Control and the Ubisense server software onto your computer. Using Platform Control to start the server software is described in the next section.

Starting the Server Software

After you have installed the server software, you need to start the core server and service controller(s).

To start the server software:

  1. From a SmartSpace server, run Platform Control.
  2. For a new installation, you need to choose a location for your dataset:
  3. In the Properties section, browse to the required location (creating a new folder, if needed) and click OK (new).

  4. Start the core server and service controller by:
    1. Selecting UbisenseCoreServer 3 and then clicking Start.

    2. Selecting UbisenseServiceController 3 and then clicking Start.

      See the information below for information on starting services with a single server or multiple servers.

      You are offered only the server components installed on the machine (see Installing the Server Software).

    The status of each service changes to to be started.

  5. Click Apply. The status of each service changes to running.

Installing Admin Machines on Windows

To install the Ubisense software for an admin machine:

  1. Go to the clients\windows directory of your SmartSpace distribution directory.
  2. Double-click the UbisenseServiceManager.msi file and the Service Manager Setup wizard appears.
  3. Click Next.
  4. Choose the Destination Folder for the software.
    You can accept the default C:\Program Files (x86)\Ubisense 3 or change to another destination.
  5. Click Next and click Install.
  6. When the installation is complete, click Finish to close the Service Manager Setup wizard.

You have now installed Service Manager onto your computer and you can use it to install and deploy SmartSpace features.

Before you can install and deploy features, you must install their licenses.
  1. From an admin machine, run Service Manager 3.
  2. Click Install services....
  3. Specify the directory from which to install.

    This is generally the packages folder in your SmartSpace distribution directory. Click <Recently used directories> to select previous locations of features.

  4. Select the features you want to install.

    Use Select all or Clear all or click on individual features to indicate which items you want to install.

    • All SmartSpace features are listed.
    • All licensed features are selected by default.
    • Unlicensed features are shown preceded by [Unlicensed]. You cannot select these features.

    As a minimum, you should select SmartSpace core.

  5. By default Deploy services is selected.

    This means that any services you select for installation will also be automatically deployed during the installation process. Deselect Deploy services if you want to manually deploy the services after installation.

  6. Click Install.
  7. When installation is complete, click Finish.

You have now installed your SmartSpace features. In Service Manager you can see which services have been deployed by the installed features.

Installing Client Machines on Windows

In Windows, the Ubisense Application Manager allows you to perform the following configuration activities on a client machine:

  • Set up Start menu shortcuts for client applications
  • Download various command-line tools and SmartSpace documents to a specified location on a client machine

To install the Ubisense software for a client machine:

  1. Go to the clients\windows directory of your SmartSpace distribution directory.
  2. Double-click the UbisenseApplicationManager.msi file and the Ubisense Application Manager Setup wizard appears.
  3. Click Next.
  4. Choose the Destination Folder for the software.
    You can accept the default C:\Program Files (x86)\Ubisense 3 or change to another destination.
  5. Click Next and click Install.
  6. When the installation is complete, click Finish to close the Ubisense Application Manager Updater Setup wizard.

You have now installed the Ubisense Application Manager and can now configure shortcuts to client applications and download documents and other files to your client machine.

Managing applications

To create shortcuts to SmartSpace applications:

  1. Run the Ubisense Application Manager and click on APPLICATIONS.
  2. Available applications are listed, with their version numbers and, where applicable, location on the Start menu.

    Choose the applications you want to install.

    • Double-click a single application
    • Select several applications and press Enter

    The following SmartSpace client program is available:

    • SmartSpace Config (the main SmartSpace configuration GUI)
  3. Click Create shortcuts for selected applications.

    Shortcuts are created in the Start menu in the locations indicated.

Managing tools and documents

To download SmartSpace command-line tools and documents to a selected directory:

  1. Run the Ubisense Application Manager and click on DOWNLOADABLES.
    Command-line tools and documents are listed in different categories. The tools and documents available to you depend on the features you have installed.
  2. Choose the tools or documents you want to download.

  3. Specify the directory to install the files in and click Start download.

    The files are downloaded to the specified directory.

Whenever you upgrade your SmartSpace installation, you must follow the process described above to replace your existing tools and documents with upgraded versions.

Installing Licenses on Linux

License files must be placed on the server so that the platform can find them. The default location is in the directory /etc/ubisense. If a different location is required, then the license_search_path can be defined in platform.conf (see Configuration Parameters for information on the location of this file). Each program also searches for licenses in the same directory as its executable. Licenses should be readable by both the platform user and by the operations group.

Installing Ubisense Software on Linux

Installing the Server Software

For Linux servers, there are two executables: ubisense_core_server and ubisense_local_control. You can find them in the following locations in the distribution directory:

    servers/linux/ubisense_core_server
    servers/linux/ubisense_local_control

If you want to run SmartSpace on a single server, copy both of these files to that machine.

If you want to run SmartSpace on several servers, copy ubisense_core_server onto one server machine only and ubisense_local_control onto the remainder of the machines.

Starting the Server Software

On each server machine, one or both of the ubisense_core_server and ubisense_local_control services should be executed on startup, depending on whether the machine is to act as a core server, a service controller, or both. These services should be executable by the platform user, and no other user, to avoid accidental execution. Because of the variations between Linux distributions, Ubisense do not ship standard startup scripts for these executables, but examples are provided:

Service security and Authentication using Cached Service Credentials on Linux

If you are running on a Linux server and configure a security policy in Security Manager that requires services to authenticate as a user, using ubisense_cache_service_credentials, then you must run the core and controller software with the -d flag (as shown in the examples above). Otherwise all services will still have a connected stdin/stdout and will attempt to prompt for credentials rather than reading the cached service credentials.

Configuration Parameters

On Linux, the local configuration parameters for each core or controller machine are set, by default, in a configuration file. This file contains configuration parameters for the local platform processes, such as the location of the dataset and the networking mode. The default location expected by all platform executables is /etc/ubisense/platform.conf. If another location is to be used, then the environment variable UCONFIG should be defined: it is recommended this be set in startup scripts for all users on the server, but it certainly is required for the platform user and all users in the operations group. UCONFIG should be the full path of platform.conf in its desired location.

Configuration parameters are each on a single line in the file, with a colon and white-space separating the name of the parameter from the value. For example:

platform_dataset: /mnt/syn013/ubisense/production/dataset
no_multicast_mode: 1
server_unicast_addresses: 10.1.5.207,10.1.16.73

Warnings and Errors

Immediate warnings and errors when starting the two platform service executables are logged to the Linux syslog. On a typical Linux distribution they will either be in /var/log/messages or /var/log/warn. If the services will not run, check these locations for more information.

Platform Dataset

The platform dataset is the directory where both the ubisense_core_server and ubisense_local_control services store platform state. Files in this directory comprise the configuration and ongoing operational state of the platform core, and of all the services configured to run on the local controller.

This directory should be owned by the platform user with full control. The operations group should also have read permission, to allow backup. Restore requires that the backup be copied here and all files set to have platform ownership. See Configuring Operations Permissions.

The default platform dataset location is /home/platform/dataset. To set a different location, set platform_dataset in the platform.conf file.

Configuring Operations Permissions

If your Linux distribution supports sudo, then the operations group can be assigned permission to start and stop the platform services, and to change ownership of files to the platform user. For example, the following lines might be added to the end of the /etc/sudoers file using visudo.

%operations ALL = (root) NOPASSWD: /sbin/service ubisense_core_server *, \
/sbin/service ubisense_local_control *, \
/bin/chown -R platform *, /bin/chown platform *

With this configuration, any user who is in the operations group will be able to run sudo /sbin/service ... to stop, start and get the status of just the platform services. They will also be able to restore platform dataset backups and set the ownership of the restored files back to the platform user.

Backing up your Dataset

After you have set up your SmartSpace installation, ensure that you back up your dataset occasionally, so that you can recover your data. Use the ubisense_backup command-line tool from the tools\linux folder of your distribution directorys to backup your dataset.

Installing Admin Machines on Linux

Administrative executables, used to configure and maintain the running state of the Ubisense platform, should be executable by the operations group.

Your distribution directory contains the following admin executables:

    tools/linux/ubisense_backup
    tools/linux/ubisense_cache_service_credentials
    tools/linux/ubisense_configuration_client
    tools/linux/ubisense_file_downloader
    tools/linux/ubisense_installer
    tools/linux/ubisense_machine_id
    tools/linux/ubisense_multicast_test
    tools/linux/ubisense_proxyconfig_admin
    tools/linux/ubisense_restore_dataset
    tools/linux/ubisense_save_dataset
    tools/linux/ubisense_service_admin
    tools/linux/ubisense_service_ping
    tools/linux/ubisense_trace_receiver
    tools/linux/ubisense_transfer_config

Installing Client Machines on Linux

In order to avoid the use of incompatible versions of SmartSpace administrative and configuration tools, these tools are installed into the platform along with service upgrades. You can then download the current version of each tool onto your Linux client machine using the ubisense_file_downloader.

Run the tool with no arguments for help.

For example, to download all Linux tools currently available to the current directory, run:

> ubisense_file_downloader download --linux-only .

To force the overwriting of existing downloads, add --force.

Installing DIMENSION4

The DIMENSION4 software is supplied as a zipfile with the name DIMENSION4 followed by numbers indicating the version of the software, for example DIMENSION4_3_4_7147.zip. Before you install DIMENSION4, you need to unzip this file into a distribution directory accessible to the machines on which you will be installing the software.

Installing DIMENSION4 Features

Follow these instructions to install and deploy DIMENSION4 features.

Before you can install and deploy features, you must install their licenses.
  1. From an admin machine, run Service Manager 3.
  2. Click Install services....
  3. Specify the directory from which to install.

    This is generally the packages folder in your DIMENSION4 distribution directory.

  4. Select the features you want to install.

    For DIMENSION4 select the single feature, DIMENSION4 location software.

  5. By default Deploy services is selected.

    This means that any services you select for installation will also be automatically deployed during the installation process. Deselect Deploy services if you want to manually deploy the services after installation.

  6. Click Install.
  7. When installation is complete, click Finish.

You have now installed your DIMENSION4 features. In Service Manager you can see which services have been deployed by the installed features.

Downloading DIMENSION4 programs to client machines (Windows)

Managing applications

To create shortcuts to DIMENSION4 applications:

  1. Run the Ubisense Application Manager and click on APPLICATIONS.
  2. Available applications are listed, with their version numbers and, where applicable, location on the Start menu.

    Choose the applications you want to install.

    • Double-click a single application
    • Select several applications and press Enter

    The following DIMENSION4 client program is available:

    • Location System Config (the main DIMENSION4 configuration GUI)
  3. Click Create shortcuts for selected applications.

    Shortcuts are created in the Start menu in the locations indicated.

Managing tools and documents

To download DIMENSION4 command-line tools and documents to a selected directory:

  1. Run the Ubisense Application Manager and click on DOWNLOADABLES.
    Command-line tools and documents are listed in different categories.
  2. Choose the tools or documents you want to download:
    • Double-click a single file name
    • Select several files and press Enter
  3. Under Location system, additional DIMENSION4 command-line tools and documents are available.

    • Double-click a single file name
    • Select several files and press Enter
  4. Specify the directory to install the files in and click Start download.

    The files are downloaded to the specified directory.

Whenever you upgrade your DIMENSION4 installation, you must follow the process described above to replace your existing tools and documents with upgraded versions.

Downloading DIMENSION4 programs to client machines (Linux)

In order to avoid the use of incompatible versions of DIMENSION4 administrative and configuration tools, these tools are installed into the platform along with service upgrades. You can then download the current version of each tool onto your Linux client machine using the ubisense_file_downloader.

Run the tool with no arguments for help.

For example, to download all Linux tools currently available to the current directory, run:

> ubisense_file_downloader download --linux-only .

To force the overwriting of existing downloads, add --force.

Installing Series 7000

The Series 7000 software is supplied as a zipfile with the name Series7000 followed by numbers indicating the version of the software, for example Series7000_2_1_11_7194.zip. Before you install Series 7000, you need to unzip this file into a distribution directory accessible to the machines on which you will be installing the software.

You will also need to unzip the Series 7000 sensor bootfiles you require. These are supplied in zipfiles with the name Sensor_Bootfiles followed by an identifier for the bootfile and numbers indicating the version of the software, for example Sensor_Bootfiles_standard_2_1_11_7222.zip.

Installing Series 7000 Features

Follow these instructions to install and deploy Series 7000 features.

Before you can install and deploy features, you must install their licenses.
  1. From an admin machine, run Service Manager 3.
  2. Click Install services....
  3. Specify the directory from which to install.

    This is generally the packages folder in your Series 7000 distribution directory.

    For Series 7000 sensor bootfiles this is a directory with the same name as the identifying part of its parent directory. For example if you unzipped to a Sensor_Bootfiles_standard_2_1_11_7222 directory, you install from the standard directory.

  4. Select the features you want to install.

    For Series 7000, select the Series 7000 RTLS feature

    Also for Series 7000, go to the sensor bootfiles distribution and select Everything (no feature dependencies found) to install the Sensor boot services.

  5. By default Deploy services is selected.

    This means that any services you select for installation will also be automatically deployed during the installation process. Deselect Deploy services if you want to manually deploy the services after installation.

  6. Click Install.
  7. When installation is complete, click Finish.

You have now installed your Series 7000 features. In Service Manager you can see which services have been deployed by the installed features.

Downloading Series 7000 programs to client machines (Windows)

Managing applications

To create shortcuts to Series 7000 applications:

  1. Run the Ubisense Application Manager and click on APPLICATIONS.
  2. Available applications are listed, with their version numbers and, where applicable, location on the Start menu.

    Choose the applications you want to install.

    • Double-click a single application
    • Select several applications and press Enter

    The following Series 7000 client program is available:

    • Location Engine Configuration
  3. Click Create shortcuts for selected applications.

    Shortcuts are created in the Start menu in the locations indicated.

Managing tools and documents

To download Series 7000 command-line tools and documents to a selected directory:

  1. Run the Ubisense Application Manager and click on DOWNLOADABLES.
    Command-line tools and documents are listed in different categories.
  2. Choose the tools or documents you want to download:
    • Double-click a single file name
    • Select several files and press Enter
  3. Under Ubisense Generation 2.X>Series 7000 RTLS>Administration tools and documentation, the following command-line tools and documents are available.

  4. Specify the directory to install the files in and click Start download.

    The files are downloaded to the specified directory.

Whenever you upgrade your Series 7000 installation, you must follow the process described above to replace your existing tools and documents with upgraded versions.

Downloading Series 7000 programs to client machines (Linux)

In order to avoid the use of incompatible versions of Series 7000 administrative and configuration tools, these tools are installed into the platform along with service upgrades. You can then download the current version of each tool onto your Linux client machine using the ubisense_file_downloader.

Run the tool with no arguments for help.

For example, to download all Linux tools currently available to the current directory, run:

> ubisense_file_downloader download --linux-only .

To force the overwriting of existing downloads, add --force.

Installing Site connector

The Site connector consists of a server application and a set of client applications. There are two Site connector clients: which one you install depends on the configuration of your installation.

Site connector requires both the Site connector server and at least one client to be installed. The steps you follow to install the server and the client software are described below. Additional configuration steps might be required.

For an overview of different uses for Site connector and detailed information on configuration, see the Ubisense Site Connector Guide.

The Site connector software is supplied as a zipfile with the name SiteConnector followed by numbers indicating the version of the software, for example SiteConnector_2_1_11_7160.zip. Before you install Site connector, you need to unzip this file into a distribution directory accessible to the machines on which you will be installing the software.

Installing Site connector server

The Site connector server is an independent service rather than a package deployed via the Ubisense platform. On Windows, this is installed as a Windows Service. On Linux, it should be started in the same way as core and controller, via a startup script or systemd, depending on the Linux distribution.

Installing Site connector server on Windows

  1. Go to the UbisenseSiteConnectorForServers directory of your Site connector distribution directory.
  2. Double-click the UbisenseSiteConnectorForServers.msi file and the Ubisense Site Connector Service Setup wizard appears.
  3. Click Next.
  4. Choose the Destination Folder for the software.
    You can accept the default C:\Program Files (x86)\Ubisense 2.1\ or change to another destination.
  5. Click Next and click Install.
  6. When the installation is complete, click Finish to close the Ubisense Site Connector Service Setup wizard.

After installation is complete, start the service using Windows Services manager:

  1. Open Services by typing View local services in the Start menu.
  2. Start the service UbisenseSiteConnectorServer 2.1.

    The service is configured to start automatically on reboot.

You can also stop and start the site connector service from the command prompt (as an administrator):

net stop "UbisenseSiteConnectorServer 2.1"

net start "UbisenseSiteConnectorServer 2.1"

Installing Site connector server on Linux

For Linux, you can find the Site connector server executable in your distribution directory under linux/server. To install the executable:

  1. Copy ubisense_site_connector_server onto your server
  2. Create a startup script or systemd configuration to run the executable on startup.

Installing Site connector clients

Which client software you install depends on how you are using Site connector. See the Introduction to Site connector for information on intended uses for Site connector and their configuration.

Installing the Site connector Client on Windows

  1. Go to the UbisenseSiteConnectorClient directory of your Site connector distribution directory.
  2. Double-click the UbisenseSiteConnectorClient.msi file and the Ubisense Site Connector Client Setup wizard appears.
  3. Click Next.
  4. Choose the Destination Folder for the software.
    You can accept the default C:\Program Files (x86)\Ubisense 2.1\ or change to another destination.
  5. Click Next.
  6. Input the server IPaddress and site connector port number (these can be changed after installation). 49983 is the default port number which will be used in most installations. By default Run in standalone mode is selected. In standalone mode the client will only connect to the network of the Site Connector server it connects to. When not in standalone mode Site Connector will connect the networks of the client and server together. This should only be done if the effects are fully understood. After installation the standalone mode setting can only be changed with Platform Control (providing you have access to it).
  7. Click Next and click Install.
  8. When the installation is complete, click Finish to close the Ubisense Site Connector Client Setup wizard.

Installing the Site connector Client for Servers on Windows

  1. Go to the UbisenseSiteConnectorClientForServers directory of your Site connector distribution directory.
  2. Double-click the UbisenseSiteConnectorClientForServers.msi file and the Ubisense Site Connector Client for Servers Setup wizard appears.
  3. Click Next.
  4. Choose the Destination Folder for the software.
    You can accept the default C:\Program Files (x86)\Ubisense 2.1\ or change to another destination.
  5. Click Next.
  6. Input the server IPaddress and site connector port number (these can be changed after installation). 49983 is the default port number which will be used in most installations. By default Run in standalone mode is selected. In standalone mode the client will only connect to the network of the Site Connector server it connects to. When not in standalone mode Site Connector will connect the networks of the client and server together. This should only be done if the effects are fully understood. After installation the standalone mode setting can only be changed with Platform Control (providing you have access to it).
  7. Click Next and click Install.
  8. When the installation is complete, click Finish to close the Ubisense Site Connector Client for Servers Setup wizard.

Installing the Site connector Client on Linux

There is no particular step to install the client. Launch the application ubisense_site_connector_client. Following are examples of scripts for starting or restarting the client.

Next Steps

With SmartSpace, your other Ubisense products, and your licensed features installed, you can configure your installation:

  • If you have features that are accessed using SmartSpace web, you need to install and configure you web server. See the Ubisense Installation Guide for SmartSpace Web for further information.

  • Other SmartSpace features will require additional configuration. See the requisite sections of this website for further information.

  • For additional information on configuring DIMENSION4, see the DIMENSION4 website, download individual guides from https://docs.ubisense.com/portal/Content/Downloads.htm, or press F1 in the Location System Config application.