Skip to main content

Bulk install Portal Lights

  • Updated

Bulk install is the method to get a handful to hundreds of Portal Lights ready for use. During a bulk install, you will use the Kontakt.io Fallback network to allow the Portal Lights to synchronize with Kio Cloud and download the local Wi-Fi network settings. Once connected to the local Wi-Fi network, you will complete the install by assigning the Portal Lights to their room install locations from the Kio Setup Manager mobile app.

The bulk install can also be performed when the local Wi-Fi network is not available, such as during a pre-construction phase. Once the local Wi‑Fi network becomes available, the Portal Lights will automatically connect to it.

Important

For Enterprise Wi-Fi networks (TLS/TTLS/PEAP), submit a request to our support team. They will assist with the Portal Light network configuration.

For WPA (TKIP & AES), WP2, or Open Wi-Fi (WEP; Open & Shared) Wi-Fi networks, complete the following instructions.

Topics in this article: 

Prerequisites

Before you begin, ensure the following prerequisites are met.

Step 1: Add Kontakt.io Fallback Wi-Fi network to hotspot or Access Point

During this step, you will add the Kontakt.io Fallback Wi-Fi network to your mobile hotspot or a local Access Point. This step provides the Wi-Fi network connection required for the Portal Lights to synchronize with Kio Cloud and download their local Wi-Fi network settings.

  1. Power on each Portal Light (daisy chain or use of the Portal Light passthrough outlet is recommended).

  2. Configure your mobile Wi-Fi Hotspot or a local Access Point with the below Kontakt.io Fallback network.

    SSID: kontaktDeployment

    Password: LTPGjjwp256

    Network security: WPA, WPA2-PSK, WEP

    Wi-Fi Frequency: Portal Light only supports connection to a 2.4 GHz network. Portal Light 2 supports either a 2.4 GHz or 5 GHz network.

Step 2: Configure the Portal Lights' Wi-Fi network settings

During this step, you will configure each Portal Light with local Wi-Fi network they will connect to at their install locations.

  1. Sign in to Kio Cloud > select  Device Management 2.0 > select Infrastructure.

  2. From the list, you can select each Portal Light being configured or set the Filter to only display Portal Light models.

    To set a Filter, from the Add Criteria field, select Product > select Is and select model of the Portal Lights being installed.

  3. Select EXPORT[quantity selected] > select Download CSV.

  4. From the CSV file, locate the Wi-Fi network settings provided in the below table and enter the settings for each Portal Light.

    To reduce the number of columns, you can delete all other columns other than the columns listed in the below table.

    uniqueID

    mac

    wifiSsid

    wifiProtocol

    wifiPassword

    Do not delete or change the uniqueId or mac column.

    Enter the network name; SSID

    NOTE: Case sensitive

    Enter one of the below protocols.

    WPA_PSK (for personal WPA; TKIP & AES)

    OPEN (for WEP; Open & Shared)

    Enter the passphrase (network password)

    NOTE: Case sensitive

    wifiUserName: not applicable for WPA or OPEN protocols.

  5. Once you have updated the CSV file, from Device Management 2.0, return to the Infrastructure menu > select IMPORT CSV > select the updated CSV file.

Each updated Portal Light is set to a pending configuration status. This status indicates that during their next synchronization with Kio Cloud, they will receive and download their local Wi-Fi settings.

Step 3: Verify Portal Lights connection to local Wi-Fi network

It can take up to five minutes for each Portal Light to synchronize with Kio Cloud to download their local Wi-Fi settings and then connect to the network.

  1. Observe the Portal Lights' LED indicators. You may notice their LED cycling through various colors as they connect to the network and synchronize with Kio Cloud.

  2. After a few minutes and their LED remains a solid GREEN, disable the Kontakt.io Fallback network from your mobile hotspot or Access Point.

  3. Now that the Kontakt.io Fallback network is disabled, you will want to verify the Portal Lights are connecting to the local Wi-Fi network. A Portal Light connects to the Wi-Fi network every 60 seconds.

    After a few minutes, verify each of the Portal Lights LED remains a solid GREEN, indicating a successful connection to the Wi-Fi network, NTP time source, and Kio Cloud.

    If a Portal Light's LED remains RED, it could not connect to the local Wi-Fi network. For additional information, refer to the Portal Light LED indicators.

    If you cannot resolve a connection issue, submit a support request.

Step 4: Download the Kio Setup Manager app

Kontakt.io Infrastructure devices, those that remain in a fixed, stationary position, are required to be installed using the Kio Setup Manager mobile app. If you already have the app, be sure you have the latest version.

Mobile device requirements. The app is available for Apple and Android devices.

  • Device compatibility: iPhone or iPad: iOS version 16 or later | Android phone or tablet: version 8 or later

  • Connectivity: Bluetooth enabled | WiFi connection with Internet

To download the app, go to the App Store or Google Play. Search for Kio Setup Manager.

download-stores.png

Step 5: Sign in to Kio Setup Manager

Things to know

  • User access requirements. You must be assigned to a Device Management role. A role determines your permission level and which devices you can access. For example, a user assigned the Device Management Administrator role has full permissions to all devices. For more information, see Manage user access to Device Management.

  • Account type. You'll need to know if your organization's account is a Tenant or Non-Tenant type. You can identify the account type from the URL used to sign in from a web browser.

    Tenant account type: You sign in to Kio Cloud from an unique URL that includes the Tenant ID. Example: https://[Tenant ID].app.cloud.[us or uk].kontakt.io.

    Non-Tenant account type: You sign in to Kio Cloud from https://app.cloud.us.kontakt.io or https://app.cloud.uk.kontakt.io.

  • Account Region. During sign in, you'll need to select the region of your organization's account.

    The Region is also located in the account URL (https://[Tenant ID].app.cloud.[us or uk].kontakt.io).

Sign in steps

  1. From your mobile device, open Kio Setup Manager.

    The first time you sign in or after reinstalling the app, you will complete all of the following steps. Once you’ve successfully signed in, the app remembers your Sign In Method and Region.

  2. Select a Sign in Method > tap Kio Cloud (most common method).

    Cisco Spaces Account: for use when installing Kontakt.io Portal Beams integrated with Cisco Spaces.

    Sign in with Kontakt.io QR code: for use only when instructed by the Kontakt.io team.

    step-1-sign-in-method.png

  3. Select Region > tap the geographic location of your Kontakt.io cloud account.

    United States: located in North America or Japan-Asia Pacific locations.

    United Kingdom: located in the UK, EU, and other European countries.

    Custom Region: only select when instructed by the Kontakt.io team; for dedicated enterprise accounts only.

    step-2-select-region.png

  4. Enter Tenant ID is dependent on your organization's Kio Cloud account type. Refer to the below table for more details.

    Enter a "Tenant ID" when...

    Tap "I don't have a Tenant ID" when...

    Your organization has a Tenant account. You sign in to Kio Cloud from an unique URL that includes the Tenant ID.

    Example: https://[Tenant ID].app.cloud.[us or uk].kontakt.io

    To sign in: enter the Tenant ID > tap Continue > provide your user credentials (email/password or SSO).

    step-3-enter-tentant-id.png

    You sign in to Kio Cloud from a web browser from either of the below URLs (Non-Tenant account):

    To sign in: provide your Kio Cloud user email and password credentials.

    non-tenant-account-sign-in.jpg

Step 6: Install Portal Lights and assign their location

During this step, you'll assign each Portal Light to its install location. This step is very important as its allows the Kio Cloud Location Engine to accuracy compute the location of Kontakt.io Tags within range of a Portal Light.

  1. Bring your mobile device close to the Portal Light > from the Kio Setup Manager bottom menu, tap Install.

  2. Tap Portal Light > tap Install device.

  3. Tap Assign location.

  4. Follow the step-by-step instructions.

    Scan its QR code; located on the side of the device.

    Power on the Portal Light; plug into an outlet.

    Select its install location including the campus, building, floor, and room.

    From the map, move the Portal Light to its install location within its assigned room. This step is very important as it allows the Kio Cloud Location Engine to accuracy compute the room-level location of Kontakt.io Tags within range of the Portal Light.

    The app automatically adds a Device Note with the install details and sets the Portal Light's Deployment Status to Deployed. When set to a Deployed status, the Portal Light is monitored by Device Health.

  5. Verify that the Portal Light's LED status indicator is GREEN, indicating a successful connection to the Wi-Fi network, NTP time source, and Kio Cloud.

  6. If its LED continues to be RED for more than a few minutes, retry the Installation steps to verify its Wi-Fi network settings The Wi-Fi settings are case sensitive.

    If a Portal Light's LED remains RED, it could not connect to the local Wi-Fi network. For additional information, refer to the Portal Light LED indicators.

    If you cannot resolve a connection issue, submit a support request.

Related articles