# CLB Integration Configuration The CLB integration relies on an agent that must be run on the CLB Windows Server. The steps below are required to configure this. First step, head to the Home in the Nexus Care platform, and click "New" in the Sources section. From there, select CLB. This will provision a new CLB integration for the site, now download the agent via the button provided and place it somewhere on the CLB server. We'll need that shortly. ### Preparing CLB We'll next need to prepare the CLB software and create a Generic External Device for us to connect to. Open the CLB Configurator software and open Locations: [![Screenshot 2025-12-04 at 09.04.01.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/ee7VAk4mgvAChHFX-screenshot-2025-12-04-at-09-04-01.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/ee7VAk4mgvAChHFX-screenshot-2025-12-04-at-09-04-01.png) Select System Components, then head to Location Management and click Technical Room. This will create a new Technical Room that you can rename on the right: [![Screenshot 2025-12-04 at 09.21.24.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/sbBnw5RYVXeSP6s4-screenshot-2025-12-04-at-09-21-24.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/sbBnw5RYVXeSP6s4-screenshot-2025-12-04-at-09-21-24.png) Once this is done press "Ok" and this will close this window. Next, head to Externals in the top menu. From here, let's click to create a Generic external device in the top menu. Give it a descriptive name, ensure it is using a port not in use by another integration, and select the location we just created in the Location section: [![Screenshot 2025-12-04 at 09.07.03.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/HjUcIosgYYLgGgL8-screenshot-2025-12-04-at-09-07-03.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/HjUcIosgYYLgGgL8-screenshot-2025-12-04-at-09-07-03.png) Next, go to the Notification sub-type mapping tab and select all entries in the list ensuring you scroll all the way to the bottom and select them all: [![Screenshot 2025-12-04 at 09.26.17.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/3FY7N7kn1YZS5wMp-screenshot-2025-12-04-at-09-26-17.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/3FY7N7kn1YZS5wMp-screenshot-2025-12-04-at-09-26-17.png) Once this is done, head to Monitoring settings, tick the care home (or name of the home) and then the check all box for the list on the right. Also tick the options to the right of the list, ticking the first one should then automatically tick them all. [![Screenshot 2025-12-04 at 09.26.59.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/ZQSGw5Z6Fn9Hego8-screenshot-2025-12-04-at-09-26-59.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/ZQSGw5Z6Fn9Hego8-screenshot-2025-12-04-at-09-26-59.png) Next, head back to the General tab and press Apply. Keep this window open as we'll need some information from here shortly. ### Configuring The Agent Now that CLB is ready, we need to configure the agent! Run the .exe file downloaded earlier. As there is no configuration file, this will create it for us and immediately exit. You'll see this in the folder: [![Screenshot 2025-12-04 at 09.22.10.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/h2eJwcj5cdJxLWTt-screenshot-2025-12-04-at-09-22-10.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/h2eJwcj5cdJxLWTt-screenshot-2025-12-04-at-09-22-10.png) Now, open the config file and edit the information below: [![Screenshot 2025-12-04 at 09.22.45.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/M36hNi4bHZr6lMiO-screenshot-2025-12-04-at-09-22-45.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/M36hNi4bHZr6lMiO-screenshot-2025-12-04-at-09-22-45.png) clb\_server will typically be 127.0.0.1 as we run this locally on the CLB server. clb\_port will be the port number we assigned earlier client\_id is a UUID that CLB automatically generates, it is in the Call Handling section of the Generic External we created earlier. type\_id is also located in the same place, typically it will be GenericClient but always check! api\_key is provided in the nexus care platform, this allows the agent to relay the data to our cloud. Copy and paste this from the same page you downloaded the agent from earlier. Once this is configured, save and close the file and start the agent to ensure it connects. You should see the grey icon in the externals list turn green (as pictured below). This is great! Now, stop the agent by closing its window. You will get an error from CLB to let you know it has disconnected, this is normal. [![Screenshot 2025-12-04 at 09.12.46.png](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/scaled-1680-/pYzx2tttYPjjYnp3-screenshot-2025-12-04-at-09-12-46.png)](https://docs.nexuscare.co.uk/uploads/images/gallery/2025-12/pYzx2tttYPjjYnp3-screenshot-2025-12-04-at-09-12-46.png) ### Configure Scheduled Task To ensure Windows keeps the agent running, we'll use a scheduled task. This allows the agent to start whenever the server boots and restart if it stops unexpectedly. 1. **Open Task Scheduler** - On the CLB Windows Server, press `Win + R`, type `taskschd.msc`, and press Enter (or search for it in the Start Menu). - This opens the Task Scheduler management console. 2. **Create a New Task** - In the right-hand Actions pane, click **Create Task** (not “Create Basic Task” — we need more options). - Give the task a descriptive name, e.g., **CLB Agent Service**. 3. **Set Security Options** - Under the **General** tab: - Select **Run whether user is logged on or not**. - Check **Run with highest privileges** to ensure the agent has the necessary permissions. 4. **Configure Triggers** - Go to the **Triggers** tab and click **New**. - Choose **At startup** so the agent launches whenever the server boots. - Optionally, add a second trigger: **On a schedule** (e.g., daily at midnight) to restart the agent if needed. 5. **Configure Actions** - Go to the **Actions** tab and click **New**. - Set **Action** to **Start a program**. - In **Program/script**, browse to the agent `.exe` file you downloaded earlier. - Leave **Add arguments** blank unless specific flags are required. - Set **Start in** to the folder containing the `.exe` file (this ensures the config file is found). 6. **Set Conditions** - In the **Conditions** tab, uncheck **Start the task only if the computer is on AC power** (important for servers). - Ensure **Wake the computer to run this task** is checked if the server may sleep. 7. **Set Recovery Options** - In the **Settings** tab: - Check **Allow task to be run on demand**. - Check **Restart the task if it fails** and set retry attempts (e.g., every 1 minute, up to 3 times). - Ensure **If the task is already running, then the following rule applies: Do not start a new instance** is selected to avoid duplicates. - Ensure you disable **"Stop the task if it runs longer than"**. 8. **Save and Test** - Click **OK** and enter administrator credentials when prompted. - Right-click the task and select **Run** to test it. - Verify the agent starts and connects (the CLB external device icon should turn green again).