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:
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
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.
Register-NCacheEvaluation -Key xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -FirstName John -LastName Smith -Email firstname.lastname@example.org -Company your_company_name
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:
Register-NCache -Key xxxxxxxxx-xxxxxx-xxxxxxxx -Environment Production -FirstName John -LastName Smith -Email email@example.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: