# Node: Greengrass IPC

[**Return to main sample list**](../../README.md)

This sample uses the AWS IoT [Greengrass IPC Client](https://aws.github.io/aws-iot-device-sdk-js-v2/node/modules/greengrasscoreipc) to defined a Greengrass component that subscribes to MQTT messages
on a topic in AWS IoT Core and periodically publishes messages to that topic.

Note: For this sample to work, you must have configured and installed the AWS Greengrass software on the local host.  The IAM role
assumed by the Greengrass Nucleus must also include permissions to connect, subscribe, and publish to AWS IoT Core.

## Deploying the Component

First, go to the `./artifacts/com.amazon.RpcTest/1.0.0` folder and run the following command:

``` sh
npm install
```

Then, from this folder, run the following Greengrass CLI command:

Linux:
``` sh
sudo <path-to-greengrass-cli-executable> deployment create --recipeDir ./recipes --artifactDir ./artifacts --merge "com.amazon.RpcTest=1.0.0"
```

Windows:
``` sh
<path-to-greengrass-cli-executable> deployment create --recipeDir ./recipes --artifactDir ./artifacts --merge "com.amazon.RpcTest=1.0.0"
```

Check your nucleus logs and component log for details about the success of the deployment and component execution.  See 
the [AWS Greengrass Documentation](https://docs.aws.amazon.com/greengrass/v2/developerguide) for more
details about Greengrass components, Greengrass IPC, and the Greengrass CLI.