Use Cache Docker on Linux

Once the docker containers for NCache are created and started, you need to connect to them and activate/register them for evaluation. This guide will take you through the process of connecting to your containers and then activating them or registering them for evaluation.

Launch NCache Management Center in Docker

Once your machine is connected, the NCache Management Center will be automatically launched in the default browser of your machine. Otherwise, you can manually launch the NCache Management Center in your browser by browsing to http://localhost:8251 or <server-ip>:8251

Register NCache Docker Container

In the NCache Management Center, you will be prompted with 'Your machine is not registered' window. In order to use NCache, you first need to register your machine. You can either register for free evaluation by selecting Start Free 30 Day Trial or activate NCache by selecting Activate with License Key. You can also choose to ignore the message for now by clicking on Ask me Later, however, you will not be able to use NCache meanwhile.

Note

You will only be able to use NCache once your machine is either registered for free trial or activated with a license key.

Notification

Register for Free Evaluation

If you want to register for free evaluation, follows these steps.

  • Click on Start Free 30 Day Trial and you will be redirected to Start NCache Trial page. Provide the free trial activation key that you received from Alachisoft Support and the user information. Then click Activate.
Note

If you don't have the free trial activation key, you can get it using Click Here.

Evaluation

  • On success, you will be prompted with a success notification saying NCache has been successfully registered for Free Evaluation.
Note

You can also register for NCache evaluation using Register-NCacheEvaluation PowerShell cmdlet as an administrator.

Activate with License Key

If you want to activate NCache with a purchased license, follow these steps.

  • Click on Activate with License Key and you will be redirected to Activate License page. Provide the license key that you received from sales@alachisoft.com and environment details. Click Next.

Activation

  • Provide the information of user for which NCache has been registered and click Activate.

Activation Credentials

  • On success, you will be prompted with a success notification saying NCache has been successfully License Activated.
Note

You can also activate NCache using Register-NCache PowerShell cmdlet as an administrator.

Important

You need to do the registration/activation for all cache servers either through the NCache Management Center or PowerShell.

Connect to Container

Once the NCache containers are created and running, you can access these containers by using docker exec command and specifying the container name of the newly created container.

The following command connects you to the container ncache-ent-server-01 in interactive mode using the docker exec command and opens a PowerShell instance within it.

docker exec -it ncache-ent-server-01 pwsh

Import NCache PowerShell Module

It is required to import the NCache module so that NCache tools can be executed.

Note

NCache is installed by default in /opt/ncache/ in Linux.

PS > Import-Module /opt/ncache/bin/tools/ncacheps/

You can now proceed to manage NCache with PowerShell. Refer to the NCache PowerShell Reference for full coverage of NCache cmdlets.

Activate NCache Container

Important

It is assumed that you already have the license key. If not, then you can get it from our sales team by sending an email to sales@alachisoft.com.

Once you have connected to your container, you can Activate NCache using the license key you obtained from Alachisoft Sales. The following command activates the license for the container ncache-ent-server-01. The environment is set to production.

Register-NCache -Key xxxxxxxxxxxxxxxxx -FirstName your_first_name -LastName your_last_name -Email email@yourdomain.com -Company your_company_name -Environment production

Use NCache in Container

Once you have connected to the container and activated/registered it for evaluation, you can perform administrative tasks through NCache PowerShell cmdlets and the NCache Management Center. This includes managing caches, clusters, security and deploying providers, and much more.

Note

To access the NCache Manager of your container, browse to <server-ip>:1251 on the host machine.

See Also

Create Containers in Linux NCache Dockerfile for Linux NCache Docker on Windows