The Data360 Analyze application uses a couple of prop files to get build information or properties. Theses files contain information about the application, for example- the version and product type. The application references these files to determine it's behavior, and are a key part of the overall system configuration.
There are two prop files on the Server and Desktop installations - site.prop and cust.prop.
SERVER PROP FILES
1. Cust.prop
This file is located under the site directory. On a Windows installation, the path should be similar to C:\Users\<userName>\Data3SixtyAnalyze\site-7731\conf.
Properties and their corresponding values can be added to the cust.prop file, but a typical cust.prop looks like this:
ls.brain.server.port=xxxx
ls.brain.webapp.port=xxxx
ls.lae.system.backup.backupFileLocation="xxxx"
ls.lae.system.backup.maxBackupFiles=20
ls.lae.system.backup.scheduledBackupsEnabled=true
ls.lae.system.backup.scheduledBackupsCronExpr="0 0 2 1/1 * ? *"
ls.lae.allowDownload=true
ls.lae.shareRootDir="xxxx"
ls.lae.security.secureStorePassword=
ls.brain.server.port - your server port chosen at time of installation
ls.brain.webapp.port - your webapp port chosen at time of installation
ls.lae.system.backup.backupFileLocation - the application takes a backup of your system daily, and this property tells Analyze where to store the backup. The default location is the data directory. On a Windows installation, the path to the backups should be similar to C:/Users/<userName>/Data3SixtyAnalyze/data-7731
ls.lae.system.backup.maxBackupFiles - this tell the application how many backups to keep
ls.lae.system.backup.scheduledBackupsEnabled - this property allows you to disable the scheduled backups so that they will not be taken
ls.lae.system.backup.scheduledBackupsCronExpr - this property tells the application what time to take the backup at. The value is a cron expression. Before 3.6.0, the default time for a backup was 2 AM, however in 3.6.0 that has changed to noon
ls.lae.allowDownload - setting this to false will disable your Downloads button in the UI
ls.lae.shareRootDir - the home directory of where a user can upload / download files via the UI
ls.lae.security.secureStorePassword - your security store password chosen at time of installation
====================================================================
2. Site.prop:
This file is located under the installation directory. On a Windows installation the path should look similar to: C:\Program Files\Data3SixtyAnalyze\conf
ls.home=""
ls.arch=""
ls.brain.node.java.javaExtDirs=("")
ls.appDataDir=""
ls.dataDir=""include "${ls.home}/conf/ls.prop"
ls.brain.server.licensePath="${ls.appDataDir}/conf"
ls.brain.machineName=""
ls.brain.server.host="*UNDEFINED*"
ls.brain.ioMethod="file"
ls.brain.tempDir=""
ls.brain.logDir=""
ls.desktop.install=false
ls.lae.security.secureStorePath=""
ls.brain.server.logDir="${ls.brain.logDir}"
include "${ls.appDataDir}/conf/cust.prop"
ls.brain.drone.executor.binary.extensionHandler.py="${ls.home}/platform/${ls.arch}/python/python.exe"
ls.home - the application installation directory
ls.arch - the architecture upon which the application is installed (ie Windows or Linux)
ls.brain.node.java.javaExtDirs -
ls.appDataDir - the Data directory that Analyze uses to store important files, for example: data flow and node execution details, and encrypted files such as your security JKS files
ls.dataDir - home directory of the data-7731 folder
ls.brain.server.licensePath - the location of your license file
ls.brain.machineName - your computers hostname
ls.brain.server.host - this is a parameter used by our legacy product LAE for configuration of server farms. There's no server farming in Analyze so this should not be changed.
ls.brain.ioMethod - this is another feature from our legacy product, LAE, whereby you had the option to split temp files out on different shared drives. However, that's no longer an option in Analyze.
ls.brain.tempDir - the location of your temp files. When you run a data flow the details are sent here
ls.brain.logDir - the location of your log files. There are three elements to Analyze: the Analyze server, the webapp (Tomcat) and the database. Each time they are used, entries are written to their log files.
ls.desktop.install - this property tells the application whether the product is a Server or a Desktop
ls.lae.security.secureStorePath - the location of your security store
ls.brain.server.logDir - the location of your Analyze server log. This should have the same value as the ls.brain.logDir property
ls.brain.drone.executor.binary.extensionHandler.py - this allows us to specify custom handlers to use when executing python nodes. This property should not be changed.
====================================================================
DESKTOP PROP FILES
1. Site.prop
Depending on how you installed Analyze, the site.prop for the Desktop is located under:
C:\Program Files\Data360Analyze\conf - if you installed Analyze as "Local User"
or
C:\ProgramData\Data360Analyze\conf - if you installed Analyze as "All Users"
ls.home=""
ls.arch="windows-x86-64"
ls.installdir=""
ls.brain.node.java.javaExtDirs=("")
ls.appDataDir=""
ls.dataDir=""
include "${ls.home}/conf/ls.prop"
ls.desktop.install=false
ls.brain.server.licensePath=""
ls.brain.machineName=""
ls.brain.server.host="localhost"
ls.brain.ioMethod="file"
ls.brain.tempDir=""
ls.tempDir=""
ls.brain.logDir=""
ls.lae.security.secureStorePath=""
ls.brain.server.logDir="${ls.brain.logDir}"
ls.brain.characterSet="windows-1252"
include "${ls.appDataDir}/conf/cust.prop"
ls.brain.drone.executor.binary.extensionHandler.py="${ls.home}/platform/${ls.arch}
/python/python.exe"
ls.home - the application installation directory
ls.arch - the architecture upon which the application is installed (ie Windows or Linux)
ls.installdir- the location where the software is installed
ls.brain.node.java.javaExtDirs -
ls.appDataDir - the Data directory that Analyze uses to store important files, for example: data flow and node execution details, and encrypted files such as your security JKS files
ls.dataDir - home directory of the data-7731 folder
ls.desktop.install - this should be set to TRUE for Desktops. Users cannot change this property as it disables login on screen.
ls.brain.server.licensePath - the location of your license file
ls.brain.machineName - your computer's hostname
ls.brain.server.host - this is a parameter used by our legacy product LAE for configuration of server farms. There's no server farming in Analyze so this should not be changed.
ls.brain.ioMethod - this is another feature from our legacy product, LAE, whereby you had the option to split temp files out on different shared drives. However, that's no longer an option in Analyze.
ls.brain.tempDir - the location of your temp files. When you run a data flow the details are sent here, which is the executions folder by default.
ls.tempDir - the location where your temp data is stored. By default it's stored under <installationDirectory>/tmp
ls.brain.logDir - the location of your log files. There are three elements to Analyze: the Analyze server, the webapp (Tomcat) and the database. Each time they are used, entries are written to their log files.
ls.lae.security.secureStorePath - the location of your security store
ls.brain.server.logDir - the location of your Analyze server log. This should have the same value as the ls.brain.logDir property
ls.brain.characterSet - the character set used by the software
ls.brain.drone.executor.binary.extensionHandler.py - this allows us to specify custom handlers to use when executing python nodes. This property should not be changed.
====================================================================
2. Cust.prop
The cust.prop file for the Desktop should be located here: C:\Users\<username\AppData\Local\Data360Analyze\site\conf
ls.brain.server.port=7731
ls.brain.webapp.port=8080
ls.lae.disableRunDataSharing=false
ls.lae.system.backup.backupFileLocation=
ls.lae.system.backup.maxBackupFiles=20
ls.lae.system.backup.scheduledBackupsEnabled=true
ls.lae.system.backup.scheduledBackupsCronExpr="0 0 12 1/1 * ? *"
ls.lae.security.secureStorePassword=
ls.brain.server.port - the port the Analyze server uses
ls.brain.webapp.port- the port the Analyze webapp (Tomcat) uses
ls.lae.disableRunDataSharing -
ls.lae.system.backup.backupFileLocation - the location of your daily backups
ls.lae.system.backup.maxBackupFiles - the number of files you wish to retain before the system purges them. The default is 20
ls.lae.system.backup.scheduledBackupsEnabled - boolean value telling the system whether to take daily backups or disable them
ls.lae.system.backup.scheduledBackupsCronExpr - this property tells the application what time to take the backup at. The value is a cron expression. Before 3.6.0, the default time for a backup was 2 AM, however in 3.6.0 that has changed to noon
ls.lae.security.secureStorePassword - your security store password
CHANGING THE DEFAULT LOCATIONS:
You can change the default locations for any of the properties. However, if you are running the server version it will need to be restarted for the changes to take affect. If you're running the Desktop, you'll need to run Stop Data360 Analyze from the Start menu.
When you upgrade the change will be lost and it will have to be repeated. In order for the changes to persist across upgrades, you'll need to copy any required properties over from site.prop to cust.prop and change it in cust.prop. If the required property is already in cust.prop then no copying action is required - just change the value and restart.
If you'd like more information on the contents of this article, please let us know by posting in the comments below, or email me directly at ccostello@infogix.com
Comments
0 comments
Please sign in to leave a comment.