Install Solution Builder

To install Solution Builder with DSA, you must use a Chrome web browser.

DSA (Distributed Services Architecture) is an open-source platform that enables disparate devices, logic, and applications to interoperate. When running on DSA, Solution Builder's primary data source is the data provided by DSLinks, which are device- and protocol-specific agents that gather data from devices, enrich it, and publish it to subscribers. The DSA distribution of Solution Builder is packaged with its own web server and a DSA broker, which handles messaging between your applications and data sources and other brokers.

To install Solution Builder with DSA:

1. Using the Chrome web browser, go to the DSA download page.
2. Specify your platform and any DSLinks you want to install with Solution Builder.
3. Click BUILD PACKAGE. The package that you specified is built, then downloaded by your web browser.
4. Extract the downloaded zip file and put the resulting folders in the directory where you want to run the applications.

To start Solution Builder with DSA:

1. At the operating system prompt, navigate to the where you stored the unzipped folders and from there to the subfolder named "dglux-server."
2. To set permissions correctly, In the "dglux-server" folder, issue the following commands: chmod 777 bin/*.sh; sh ./bin/daemon.sh start

To launch Solution Builder in your preferred web browser (again, Chrome is recommended), browse to http://localhost:8080. When prompted for user and password, enter the default user and password: dgSuper / dglux1234. Accept the EULA, and, when prompted, apply for a license and install it when it arrives.

To stop the Solution Builder server, issue the following command: sh ./bin/daemon.sh stop

Installing Solution Builderfor Niagara 4 and Niagara AX

This section tells you how to install the Solution BuilderService on a remote or local Niagara station or on a JACE device. The Solution BuilderService is compatible with Niagara 4.0.22 and higher, and with Niagara AX 3.7 and higher. The following Niagara modules are required:

• alarm
• baja
• bql
• control
• driver
• file
• gx
• history
• nre
• platform
• web

Solution Builder supports the Niagara security model. To run Solution Builder, non-superusers need the following permissions:

• The service object, typically slot:/Services/DgLux5Service
• The Station database (slot:)
• The History database (history:)
• Niagara AX: The content directory (file:!dglux5)

Solution Builder is a 100% HTML5 application that does not require any special browser plugins. For the best experience, use the latest version of Chrome. The following web browsers are supported:

• Chrome 21+
• Internet Explorer 11+
• Firefox 22+
• Opera 15+
• Safari 6.1+

Installing the Module

To install the dglogik module on a local engineering tool, perform the following steps. These steps are required to install Solution Builder on remote Niagara stations.

1. Stop all running stations and close all instances of the engineering tool.
2. Download the Solution Builder installation file for your Niagara platform from the DGLogik downloads web page.
3. Change the extension of the installation file from .dist to .zip.
4. Unzip the file.
5. Copy the dglogik.jar file from the unzipped folder to the Niagara modules directory. Be sure you are copying the file to the correct folder for your version of Niagara.
6. Restart the engineering tool and verify that you can open the DGLogik palette.

Installing to a Remote Station

To install Solution Builder to a remote Niagara station, perform the following steps.

1. Download the installation file for your Niagara platform from the DGLogik downloads web page.
2. Open the remote platform.
3. Open the Distribution File Installer in the remote platform.
4. When prompted, navigate to the dowloaded .dist file on your local computer and click Install.
5. Restart the station.
6. To add the service, open the DGLogik palette in the engineering tool, copy the DGLux5Service object, and paste it under the Services node in the station database (station:|slot:/Services).

Installing to a Local Station

To install Solution Builder on a local Niagara Supervisor or local SoftJACE, perform the following steps.

1. Stop all running stations and close all instances of the engineering tool.
2. Download the installation file for your Niagara platform from the DGLogik downloads web page.
3. Change the extension of the installation file from .dist to .zip.
4. Unzip the file.
5. NIAGARA 4 ONLY: In the folder where you unzipped the installation file, edit the installLocalWebContent.bat file as follows: Change the Niagara version to the one that you are using (for example, "4.1"). If you are using a brand of Niagara other than Tridium, replace "Tridium" with the correct brand name.
6. NIAGARA 4 ONLY: In a command window, navigate to the directory that contains the installLocalWebContent.bat file and run it.
7. NIAGARA 4 ONLY: When installation is complete, copy the niagara_home\modules\dglogik.jar file to the Niagara 4 modules directory (typically C:\Niagara\Niagara-4.n.nnn\modules\). Be sure you are copying the file to the correct subfolder for your version of Niagara.
8. To add the service in the engineering tool, copy the DGLux5Service object from the palette to the Services node in the station database (station:|slot:/Services).

If space is not an issue on your JACE device, you can install Solution Builder as described above. If space is an issue, install only the core components for Solution Builder by performing a remote install using the JACE installer. After installing the core components, download the required templates and widgets, launch Solution Builder, and import them into your project.

The following list shows how much space is consumed by the components of Solution Builder:

• Solution Builder core (required): ~20 MB
• Project Assist 2.0 templates (optional):
• Without widgets or styles: 750 KB (not recommended)
• Without the HVA2C library: 3 MB
• With the HVAC2 library: 28 MB
• Templates: 44 KB to 500 KB per template
• Widget libraries: 103 KB to 21 MB per library

Updating the Solution Builder JAR File

To update only the dglogik.jar module file, use your engineering tool to perform the following steps.

1. Perform a local installation as described above in Installing the Module.
2. In the engineering tool, go to the Platform Software Manager for the remote station. Verify that the "dglogik" module is out of date. (If it is not, verify that you installed Solution Builder to the correct directory for your version of Niagara.)
3. Select the dglogik module.
4. Press the "Upgrade" button. Be careful not to inadvertently upgrade other modules.
5. Press the "Commit" button.
6. If prompted, restart the station.

Launching Solution Builder and Logging In

To launch Solution Builder, open a web browser and perform the following steps:

1. In the address bar, specify the URL using the host and port where you installed Solution Builder, for example localhost:8080/dglux5.
2. When prompted, log in as user dgSuper with the default password dglux1234.
3. Select Help > License and click the Request License button.

To update only the dglogik.jar module file, use your engineering tool to perform the following steps.

1. Update your engineering tool as described above in Installing the Module.
2. In the engineering tool, go to the Platform Software Manager for the remote station and verify that the "dglogik" module is out of date. (If it is not, verify that you installed the module in the correct version of Niagara.)
3. Select the dglogik module and press the "Upgrade" button. Be careful not to inadvertently upgrade other modules.
4. Press the "Commit" button.
5. If prompted, restart the station.