On this page, you will find the installation link, requirements, settings and deployment stages for discovery, classification or other topics.
Installation
GEODI can work with a log on user or as a Windows service. We suggest it to work as a service. To ease some of the following steps, we suggest you to do the installation with the service user.
Download setup file and trigger it.
Licence code will be required during the setup phase. With a valid licence code, modules that are included in the licence will be installed automatically via DECE-STORE. For an offline installation environment, modules will be provided by DECE team.
GEODI management interface will be opened in the browser with http://127.0.0.1:3323/manager address after installation.
GEODI server must be reachable from other machines for classification or agent discovery implementations. DNS and SSL definitions must have been made for this reason.
You need to create the Windows service for GEODI to work continuously. GEODI Setup as a Windows Service
Congratulations, you installed GEODI. The next step is to download templates from DECE-STORE.
The Frequently Asked Questions page provides issues and solutions you might encounter during installation or other processes.
Update
We constantly update the software because we value quality and user experience. For a GEODI update, running the "update.bat" command that comes with the installation as an administrator is sufficient. You run the command and leave it. All necessary operations will be performed on a running system.
You can turn "update.bat" command to a scheduled task with an authorized user.
Updates for PC Discovery (GDE) and Classification Agents are fully automatic.
GEODI modules get updates more frequently than the main GEODI version. To update modules only, you may run UpdateModules.bat.
GEODI AppDataFolder
GEODI stores workspace definitions, indexes, and logs in the %appdata% directory that belongs to the login user. This directory is created automatically during installation. If the user who installed GEODI and the Windows service user differ, the following settings should be made. Otherwise, you won’t have access to the license or other information generated during installation.
Set AppDataFolder
value in SystemSettings.json
file to change the folder. For details → https://decesw.atlassian.net/wiki/x/RofcUg
You may also use this method if there is insufficient space in the default %appdata%
folders.
GEODI must be closed during these changes.
The existing %appdata% directory must be moved into the new folder. After %appdata% is moved into the new directory, read/write permissions must be assigned to the service user. The existing project(s) and license info remain valid that way.
Defining SSL Certificate
For Classification and Agent PC Discovery projects, the GEODI address must be secure and accessible from clients. You must make the following settings in GEODI for the SSL Certificate. For details you may refer to System Configuration - Security Settings page. Definitions must be made before agent deployments.
SSL definitions are made in the SystemSettings.json
file in the GEODI installation directory.
"AppPort":443,
"NoSSLPort":80,
"ForceHttpsRedirect":true,
"SSLLocalCertificateSerial":"<certificate-serial-number>"
To obtain the certificate serial number, run the Manage User Certificates application. The serial number is in the properties/details tab under the Personal directory. If you have a *.pfx file, double-click it to install it.
Load Balancer Case: In cases where certificates are managed with a load balancer, you do not need to make any additional definitions on the GEODI side.
GEODI Installation as a Windows Service
After installation, GEODI is turned into a service that will run continuously by starting the GEODI.WindowsServiceInstall.bat file as administrator. Windows will ask for your administrator username and password.
The user is expected to have access permissions for directories and other Windows sources which GEODI will index. If the user does not have access to these sources, you need to add authorized users to GEODI as well. If you’d like to uninstall the service, you can do it by running GEODI.WindowsServiceUnInstall.bat, which is in the same directory.
GEODI service will take its place as “GEODI.WindowsService” in the service list. You can start/stop it whenever you like.
While the service is getting started, GEODI.exe must be closed. GEODI.exe may be run when the service is started, the .exe file will connect with the service automatically. You may use this process in rare cases which require the Windows Form interface.
Mapped Sources
GEODI kaynaklarında MAP edilmiş bir dizin kullanıyorsanız veya açılışta yapılması gereken diğer işler için GEODI → Settings/BatchFiles/Startup dizininde gerekli *.bat file konulmalıdır.
If GEODI sources include a mapped directory or for other works that needs to be done at startup, the necessary *.bat file must be put in GEODI → Settings/BatchFiles/Startup directory.
Offline Environment Preparation
GEODI downloads the modules from DECE-STORE by default. If the server cannot access DECE-STORE, you should make the following settings.
DECE teams will provide you
*.GeodiModuleX
files and you should put them in the<geodifolder>/LocalDECESTORE
folder. DECE teams will update you with new files when they are available.Then, the
ModuleStoreFolder
value inSystemSettings.json
should be set to<geodifolder>/LocalDECESTORE.
That’s all!
No extra processes are needed for GDE and Classifier agents.
You can update GEODI by downloading new Setup files with the traditional way.
License Update
Run LicenseUpdate.bat to open the dialog.
If you need to move the GEODI to another machine, you should deactivate the license and then reactivate it on the new machine.
You should also apply the new license keys on the same dialog.
You do not need to stop the service.