Troubleshooting Playground
If you are using the Playground installer to launch Playground and want to use both clients, you must set up an environment for both.
Playground .NET Samples Require .NET 6.0 SDK
Playground requires the .NET 6.0 installed on the system to Run the .NET code samples and .NET 6.0 SDK to Compile & Run the .NET samples. If .NET 6.0 SDK is not present on the system, then the .NET samples Compile & Run console output presents the user with the message "Playground Samples require .NET 6.0 or newer to be installed on the system".
Workaround
- Download and install .NET 6.0.
- Stop the Playground process using the command below:
Stop-NCachePlaygroundProcess
- Start the Playground process using the command below:
Start-NCachePlaygroundProcess
Playground Java Samples Require Java-JDK-17 and Maven
Playground requires JDK 17 and the necessary Maven packages to be installed for the Run and Compile & Run functionality of Java samples.
If JDK17 is not installed, then the Java samples Run console output presents the user with the following error message:
"NCache Samples require Java-JDK-17 or newer to be installed on the system. If you have Java installed in your system, make sure that the 'JAVA_HOME' environment variables are set correctly. After that, please update the 'JAVA_HOME' property in the appsettings.json file to point to the installation directory of Java. The appsettings.json file is located at
%NCHOME%\bin\tools\playground\app\appsettings.json(Windows) and$NCHOME/ext/playground/app/appsettings.json(Linux)".If the necessary Maven packages are not pre-installed, then the Java samples Compile & Run console output presents the user with the following error message:
"Before using NCache Playground on Windows, please ensure that Apache Maven is installed on your system. Make sure that the 'MAVEN_HOME' environment variables are set correctly. After installing Maven, please update the 'MAVEN_HOME' property in the appsettings.json file to point to the installation directory of Maven. The appsettings.json file is located at
%NCHOME%\bin\tools\playground\app\appsettings.json(Windows) and$NCHOME/ext/playground/app/appsettings.json(Linux)."
Workaround
- Download and install JDK 17.
- Set the Environment Variable for Java Home.
- Download and install the Maven.
- Update the maven_home property in the appsettings.json file placed at %NCHOME%\bin\tools\playground\app.
- Stop the Playground process using the command below:
Stop-NCachePlaygroundProcess
- Start the Playground process using the command below:
Start-NCachePlaygroundProcess
