Integrate Software AG Products Using Digital Event Services 10.4 | Integrate Software AG Products Using Digital Event Services | MashZone NextGen Help | Appendix | Administration | MashZone NextGen Server Administration | Deploying MashZone NextGen Instances, Clusters or Artifacts | Setting Up an External MashZone NextGen Configuration Folder
 
Setting Up an External MashZone NextGen Configuration Folder
 
MashZone NextGen File-Based Configuration and Extensions
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:
*MashZoneNG-install/apache-tomcat/mashzone/WEB-INF/classes for class, configuration and extension files
*MashZoneNG-install/apache-tomcat/mashzone/WEB-INF/lib and MashZoneNG-install/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
1. 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.
2. 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.
3. 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 MashZone NextGen File-Based Configuration and Extensions section for the specific configuration steps, files and locations.
4. 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:
CLASSPATH="$CLASSPATH":/users/PrestoConfig:/users/PrestoConfig/classes:/users/PrestoConfig/lib:users/PrestoConfig/db/jdbc

Copyright © 2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release