https://github.com/opennms/grpc-server
https://github.com/opennms/grpc-server
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/opennms/grpc-server
- Owner: OpenNMS
- Created: 2020-01-22T05:00:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-05T22:01:54.000Z (almost 3 years ago)
- Last Synced: 2025-04-20T18:42:38.968Z (about 1 year ago)
- Language: Java
- Size: 91.8 KB
- Stars: 1
- Watchers: 12
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GRPC-IPC-Server
This GRPC IPC Server acts as a bridge between minions running gRPC IPC strategy and OpenNMS running Kafka strategy.
## Compile:
Make sure to have OpenJDK 11 and Maven 3 installed on your system.
```
mvn package
```
## Compile with Docker:
```
docker build -t opennms/grpc-server .
```
## Prerequisites
* Minions running GRPC strategy.
* OpenNMS running Kafka strategy with single topic.
## Start the server
```
java -jar grpc-ipc-server.jar
```
## Start the server with kafka hostname
```
java -jar target/grpc-ipc-server.jar localhost:9092
```
A more comprehensive example:
```
java -jar target/grpc-ipc-server.jar \
-Dorg.opennms.instance.id=Apex \
-Dtls.enabled=true \
-Dserver.private.key.filepath=/grpc/key.pem \
-Dserver.cert.filepath=/grpc/cert.pem \
-Dclient.cert.filepath=/grpc/client.pem \
-Dport=8990 \
-Dmax.message.size=10485760 \
-Dorg.opennms.core.ipc.grpc.kafka.producer.acks=1 \
kafka1.example.com:9092
```
## Start the server using Docker
```
docker run \
-e INSTANCE_ID=Apex \
-e TLS_ENABLED=true \
-e SERVER_PRIVATE_KEY=/grpc/key.pem \
-e SERVER_CERT=/grpc/cert.pem \
-e CLIENT_CERT=/grpc/client.pem \
-e PORT=8990 \
-e MAX_MESSAGE_SIZE=10485760 \
-e PRODUCER_ACKS=1 \
-e BOOTSTRAP_SERVERS=kafka1.example.com:9092 \
-v $(pwd)/grpc:/grpc
opennms/grpc-server
```