Create Cache Cluster in EKS

After deploying all necessary services, now you need to create a cache cluster inside your EKS cluster. You can create a cache cluster either through NCache Web Manager or through NCache PowerShell module (ncacheps).

Note

You can only use NCache PowerShell module if your NCache client image is deployed using .NET SDK instead of runtime.

Using NCache Web Manager

Follow the steps mentioned below to create a cache cluster through NCache Web Manager.

To access the Web Manager within the EKS cluster, you need the URL of the NCache ingress. Execute the following command to get this URL:
```
kubectl get ingresses
```
Assuming you’ve named your NCache ingress resource as ncache, you will get something like the following output if successful:
```
Name            HOSTS                    ADDRESS                           PORTS                    AGE
ncache            *             xxx.<eks-region>.elb.amazonaws.com          80                      32s
```
Copy the value under the ADDRESS into your browser address bar and you will be directed the NCache Web Manager service on one of the cache nodes running inside the EKS cluster.

ncweb-manager-gateway-access

From here you need to create a cache cluster. Follow the steps provided in Create New Clustered Cache to create a new cache cluster using NCache Web Manager.

Important

Make sure the server IP addresses are the same as the ones shown in the result of the following command

kubectl get pods -l app=nccache -o wide

Using PowerShell

You can create a cluster and add nodes to it through NCache PowerShell tool. Follow the steps provided below:

Run NCache PowerShell by executing the following command in AWS command line interface:
```
kubectl exec <client_pod_name> -- pwsh -NoExit
```
Follow the steps mentioned in Create Cache Cluster to create a cache cluster and add nodes to it through NCache PowerShell.

Important

The node IPs when adding server nodes to the cluster should be the same as the IPs mentioned when the following command is executed:

kubectl get pods -l app=ncache -o wide

Note

Start cache on all server nodes.

Connect Clients to Cache

After the cache cluster is created and the cache is started on all nodes, connect clients to the cache. You can do this by following any of the given methods:

Using GetCache() API

Connect to the cache using the GetCache() method of NCache.
To connect clients to your cache, follow the steps provided in Connect to Cache.
The following code snippet shows how the cache discovery service can be introduced when initializing the cache handle:

ICache cache = CacheManager.GetCache("democlusteredcache", new CacheConnectionOptions
{
    ServerList = new List<ServerInfo> { new ServerInfo("cacheserver")}, // other parameters
});

Using the Client Config File

Go to your client.ncconf file placed at %NCHOME%/config in Windows and at opt\ncache\config in Linux machines.
Add the name of the cache headless discovery service created earlier in Create Discovery Service in EKS in the <server name> tag under the name of your cache cluster as shown below:

<cache id="democlusteredcache" ...">
    <server name="cacheserver"/>
</cache>

Run NCache Client

Now that you have your cluster set up, you need to run your client application by executing the following command in the AWS command line interface.

kubectl exec --namespace=ncache client-podname -- /app/clientapplication/run.sh democlusteredcache cacheserver

Once the cache cluster is formed and clients are connected to it, you can monitor your cache cluster and clients, explained in the next chapter.

Create Cache Cluster in EKS

Note

Using NCache Web Manager

Important

Using PowerShell

Important

Note

Connect Clients to Cache

Using GetCache() API

Using the Client Config File

Run NCache Client

See Also