Getting Started with Docker

Docker enables you to deliver software quickly by separating your applications from your infrastructure. Thus, Docker acts as an “isolated, resource controlled, and portable operating environment” that can host any specific application on any machine without the hassle of deploying the environment manually.

NCache provides NCache Enterprise for Windows and Linux Server hosted on the Docker Hub. Once the Docker environment has been set, according to its prerequisites, you can pull the relevant images to start working on NCache.

Using these images, you can create containers that host NCache or create your own customized images by modifying the Dockerfiles.

NCache Docker Images on Docker Hub

The easiest and quickest way to start using NCache is to fetch a pre-built NCache Docker Image from Docker Hub. These Docker images come preinstalled with NCache. Simply use “docker pull” command to install them in your environment. To get start with Docker in NCache follow the steps mentioned below.

Install Docker.
Verify the correct installation by using the following:

docker version

If you are unable to get the version number, check Docker Troubleshooting section.

Pull the NCache Docker image from Docker Hub

docker pull alachisoft/ncache:latest

Preserving Resources in NCache Docker Instances

You must use static resources like IP and MAC addresses to maintain the integrity of your NCache Docker instance. This ensures that even after restarting the NCache Docker instance, your resources remain intact. Otherwise, there is a possibility of the instance being assigned a new IP and MAC address upon restart (as this is the default behavior), which not only impacts the configuration settings but may also invalidate licensing. Here is the command that you can use to ensure that these resources are not lost upon Docker instance restart:

docker run --name=ncache-server-01 --net=nbrg --ip=10.2.0.4 -itd --mac-address 00:00:00:00:00:10 alachisoft/ncache:latest

Register NCache

In order to use NCache, you first need to register your machine. You can either register for free evaluation by selecting Start Free 60 Day Trial or activate NCache by selecting Activate with License Key.

Register NCache Using Installation Key

If you want to register for free evaluation, use the following command.

Windows
Linux

Register-NCacheEvaluation -Key xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name

register-ncacheevaluation -key xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -firstname John -lastname Smith -email john@yourdomain.com -company your_company_name

Note

To activate your NCache license, you need to have the license key from Alachisoft Sales.

Register NCache with the Purchased License Key

If you want to activate NCache with a purchased license, use the following command:

Windows
Linux

Register-NCache -Key xxxxxxxxx-xxxxxx-xxxxxxxx -Environment Production -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name

register-ncache -key xxxxxxxxx-xxxxxx-xxxxxxxx -environment Production -firstname John -lastname Smith -email john@yourdomain.com -company your_company_name

NCache Docker References

The Dockerfiles provided by NCache at GitHub contain commands to build images for NCache. Before you proceed any further, you need to clone this repository to your local machine, download the NCache setup and place it under the respective Enterprise resource folder.

Moreover, NCache also provides Dockerfiles and supporting resources on GitHub to allow for more flexibility while using the NCache Docker images. You can use these Dockerfiles to make a customized image based on your dependencies to cater to specific needs.

NCache Docker Tag

For using NCache Enterprise Docker on Windows and Linux (.NET Edition), please consider the following tag:

alachisoft/ncache:latest