Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nongvantinh/janusgraph-with-dotnet

This "Hello World" project is meant to demonstrate how to start JanusGraph with a Cassandra backend and Elasticsearch in a Docker environment, then connect to it using the C# GremlinClient.
https://github.com/nongvantinh/janusgraph-with-dotnet

cassandra dotnet elasticsearch janusgraph

Last synced: 5 days ago
JSON representation

This "Hello World" project is meant to demonstrate how to start JanusGraph with a Cassandra backend and Elasticsearch in a Docker environment, then connect to it using the C# GremlinClient.

Host: GitHub
URL: https://github.com/nongvantinh/janusgraph-with-dotnet
Owner: nongvantinh
Created: 2024-10-16T15:38:24.000Z (4 months ago)
Default Branch: master
Last Pushed: 2024-11-03T17:50:42.000Z (3 months ago)
Last Synced: 2024-12-11T00:34:57.651Z (2 months ago)
Topics: cassandra, dotnet, elasticsearch, janusgraph
Language: Shell
Homepage:
Size: 9.77 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

For docker compose example, please see branch 1.0:

---

# Testing Interaction Between .NET and JanusGraph

This "Hello World" project demonstrates how to set up JanusGraph with a Cassandra backend and Elasticsearch in a Kubernetes environment, then connect to it using the C# GremlinClient.

## Prerequisites
- **Minikube**: Installed and running.
- **Kubernetes CLI (kubectl)**: Installed and configured for local Minikube usage.
- **.NET SDK**: Installed for running the C# application.

## Running the Setup

1. **Start Minikube and Enable the Tunnel**
Open a terminal, then start Minikube and set up the tunnel to allow access to your Kubernetes services.

```bash
minikube start
minikube tunnel
```

> **Note**: The tunnel command must be kept running in a separate terminal while you are working with the services.

2. **Deploy Kubernets resources**

```bash
./database.sh --setup --update-host
```
Run the following command to check the ingress-nginx Namespace and ensure the controller Pod is running.

```bash
kubectl get pods -n ingress-nginx -l app.kubernetes.io/name=ingress-nginx
```
```bash
NAME READY STATUS RESTARTS AGE
ingress-nginx-admission-create-78jjl 0/1 Completed 0 84s
ingress-nginx-admission-patch-cc9pr 0/1 Completed 0 84s
ingress-nginx-controller-79fcc99b4-qn69k 1/1 Running 0 84s
```

Don’t worry about the Completed Pods. These were short-lived Pods that initialized the environment.
Once the controller Pod is running, you have an NGINX Ingress controller and are ready to create some Ingress objects.

3. **Verify Pods are Running**
After deploying, check that all pods are up and running:

```bash
kubectl get pods
```

You should see output similar to the following:

```
NAME READY STATUS RESTARTS AGE
cassandra-0 1/1 Running 0 13m
elasticsearch-0 1/1 Running 0 13m
janusgraph-7f84d455cd-hrtxp 1/1 Running 0 13m
```

Ensure each pod status is "Running." If not, refer to the troubleshooting section below.

5. **Run the .NET Application**
Navigate to the `MyJanusGraphApp` project directory and build and run the C# application:

```bash
cd MyJanusGraphApp
dotnet build
dotnet run
```

If successful, the terminal will display a sample response from JanusGraph.

6. **Clean Up**
To delete the resources when finished, run:

```bash
./database.sh --cleanup
```

## Troubleshooting

If you encounter issues during setup, here are some common solutions:

### 1. Pods in "CrashLoopBackOff" or "OOMKilled" Status
If any pods (such as Cassandra or Elasticsearch) fail to start and show "CrashLoopBackOff" or "OOMKilled" statuses, it is likely due to insufficient memory.

**Solution**:
- Edit the `janusgraph-cassandra-elasticsearch.yaml` file to reduce the memory requirements for Cassandra and Elasticsearch:
```yaml
env:
- name: MAX_HEAP_SIZE
value: "512M"
- name: HEAP_NEWSIZE
value: "100M"
```

- For Elasticsearch, set:
```yaml
env:
- name: ES_JAVA_OPTS
value: "-Xms512m -Xmx512m"
```

- Reapply the changes:
```bash
kubectl apply -f janusgraph-cassandra-elasticsearch.yaml
```

### 2. Unable to Connect to Services
If the application is unable to connect to JanusGraph or other services:
- Ensure all services are port-forwarded correctly.
- Verify that each service is accessible by using:
```bash
curl http://localhost:8182 # JanusGraph
curl http://localhost:9200 # Elasticsearch
```

### 3. Checking Pod Logs
For further troubleshooting, view the logs of any failing pod to diagnose issues:

```bash
kubectl logs
```