Use NCache Docker on Linux
Once the 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
- Once your machine is connected, the NCache Management Center will automatically launch in your default browser. Otherwise, you can manually launch NCache Management Center by browsing to
<server-ip>:8251
.
Register NCache 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 a free evaluation by selecting Start Free 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 if you choose this option.
Note
You will only be able to use NCache once your machine is either registered for a free trial or activated with a license key.
Register for Free Evaluation
If you want to register for a free evaluation, follow these steps.
- Click on Start Free 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 relevant user information. Then click Activate.
Note
If you don't have the free trial activation key, you can get it Here.
- If successful, you will be prompted with a notification stating "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 the Activate License page. Provide the license key that you received from sales@alachisoft.com and environment details. Click Next.
- Provide the information of the user for which NCache has been registered and click Activate.
- 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 the 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 Command-Line tools. Refer to the NCache Command-Line 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 the NCache Command-Line tools and the NCache Management Center. This includes managing caches, clusters, security, deploying providers, and much more.
Note
To access the NCache Management Center of your container, browse to <server-ip>:8251
on the host machine.
See Also
Create Containers in Linux
NCache Dockerfile for Linux
NCache Docker on Windows