# IoT SiteWise processor
<a name="iotsitewise-processor-component"></a>

The IoT SiteWise processor component (`aws.iot.SiteWiseEdgeProcessor`) enables Amazon IoT SiteWise Classic streams, V2 gateways to process data at the edge.

With this component, Amazon IoT SiteWise gateways can use asset models and assets to process data on gateway devices. For more information about Amazon IoT SiteWise gateways, see [Using Amazon IoT SiteWise at the edge](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/gateways-ggv2.html) in the *Amazon IoT SiteWise User Guide*.

**Note**  
The data processing pack (DPP) feature will no longer be open to new customers starting November 7, 2025. If you would like to use DPP, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see [Data processing pack availability change](https://docs.amazonaws.cn/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html) in the *Amazon IoT SiteWise User Guide*.

**Topics**
+ [Versions](#iotsitewise-processor-component-versions)
+ [Type](#iotsitewise-processor-component-type)
+ [Operating system](#iotsitewise-processor-component-os-support)
+ [Requirements](#iotsitewise-processor-component-requirements)
+ [Dependencies](#iotsitewise-processor-component-dependencies)
+ [Configuration](#iotsitewise-processor-component-configuration)
+ [Local log file](#iotsitewise-processor-component-log-file)
+ [Licenses](#iotsitewise-processor-component-licenses)
+ [Changelog](#iotsitewise-processor-component-changelog)
+ [See also](#iotsitewise-processor-component-see-also)

## Versions
<a name="iotsitewise-processor-component-versions"></a>

This component has the following versions:
+ 3.5.x
+ 3.4.x
+ 3.3.x
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Type
<a name="iotsitewise-processor-component-type"></a>

<a name="public-component-type-generic"></a>This <a name="public-component-type-generic-phrase"></a>component is a generic component (`aws.greengrass.generic`). The [Greengrass nucleus](greengrass-nucleus-component.md) runs the component's lifecycle scripts.

<a name="public-component-type-more-information"></a>For more information, see [Component types](develop-greengrass-components.md#component-types).

## Operating system
<a name="iotsitewise-processor-component-os-support"></a>

This component can be installed on core devices that run the following operating systems:
+ Linux
+ Windows

## Requirements
<a name="iotsitewise-processor-component-requirements"></a>

This component has the following requirements:
+ The Greengrass core device must run on one of the following platforms:
  + os: Ubuntu 20.04 or later

    architecture: x86\_64 (AMD64)
  + os: Red Hat Enterprise Linux (RHEL) 8

    architecture: x86\_64 (AMD64)
  + os: Amazon Linux 2

    architecture: x86\_64 (AMD64)
  + os: Windows Server 2019 or later

    architecture: x86\_64 (AMD64)
  + os: Debian 11 (Bullseye) or later

    architecture: x86\_64 (AMD64)
+ The Greengrass core device must allow inbound traffic on port 443.
+ The Greengrass core device must allow outbound traffic on port 443 and 8883.
+ The following ports are reserved for use by Amazon IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080, and 50010. Using a reserved port for traffic can result in a terminated connection.
**Note**  
Port 8087 is required only for version 2.0.15 and later of this component.
+ The [Greengrass device role](https://docs.amazonaws.cn/greengrass/v2/developerguide/device-service-role.html) must have permissions that allow you to use Amazon IoT SiteWise gateways on your Amazon IoT Greengrass V2 devices. For more information, see [Requirements](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements) in the *Amazon IoT SiteWise User Guide*.

### Endpoints and ports
<a name="iotsitewise-processor-component-endpoints"></a>

This component must be able to perform outbound requests to the following endpoints and ports, in addition to endpoints and ports required for basic operation. For more information, see [Allow device traffic through a proxy or firewall](allow-device-traffic.md).


| Endpoint | Port | Required | Description | 
| --- | --- | --- | --- | 
| `model.iotsitewise.{{region}}.amazonaws.com` | 443 | Yes | Get information about your Amazon IoT SiteWise assets and asset models. | 
| `edge.iotsitewise.{{region}}.amazonaws.com` | 443 | Yes | Get information about the core device's Amazon IoT SiteWise gateway configuration. | 
| `ecr.{{region}}.amazonaws.com` | 443 | Yes | Download Amazon IoT SiteWise Edge gateway Docker images from Amazon Elastic Container Registry. | 
| `iot.{{region}}.amazonaws.com` | 443 | Yes | Get device endpoints for your Amazon Web Services account. | 
| `sts.{{region}}.amazonaws.com` | 443 | Yes | Get the ID of your Amazon Web Services account. | 
| `monitor.iotsitewise.{{region}}.amazonaws.com` | 443 | No | Required if you access Amazon IoT SiteWise Monitor portals on the core device. | 

## Dependencies
<a name="iotsitewise-processor-component-dependencies"></a>

When you deploy a component, Amazon IoT Greengrass also deploys compatible versions of its dependencies. This means that you must meet the requirements for the component and all of its dependencies to successfully deploy the component. This section lists the dependencies for the [released versions](#iotsitewise-processor-component-changelog) of this component and the semantic version constraints that define the component versions for each dependency. You can also view the dependencies for each version of the component in the [Amazon IoT Greengrass console](https://console.amazonaws.cn//greengrass). On the component details page, look for the **Dependencies** list.

The following table lists the dependencies for versions 2.0.x to 2.1.x of this component.


| Dependency | Compatible versions | Dependency type | 
| --- | --- | --- | 
| [Token exchange service](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | Hard | 
| [Stream manager](stream-manager-component.md) | >=2.0.10 <3.0.0 | Hard | 
| [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | Hard | 

For more information about component dependencies, see the [component recipe reference](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuration
<a name="iotsitewise-processor-component-configuration"></a>

This component doesn't have any configuration parameters.

## Local log file
<a name="iotsitewise-processor-component-log-file"></a>

This component uses the following log file.

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/aws.iot.SiteWiseEdgeProcessor.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeProcessor.log
```

------

**To view this component's logs**
+ Run the following command on the core device to view this component's log file in real time. Replace `{{/greengrass/v2}}` or {{C:\\greengrass\\v2}} with the path to the Amazon IoT Greengrass root folder.

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/aws.iot.SiteWiseEdgeProcessor.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait
  ```

------

## Licenses
<a name="iotsitewise-processor-component-licenses"></a>

This component includes the following third-party software/licensing:

### Third-party Licenses
<a name="w2ab1c24b8d120c25b5b1b1"></a>
+ Apache-2.0
+ MIT
+ BSD-2-Clause
+ BSD-3-Clause
+ CDDL-1.0
+ CDDL-1.1
+ ISC
+ Zlib
+ GPL-3.0-with-GCC-exception
+ Public Domain
+ Python-2.0
+ Unicode-DFS-2015
+ BSD-1-Clause
+ OpenSSL
+ EPL-1.0
+ EPL-2.0
+ GPL-2.0-with-classpath-exception
+ MPL-2.0
+ CC0-1.0
+ JSON

<a name="component-core-software-license"></a>This component is released under the [Greengrass Core Software License Agreement](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="iotsitewise-processor-component-changelog"></a>

The following table describes the changes in each version of the component.


|  **Version**  |  **Changes**  | 
| --- | --- | 
| 3.5.1 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.4.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.3.1 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.3.0 | [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html) [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html) | 
| 3.2.1 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.2.0 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.1.3 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.1.1 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.1.0 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 3.0.0 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.2.1 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.37 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.35 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.34 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.33 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.32 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.31 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.29 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.28 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.24 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.23 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.1.21 |   Upgrading from 2.0.x to 2.1.x will result in loss of local data.  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.16 | This version contains bug fixes and improvements. | 
| 2.0.15 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.14 | This version contains bug fixes and improvements. | 
| 2.0.13 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.9 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.7 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.6 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.5 |  [See the AWS documentation website for more details](http://docs.amazonaws.cn/en_us/greengrass/v2/developerguide/iotsitewise-processor-component.html)  | 
| 2.0.2 | Initial version. | 

## See also
<a name="iotsitewise-processor-component-see-also"></a>
+ [What is Amazon IoT SiteWise?](https://docs.amazonaws.cn/iot-sitewise/latest/userguide/what-is-sitewise.html) in the *Amazon IoT SiteWise User Guide*.