The InsightCM Server requires configuration and maintenance to ensure its functionality, accessibility, and performance.
-
Configuring InsightCM–Manage the settings of your InsightCM server that enable web client accessibility, security, and expandability.
-
Maintaining InsightCM–Optimize your system by managing packages and configuring an aging strategy for data.
Manage the settings of your InsightCM server that enable web client accessibility, security, and expandability.
Before you begin, upgrade to InsightCM 3.8.5 on your server machine.
Complete the following tasks to ensure that your system is accessible, secure, and complete.
-
Open Required Ports–Open required network communication ports to access the web application and to initiate data collection.
-
Enable and Require SSL Connections–Configure your settings to require a secure connection to access the web application.
-
Integrate InsightCM with Windows Active Directory–Integrate InsightCM with your Windows Active Directory to require users to log in with Windows account credentials.
-
Create Roles and Assign Permissions–Manage roles with differing levels of permission for editing or accessing your InsightCM system.
-
Learn about and Configure Historian Software–Learn how InsightCM Server can connect to data historians with the purchase, activation, and enablement of the Enterprise Gateway option.
-
Configure Your Server Fleet–Configure your server fleet by modifying the .json file that installed to your server with InsightCM.
-
Define a Transceiver–Configure your server fleet by modifying the .json file that installed to your server with InsightCM.
Open required network communication ports to access the web application and to initiate data collection.
Before you begin, install InsightCM on your machine.
Open required ports to access the web application. Without opening the necessary ports, you cannot configure your assets and devices or begin data collection.
Complete the following steps to open the ports according to your monitoring needs.
-
Review the following table of ports and the details provided for each to determine which ports you need to unlock.
Port
Type
Description
Details
80
TCP (outbound)
Application Image Deployment
Required
82*
TCP (inbound)
HTTP Web Application
Not required if enabling connection to the web application via SSL.
482*
TCP (inbound)
HTTPS Web Application
Only required if enabling connection to the web application via SSL.
3580
TCP (outbound)
Application Image Deployment
Required
5353
UDP (inbound)
InsightCM Device Communication
Used to find devices on the server's subnet. Only affects the functionality of the "Browse" button when adding devices.
5672
TCP (inbound)
InsightCM Internal Service Communication
Only necessary if using the SDK to communicate with the server from another device.
6343**
TCP (inbound)
InsightCM Device Web Service
Retrieves device information relating to hardware, system health, and connection. Also, sends commands, such as reboot, to the device.
8002
TCP (outbound)
InsightCM Device Communication
Sends measurement and system data from a device to the server.
*Configurable through IIS
**Configurable through InsightCM
-
Open the necessary ports.
Now that you have opened the necessary ports to access the web application, secure your web application by enabling and requiring SSL connections.
Create an API key to enable access to InsightCM data services.
-
Click the Navigation menu () and select Options.
-
Scroll down to Security and click Web API Keys.
-
Click New to generate a new API key.
-
Copy the API key and save it in a text editor for reference later.
-
Delete a Web API Key
Use the API key you generated to enable secure access to InsightCM data services from your API.
Access your InsightCM data services in your preferred programming language using the HTTP API.
Before you begin, generate an API key.
Cutsforth recommends enabling Secure Sockets Layer (SSL) or Transport Layer Security (TLS) before proceeding to ensure that the key is encrypted as it is passed over the network.
-
Use the following web service API to connect to InsightCM programmatically and acquire data. All endpoints return a JSON string.
Path
Method
Description
/IcmApi.svc/assets
GET
Get all the equipment asset nodes and their parents.
/IcmApi.svc/asset-subtree/{assetId}
GET
Get all the descendants of an asset node.
/IcmApi.svc/assets/version
GET
Get the asset collection version.
/IcmApi.svc/data-events/{assetId}?
startTs={startTs}&endTs={endTs}&skip=0&take=100
GET
Get data events for an asset.
/IcmApi.svc/trend-points/{trendId}?
startTs={startTs}&endTs={endTs}&skip=0&take=100
GET
Get trend points.
/IcmApi.svc/data-event/{dataEventId}
GET
Get data sets.
/IcmApi.svc/archived-data-event/{assetNodeId}?ts={ts}
GET
Get archived data sets.
/IcmApi.svc/active-trend-alarms?skip=0&take=100
GET
Get active alarms.
-
Provide the API key as an HTTP Authorization header in your code. Refer to the examples below for how this can be done in C# and Python.
-
Confirm that you can successfully call InsightCM data services by passing the URL of your InsightCM Server and the API key in the Command Line Interface (CLI) or in the interface for your application.
Example 1. C# and Python Examples
Providing the API Key in C#
var client = new HttpClient(); client.BaseAddress = new Uri(address); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Api-Key", key); var response = await client.GetAsync("IcmApi.svc/assets"); response.EnsureSuccessStatusCode();
Providing the API Key in Python
connection = http.client.HTTPConnection(address) headers = {"Authorization": "Api-Key {0}".format(key)} startTs = int((datetime.now() - timedelta(days=1)).timestamp()) connection.request("GET", "/IcmApi.svc/dataEvents/ {0}?startTs={1}".format(asset["Id"], startTs), headers = headers) response = connection.getresponse() if response.status != 200: raise Exception("Request failed with status {0}".format(response.status))
Enable Secure Sockets Layer (SSL) connections for access to the web application.
Before you begin, create or provide an SSL certificate.
By default, users do not need to access the web application via an SSL connection. However, as of version 3.8.5 and newer, an SSL certificate will need to be added to the web server configuration for the HTPPS site to function.
Once an SSL certificate has been created or provided, complete the following steps to enable SSL connections to the web application.
-
Open the Internet Information Services (IIS) Manager application from the Windows start menu.
-
In the Connections tree, expand the asset representing the server.
-
Expand Sites and select InsightCM.
-
In the Actions pane, click Bindings.
-
In the Site Bindings dialog box, select the https item and click the Edit button.
-
Select an SSL certificate you created.
-
Click OK in the Edit Site Binding dialog box and then click Close to return to IIS Manager.
Users can now access the web application via the following URLs: //serverDNSHostname
and https://serverIpAddress
. However, users are still able to access the web application through non-SSL (HTTP) connections.
Now that you have enabled SSL connections, require SSL connections (see Requiring SSL Connections).
Integrate InsightCM with your Windows Active Directory to require users to log in with Windows account credentials.
Complete the following steps to enable LDAP on your browser.
-
In File Explorer, navigate to the following location:
C:\ProgramData\Cutsforth\InsightCM\Auth
-
Open the
LoginAuth.json
file in a text file editor. -
Modify each line category according to a Windows account in your organization.
Note
Do not set
DisableBuiltinAccounts
totrue
until after you assign your Windows credentials to an InsightCM role. You will be unable to log in because your credentials lack the necessary permissions.Note
InsightCM uses the DirectoryEntry class to facilitate the LDAP connection. In the LoginAuth.json file,
LdapServiceAccountUserName
andLdapServiceAccountPassword
are the username and password by the DirectoryEntry class. If you define an LdapDomainName, InsightCM adds it followed by a backslash to the beginning of the username. The LdapConnectionString is used as the path in the DirectoryEntry class. See the example below. -
Save the changes you made to the file.
-
Log into the web application with the Windows account used to modify the
LoginAuth.json
file.
{ "DisableBuiltinAccounts": false, "LdapConnectionString": "LDAP://icm.com/OU=Test,DC=ICM,DC=COM", "LdapDomainName": "icm.com", "LdapUsernameFilterToken": "sAMAccountName", "SessionTimeoutMinutes": 7200, "LdapServiceAccountUserName": "Administrator", "LdapServiceAccountPassword": "SecretPassword" }
Now that users are required to log in with their Windows credentials, assign roles and permissions to each Windows user. After adding Windows Active Directory users to InsightCM roles, disable the built-in accounts and remove the stored LDAP username and password in the .json file.
Note
See Setting up Email Notifications for password format requirements.
Manage roles with differing levels of permission for editing or accessing your InsightCM system.
Before you begin, integrate your InsightCM system with your Windows Active Directory.
Assign individual users to roles with specific permissions in the InsightCM web application to ensure each user has the appropriate level of access.
-
In the Options dialog, click Roles and Permissions under the Security category.
-
Click the Role pull-down menu and select an existing role.
A list of permissions assigned to that role populates in the Permissions field below the pull-down.
-
Click Add next to the Permissions field to assign additional permissions to the role.
Note
For a description of available permissions, refer to the List of InsightCM Web Application Permissions.
-
Click Add next to the Active Directory Roles field to associate one or more Active Directory Roles with the InsightCM role.
-
Enter each Active Directory account that you want to add to the InsightCM role, or use the Browse LDAP by user for groups button to find which Windows accounts are recognized by the web application.
-
Click OK to exit the Active Directory Role dialog, verify that the correct Active Directory account(s) appear in the Active Directory Roles field, and click OK.
Any Active Directory user you associated with this InsightCM role has the corresponding permissions.
Note
If you assign an Active Directory user to multiple InsightCM roles, the user receives the permissions of all associated roles.
After assigning Windows Active Directory users to InsightCM roles, return to the LoginAuth.json
file and set DisableBuiltinAccounts
to true
and remove the stored LDAPServiceAccountUserName
and LDAPServiceAccountUserPassword
.
Note
Unless you disable built-in roles, users can log into the web application by entering the name of a role and no password.
Permissions determine which features in the InsightCM web application a user can access after logging in. Several factors determine which permissions a user receives:
Permissions |
The ability to see and/or configure specific pages or tabs in the web application. You assign permissions to roles. |
Role |
An administrator-defined persona with assigned permissions. NoteRefer to the Creating Roles and Assigning Permissions topic to learn how to define new roles and how to configure new or existing roles. |
Active Directory group |
A group in the Windows Active Directory service running on the server machine that contains user accounts. Groups map to roles. Refer to Integrating InsightCM with Windows Active Directory to require users to authenticate with Active Directory. |
User account |
An account on the Windows domain whose credentials a user enters to log in to the web application. Accounts belong to Active Directory groups and therefore, they receive the permissions from any role to which their Active Directory group is mapped. |
The following diagram shows the relationship between all four items. Notice that the user accounts receive permissions via a group. In other words, you cannot apply a set of permissions to just one account because you must apply a set of permissions to a group.
Permissions determine which features in the web application users can access when they log in. Assigning permissions to a user is a two-step process: creating a role with the desired permissions, and then mapping a user to the role.
Note
If you have LDAP configured but have no explicit permissions assigned to your role, you will be unable to log in to InsightCM. Refer to Integrating InsightCM with Windows Active Directory for more information.
The following list describes the permissions you can assign to web application roles:
Features |
Locations Affected |
---|---|
Enables access to the Acknowledge button on the Active Trend Alarms and Active Spectral Alarms tabs of the Alarms page. |
|
Displays option to force clear alarms. |
|
Enables access to the Add Annotation button for spectral alarms. |
Navigation menu () » Alarms » Active Spectral and double-click an alarm instance |
Other permissions required: asset_edit, dataEvent_delete
Features |
Locations Affected |
---|---|
Enables the Remove button above the asset tree and access to the following options in the right-click menu within the asset tree:
|
Asset Configuration page |
Enables access to the Remove button on the Devices tab. |
Device Configuration page |
Other permissions required: asset_edit
Features |
Locations Affected |
---|---|
Allow users to add, edit, and remove features. |
Navigation menu () » System » Features |
Allows users to add and remove units for features. |
Navigation menu () » System » Units |
Allows the user to edit asset definitions. |
Asset Configuration page » Action menu () » Edit Asset Definitions |
Allows users to import asset spreadsheets. |
Asset Configuration page » Action menu () » Import/Export » Import Asset Spreadsheet |
Allows users to import device spreadsheets. |
Device Configuration page » Action menu () » Import/Export » Import Devices Spreadsheet |
Other permissions required: device_troubleshooting, alarm_edit, alarm_rule_edit
Features |
Locations Affected |
---|---|
Allows user to add to and edit names and locations in the asset tree. |
Asset Configuration page |
Displays option to disable an asset. |
Asset Configuration pages » asset tree |
Allows user to apply, edit, import, export, or remove an asset template. |
Asset Configuration page » Action menu () » Manage Templates |
Allows the users to add and edit fault frequencies. |
Asset Configuration page » right-click menu for a selected asset |
Allows the user to import and export asset definition files. |
Asset Definition Editor » Action menu () |
Allows the user to create and reset trend baselines. |
Data Viewer () » Trend viewer » Action menu () |
Allows the user to create data event baselines. |
Data Viewer () » Trend viewer » Action menu () |
Allows user to edit device configurations. |
Device Configuration page |
Allows user to change the device name that appears throughout the InsightCM web application. |
Device Configuration page » Action menu () |
Enables access to the Update Application button. |
Device Configuration page » Software tab |
Displays option to disable the device so the device does not try to contact the server or transfer data events. |
Device-related pages » Action menu () |
Displays option to upload, download, and delete devices applications and firmware. |
Navigation menu () » Utilities » Package Management |
Allows users to edit the Auto-Configuration section of the Options dialog box. |
Navigation menu () » Options » Auto-Configuration |
Features |
Locations Affected |
---|---|
Allows users to set aging options for data events and streams in the Options dialog box. |
Navigation menu () » Options » Periodic Aging Strategy OR Streaming Aging Strategy |
Allows users to delete data events and streams from InsightCM Server. |
Data Viewer () » Action menu () » Data Events |
Features |
Locations Affected |
---|---|
Displays the option to reboot a device. |
Device Configuration page » Action menu () |
Displays option to reset the connection information for the device. |
Device Configuration page » Action menu () page |
Features |
Locations Affected |
---|---|
Allows users to add, edit, and remove only email address groups. |
Navigation menu () » Options » Notifications » Address Groups |
Allows users to configure only daily notification reports. |
Navigation menu () » Options » Notifications » Daily Reports |
Features |
Locations Affected |
---|---|
Allows user to edit all of the Server Settings section of the Options dialog box. |
Navigation menu () » Options » Server Settings |
Allows user to edit the Security section of the Options dialog box. |
Navigation menu () » Options » Security |
Allows user to edit spectral alarm rules. |
Navigation menu () » Alarms » Spectral Rules |
Learn how InsightCM Server can connect to data historians with the purchase, activation, and enablement of the Enterprise Gateway option. Connecting InsightCM to your historian software makes it possible for InsightCM to write new data to existing historian points and to pull data from historian points for feature calculation or visualization.
-
AVEVA eDNA Enterprise Data Management—Map data sources in the InsightCM Server to historian points on AVEVA eDNA software. When a device calculates a trend point value, InsightCM writes it to the corresponding historian point.
-
OSIsoft PI System software—Map data sources in the InsightCM Server to historian points on OSIsoft PI System software. When a device calculates a trend point value, InsightCM writes it to the corresponding historian point.
Connect InsightCM to AVEVA eDNA historian software.
-
Download and install the eDNA User Client Services or eDNA Admin Client Services from AVEVA.
-
Request the following 64-bit DLLs from AVEVA:
-
On the InsightCM server, save the 64-bit DLLs in the same location as the DLLs that are included with Client Services.
-
Save a copy of the following DLLs to the same folder in which InsightCM is saved:
-
Open File Explorer and navigate to where the eDNA configuration file was saved:
C:\ProgramData\Cutsforth\InsightCM\Auth\eDNAConfig.json
-
Open the
eDNAConfig.json
file in a text editor and edit each field to match your eDNA server. -
Restart the InsightCM service to integrate a data historian.
-
Start Windows Services.
-
Find and select InsightCM <version>.
-
Click Restart.
-
-
In InsightCM, click Dashboard () and select the Historian tab to check the connection status.
Enable InsightCM to interface with OSIsoft PI System software.
Before you begin, install the OSIsoft PI Asset Framework (AF) Client and activate a run-time license on the same machine that runs InsightCM Server.
-
Launch Windows Services.
-
Select the InsightCM <version> entry in the list of services.
-
Click Restart .
-
Launch InsightCM.
-
Click the Navigation menu () and select System > Historian.
-
Assign the following permission to web application users working with point mappings.
Map sources of data in InsightCM to historian points to write values to the historian software. Whenever the source produces a value, InsightCM writes the value to the corresponding point in the historian software.
InsightCM uses the following components to write data to your historian software.
Component |
Description |
---|---|
Historian Point |
A time-stamped value stored in the historian software. InsightCM uses the point mappings you create in the web application to write values to your historian software. |
Feature |
A measurement derived from collected data. For example, the most recent RMS value from acceleration data that a particular sensor acquires is a feature. Create a point mapping for a feature and InsightCM will write values from that feature to a historian point on the historian software. |
Point mapping |
The mapping of a feature in InsightCM to the name of a historian point in the historian software. |
If the status of a sensor is open, InsightCM does not write the values of features or spectral bands to the historian software, which may result in missing historian points. To check historian points, refer to Reviewing the Latest Value or Querying the Historian Software.
Add point mappings for one or more assets to enable InsightCM to write data to the historian software.
-
Click the Navigation menu () and select System > Historian.
-
In the Point Mappings tab, click Add.
-
In the Choose Assets dialog, select one or more assets.
-
Click Preview to review the list of features associated with the equipment asset that you are creating point mappings for.
-
Ensure that features you want to create point mappings for are selected and that both the asset and the point name are correct.
-
Click Apply to create the point mappings.
Create a point name pattern to automatically generate point mappings for assets.
-
Click the Navigation menu () and select System > Historian.
-
On the Point Name Patterns tab, select an asset type and click Edit.
-
Enter the static text and tokens you want InsightCM to replace with dynamic information about the tag source.
The following list contains tokens you can include in point name patterns. Surround each token with curly braces, as shown. Asset name values are static within historian points and source names.
Now that you have created a new point name pattern, add point mappings for equipment assets.
Review the latest value of one or more historian points.
-
Click the Navigation menu () and select System > Historian.
-
Select one or more point mappings.
-
Click the Action menu () and select Get Point Values.
Note
You can query the historian software. Refer to Querying the Historian Software for more information.
Prevent the InsightCM Server from writing values to specific historian points on the historian software to avoid storing invalid data from a faulty sensor.
-
Click the Navigation menu () and select System > Historian.
-
Select one or more point mappings.
-
Click Edit.
-
Remove the checkmark from the Enabled checkbox.
Query the historian software to troubleshoot or review historian points that InsightCM wrote to the historian software using point mappings.
-
Click the Navigation menu () and select System > Historian.
-
Click the Action menu () and select Query Points.
-
Because the historian software typically returns too much data and causes a timeout error, replace the default query string:
tag='Icm*'
Export information from all pages of the point mappings table to an Excel spreadsheet.
-
Click the Navigation menu () and select System > Historian.
-
Click the Action menu ().
-
Select Export Point Mappings Spreadsheet.
Change point mapping names and enablement by importing an Excel (.xslx
) spreadsheet with the correct information.
Note
You can update only the point mapping names and point enablement by importing a point mappings spreadsheet.
-
Click the Navigation menu () and select System > Historian.
-
On the right, click Action menu ().
-
Select Export Point Mappings Spreadsheet.
You download an Excel spreadsheet with information for every point mapping.
-
Edit the outdated point mappings in the Excel spreadsheet.
-
Save the spreadsheet and return to InsightCM.
-
On the right, click Action menu ().
-
Select Import Point Mappings Spreadsheet.
-
Select the document you saved and click OK.
Add a new point name pattern to make the name of InsightCM data points match the name of historian points in your historian software.
-
Click the Navigation menu () and select System > Historian.
-
On the Point Mappings tab, click Add.
-
Enter static text and tokens you want the web application to replace with dynamic information about the tag.
-
Select the asset type you want to apply the pattern to.
Use tokens as you configure InsightCM's data point naming conventions to match your OSIsoft PI system.
The following list contains tokens you can include in point name patterns.
Note
Asset name values are static within PI point and source names. If you change the name of an asset, PI point and source names do not reflect the change.
Token |
Description |
---|---|
|
Asset name |
|
Asset path including all parent assets |
|
Feature or spectral band name1 |
|
Units of the feature or spectral band |
1You can replace the names of features and spectral bands in the InsightCM Server with custom names.
Refer to Point Name Patterns and Defining Custom Feature Names for examples of using these tokens.
You must activate InsightCM Enterprise Gateway to use point mappings.
To ensure that point names follow a uniform pattern and contain minimal errors, define patterns that create and insert static characters and dynamic information into point names. For example, a point name pattern of Location_{path}_{unit}
results in a point name that looks similar to Location_NorthSite_Motor_AccelerometerX_RMS_g
.
Define custom names to replace default feature names in point mappings. InsightCM inserts the custom names when you apply a point name pattern that contains the {feat}
token.
InsightCM aggregates and lists daily error and alarm notifications on the Notifications page.
-
Click the Navigation menu () and select Notifications.
-
View the notification summary for a date within a seven day range.
-
Click the History button to display the Select Report Date dialog box.
-
Choose which report to display.
-
-
Change the parameters of a notification.
-
Select a notification.
-
Click Edit to change parameters such as the time range or number of transitions covered by the notification.
-
-
Export a notification report spreadsheet to your computer.
-
Click the History button to choose the date for which you want to save a report.
-
Click OK.
-
Click Export.
-
The OPC UA data source supports configurable properties that affect how the device communicates with the OPC device.
Property Name |
Description |
---|---|
Server Endpoint URL |
The OPC UA server URL. |
Interval (sec) |
How often the InsightCM device process reads the device, in seconds. |
Read Timeout (sec) |
How long the read process waits for a response from the OPC server when the client is reading from the server. If the OPC UA server does not respond within the specified timeout, the InsightCM device attempts to re-open a connection after 30 seconds. |
Configure your server fleet by modifying the .json file that installed to your server with InsightCM.
-
Open File Explorer and navigate to the following location:
C:\ProgramData\Cutsforth\InsightCM\Fleet
-
Find the Example.json file and create a copy of the file for each additional InsightCM server that you want to add to your fleet.
-
Rename each file with a descriptive name and modify each line category according to information for each server you are adding to your fleet.
-
"Name" : "Example", "Host": "localhost", "User": "Messagebusconfiguration.json>Username", "Password": "Messagebusconfiguration.json>Password", "Port": 82
-
-
Once you have created and modified a copy of the
Example.json
file for each server, restart the service and log into the web application.
Identify the server machine so your devices can locate the server.
Complete the following steps to configure the device transceiver settings so that the device can reliably communicate with InsightCM Server.
-
Click the Navigation menu () and select Options.
-
Navigate to the Server Settings section and select Transceiver.
-
Click Alternate IP Addresses to view all possible addresses for your server.
-
Determine what to use as your hostname.
Static IP address
If your server has a static IP address or you don't expect your server IP address to change, copy the IP address to use as the hostname.
Fully qualified server name
If you are using a DNS server on your network and you expect your server IP address to change, copy the fully qualified server name to use as the hostname. The server name dynamically links to the server IP address even if the IP address changes. However, using the server name is less reliable than using the IP address. Only use this option in cases where using the IP address is impractical.
-
Paste the address or name into the Hostname field.
-
Uncheck the Use IP Address checkbox if you want the transceiver to use the address that you specified in the Hostname field rather than the default IP address. When you save the server settings, the Transceiver value automatically updates to match the Hostname value.
-
Click OK to restart InsightCM Server and apply the change.
After you save the new server settings, reset the device connection to get the device to send the updated connection information files to the server.
Follow the process outlined below to transfer your InsightCM data and configuration to a new server:
-
Stop the InsightCM and InsightCM MongoDB services.
-
Locate the database and data directories on disk and transfer them to the new server. These are the default locations on disk:
-
Database Directory: C:\ProgramData\Cutsforth\InsightCM\MongoDB
-
Data Directory: C:\ProgramData\Cutsforth\InsightCM\Files
-
-
Install the version of InsightCM that you were previously using on the old server. Be sure to select the correct database and data directories if you are not using the default locations.
-
If you intend to also upgrade to a newer version of InsightCM, Cutsforth recommends first installing the version you were previously using to ensure that the data transfer was successful. Once you have confirmed your new server is working properly, you can upgrade to a newer version.
-
-
Configure the server’s transceiver settings and reconnect all of your devices by selecting Connection » Reset Connection from the Devices page.
-
Additional configuration may still be required to connect to your historian, enable SSL connections, and integrate with Windows Active Directory. See Configuring InsightCM for more information.
Optimize your system by managing packages and configuring an aging strategy for data.
Before you begin, ensure that you have added Cutsforth monitoring devices, mapping, and have acquired data.
Complete the following tasks to manage application packages and to conserve disk space.
-
Manage Packages–Upload and download software packages, which this page refers to as system images or firmware.
-
Configure an Aging Strategy–Conserve disk space by configuring a strategy that automatically deletes historical data when certain conditions are met.
Upload and download software packages, which this page refers to as system images or firmware.
The InsightCM Server installs some default software packages. If you create or receive updated or patched packages, use this page to upload it so you can apply the packages to devices.
Note
You cannot manage packages using Windows 10. Refer to support documentation for more information.
-
Click the Navigation menu () and select Utilities > Package Management.
-
Complete one of the following tasks according to your package management goals.
Update the application that runs on one or more devices.
Upload a software package to the server.
An aging strategy prompts the server to delete historical data if certain conditions are met.
Systems with many devices or with devices performing frequent acquisitions can require significant disk space to store data. InsightCM provides features for automatically discarding data events after configurable conditions are met. This automatic process, called aging, conserves disk space while maintaining a desirable collection of data.
InsightCM applies the periodic aging strategy to individual data events that are not part of a stream. The streaming aging strategy is used to discard entire streams. InsightCM does not retain partial streams.
After the daily aging strategy runs, InsightCM retains a maximum of one trend point per hour, excluding streams. If a data event contains a data set and a trend point, InsightCM counts that as the trend point for that hour and deletes all other trend points.
Note
InsightCM ignores periodic data events triggered by an alarm transition and never deletes them due to aging.
A calendar-based strategy enables you to determine which and how much data to discard. This strategy follows a time-based schedule to discard data events after a configurable number of days. You can configure the strategy to discard all data sets except those collected at a specific time. For example, you can retain some data to trend over an extended period of time by configuring a calendar-based strategy that deletes all periodic data events except those collected at 12:00pm after two days elapse.
You can also choose to retain data events that have alarms or comments associated with them and exclude data events from a particular operating state.
You can identify data that InsightCM exempts from aging on the Trend viewer. The Trend viewer shows data points from times that are exempt from aging rules. For example, if InsightCM is configured to delete all periodic data three days after collecting it, but the Trend viewer displays a value that is five days old, that data point is exempt from aging.
Conserve disk space by configuring a strategy that automatically deletes historical data when certain conditions are met.
To learn more about the periodic and streaming aging strategies, refer to Aging Strategies. Complete the following steps to configure an aging strategy.
-
Click Navigation menu () and select Options.
-
Navigate to Server Settings.
-
Select Periodic Aging Strategy or Streaming Aging Strategy.
-
Use the Aging Strategy pull-down to select the Calendar-Based strategy.
-
Use the text box below the pull-down to specify how many days' worth of data events to retain.
-
Specify time(s) when the device permanently retains the data events it collects.
-
Use the corresponding checkboxes to configure whether data events collected with alarms or for all MCSA Startup events are always retained and whether to retain burst data sets.
-
Use the Never retain data events from pull-down and select an operating state.
-
Click OK.
The following table compares how two different aging strategies operate on data. In these examples, assume Day 1 begins with zero data events.
Strategy |
Day 1 |
Day 2 |
Day 3 |
||||||
---|---|---|---|---|---|---|---|---|---|
Collect |
Delete |
Total Stored |
Collect |
Delete |
Total Stored |
Collect |
Delete |
Total Stored |
|
Calendar-based—Retain from the past two days |
3 |
0 |
3 |
3 |
0 |
6 |
4 |
All 3 collected on Day 1 |
7 |
Calendar-based—Retain from the past two days, and then permanently retain the data event collected at 12:00 PM every day |
3 |
0 |
3 |
3 |
0 |
6 |
4 |
All collected on Day 1 except the one collected at 12:00 PM |
8 |
The calendar-based strategy in the second row is useful when you want to access all acquired data only during the recent past. For example, if an equipment asset fails, you may want to review data from every acquisition that occurred 2 days prior to the failure. However, you may only need to view data from one acquisition per day twenty days prior to failure.
Now that you have configured an aging strategy, learn how to preserve some data events from aging strategies.
Ensure data from a specific acquisition remains available for viewing regardless of aging rules.
Before you begin, you need to have acquired data.
Feature and sensor data remains accessible whenever the Trend viewer time-axis contains the time at which the acquisition occurred. When you choose to retain data, InsightCM retains all the data associated with the sensor acquisition, such as feature values, the time waveform, and other measurements, such as the FFT curve.
Complete the following steps to identify which data events you want to retain.
-
Click the Navigation menu () and select System > Data Events.
-
In the Data Events dialog, select an equipment asset from the asset tree to bring up corresponding log data events on the right.
-
Select the data event of interest that contains data sets.
-
Click Retain.
-
Click OK.
-
Verify that the data event has been marked for retention.