Setting Up an External MashZone NextGen Configuration Folder
Most configuration for MashZone NextGen and most of the extensions that you add for your organization’s use are stored in the MashZone NextGen Repository. However, some MashZone NextGen configuration and extensions are file based.
By default, MashZone NextGen keeps configuration and extensions in the MashZone NextGen Server web application in these folders:
<MashZone NextGen installation/apache-tomcat/mashzone/WEB-INF/classes for class, configuration and extension files
<MashZone NextGen installation/apache-tomcat/mashzone/WEB-INF/lib and
<MashZone NextGen installation/apache-tomcat/mashzone/WEB-INF/config for JAR files.
You can move most of these configuration and extension files to folders that are external to the MashZone NextGen Server.
Important: MashZone NextGen documentation refers to all of these folders as MashZoneNG-config.
Using external configuration folders for MashZone NextGen is a best practice as they simplify deployment and upgrades of the MashZone NextGen Server. They also simplify configuration management for clustered environments. External configuration folders are not required, however.
To create and use an external configuration folder for MashZone NextGen
Create the top-level external folder to use for MashZone NextGen configuration, such as PrestoConfig. In clustered environments, share or mount this folder across the entire cluster.
You can create subfolders under this external folder to organize configuration and extensions.
For clustered environments, create subfolders under the top-level external configuration folder for:
The standard classes and lib folders.
Built-in and user-defined functions for use in RAQL queries for MashZone NextGen Analytics. See
Configure, Compile, Deploy and Test User-Defined Functions
for more information.
If not complete, finish configuration for the MashZone NextGen Server and move the configuration and extension files to the external configuration folder or an appropriate subfolder. See the
section for the specific configuration steps, files and locations.
Add the external MashZone NextGen configuration folder, and any subfolder that contains extensions or JAR files, to the classpath for the application server(s) hosting the MashZone NextGen Server.
You may update the classpath in configuration files or in the startup script for the application server.
For Windows environments, for example, you can edit the tomcat-install/bin/setenv.bat file and update the classpath environmental variable to be something like this:
set "CLASSPATH=%CLASSPATH%;C:\PrestoConfig;C:\PrestoConfig\classes;C:\PrestoConfig\lib;C:\PrestoConfig\db\jdbc"
On Linux, Mac OS X or UNIX systems, you would update tomcat-install/bin/setenv.sh to something like this: