(v22) Manage the Real Time Sales Demo Source

Manage the Real Time Sales Demo Source

A demo data source called Real Time Sales (RTS) is included as part of the Composer installation package. This data generator simulates a real-time data stream; allowing users to interact with and explore Composer's capabilities without the need to connect to a data source. However, this demo source, by default, is not available in the Composer Client and must be manually activated. This topic walks you through how to enable and disable the demo source.

A known issue with real-time streaming sources such as this demo source exists. If such sources are left enabled for an extended period of time, 'Out of Memory' errors may occur in the Composer Server. To avoid this problem, disable such sources when not in use.

Before you can establish a connection from Composer to RTS, a data source configuration for the demo source needs to be enabled and set up. See Enable the Real Time Sales Demo Source and Set Up the Real Time Sales Demo Source . To manage the availability for RTS, see Manage Connectors and Connector Servers.

After the connector has been set up, you can create data source configurations that specify the necessary connection information and identify the data you want to use. See Manage Data Source Configurations for more information. After data sources are configured, they can be used to create dashboards and visuals from your data. See Create Dashboards.

Composer Feature Support

Real Time Sales Demo support for specific Composer features is shown in the following table.

Key: Y - Supported; N - Not Supported; N/A - not applicable

Feature	Supported?
Admin-Defined Functions	N/A
Box Plots	Y
Custom SQL Queries	N/A
Derived Fields (Row-Level Expressions)	N/A
Distinct Counts	Y
Fast Distinct Values	N/A
Group By Multiple Fields	Y
Group By Time	Y
Group By UNIX Time	N
Histogram Floating Point Values	Y
Histograms	Y
Kerberos Authentication	N/A
Last Value	Y
Live Mode and Playback	Y
Multivalued Fields	N/A
Nested Fields	N/A
Partitions	N/A
Pushdown Joins for Fusion Data Sources	N/A
Schemas	Y
Text Search	N/A
TLS	N/A
User Delegation	N/A
Wildcard Filters	Y
Wildcard Filters, Case-Insensitive Mode	Y
Wildcard Filters, Case-Sensitive Mode	Y

Enable the Real Time Sales Demo Source

To enable the Real Time Sales demo source, use an automated script that activates the demo source in the Composer client. This script, labeled create-rts.sh, is included as part of the installation package. However, the script needs to be run from the Linux prompt, so administrative access to your Linux server is necessary.

RTS is installed in your server as part of the Composer installation process. However, if an alternative installation method was used to manually install each Composer component, you should first confirm whether the RTS package was included during the installation efforts.

More specifically, running the automated RTS script will do the following (in the Composer Client):

1. Add the RTS connector server details in the Composer Client (using port 8108).
2. Define the connection type for the RTS demo source.
3. Create the connection and generate the RTS icon in the Data Source page.

Set Up the Real Time Sales Demo Source

To set up the RTS demo source, take the following steps:

1. Log out of the Composer client and close the browser window.

2. Access the Linux prompt and log into your Composer Server (via Secure Shell or SSH).

3. From your Linux prompt, run the RTS script:

   sudo /opt/zoomdata/lib/create-rts.sh -a admin:<YourAdminPassword> 
   -s supervisor:<YourSupervisorPassword>

Enable RTS After Upgrading Composer

If you are upgrading your Composer Server to the current release version, that version's RTS demo source is deleted during the process and the current version is installed. You need to activate RTS following the same steps outlined above.

Disable the Real Time Sales Demo Data Source

To disable the Real Time Sales demo source, do the following:

• Log in as the supervisor.
• Select the Connectors tab.
• Go to the Connectors list in the bottom half of the Connectors page.
• Locate the RTS connector in the Connectors list.
• Clear the checkbox in the Enabled column associated with the RTS connector.