Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 46 Next »

On this page, you will find the installation link, requirements, settings, and deployment stages for discovery, classification, or other topics.

The Frequently Asked Questions page provides issues and solutions you might encounter during installation or other processes.

Support Q - FAQ and Tech News

Installation

  1. Download the setup file and run it. GEODI can work with a log-on user or as a Windows service, which is a must for continuous operation.

  2. A License code will be required during the setup. Modules included in the license will automatically be installed via DECE-STORE. If the server does not have internet access, our teams will provide modules for an offline installation.

  3. After installation, the GEODI Manager Page opens with the address http://127.0.0.1:3323/manager. For Classficviatyion and GDE Discovery Agents, the GEODI server must be reachable from other endpoints. You may need to do DNS and SSL definitions.

  4. Congratulations! You have installed the GEODI. The next step is to install templates for regulations from the DECESTORE.

GEODI Download

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 be able to access 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.

  1. GEODI must be closed during these changes.

  2. 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 continuous service by starting the GEODI.WindowsServiceInstall.bat file as an administrator. Windows will ask for your administrator username and password.

(info) The user is expected to have access permissions for directories and other Windows sources that GEODI will index. If the user cannot access these sources, you need to add authorized users to GEODI as well. If you’d like to uninstall the service, you can run GEODI.WindowsServiceUnInstall.bat 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.

(info) 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.

Subst/Mapped Folders

If GEODI sources include a mapped directory or for other startup-related work, the necessary *.bat file must be put in the GEODI → Settings/BatchFiles/Startup directory.

Software 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.

(info) 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.

Offline Environments

GEODI downloads the modules from DECE-STORE by default. If the server cannot access DECE-STORE, you should make the following settings.

  1. 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.

  2. Then, the ModuleStoreFolder value in SystemSettings.json should be set to <geodifolder>/LocalDECESTORE.

That’s all!

(info) No extra processes are needed for GDE and Classifier agents.

(info) 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.

(info) You do not need to stop the service.

 

Frequently Asked Questions

 What is the benefit of keeping GEODI and Modules up to date?

  1. GEODI and Modules are constantly being developed. As a result of the development (other than resolved problems), better performance, more accurate discovery, higher speed, less dependency on system sources, and more features for both the user and the system administrator are added. Updates come out monthly; we suggest you follow them.

  2. Update information can be followed on the GEODI Download webpage.

 Should I take precautions for Windows System updates?

  1. No, GEODI will stop the service automatically and start it again when the system starts. There is no need for manual intervention.

  2. Index Changed Content and Scheduled Index Backup are active by default. As long as you don’t change these settings, you don’t lose anything in unexpected shutdowns (Killing the service manually, Power outage, etc.)

 What should I do to update the licence?

You should apply the method that is explained in https://decesw.atlassian.net/wiki/spaces/geodien/pages/3968073736/GEODI+Server+Installation#License-Update page. Then, you should restart the service.

Troubleshooting

 GEODI is not getting started.

  1. Control your licence. If you are using a trial license, ensure it is not expired.

  2. SystemSettings.json may not be a valid *.json file. UTF-8 and make sure it is valid.

  3. There may be an invalid value in SystemSettings.json (AppDataFolder or AppPort values.)

  4. The disk may be full.

  5. Control engine and app errors under %appdata%/Logs directory.

 GEODI service is not getting started.

  1. Is the service user still valid and has enough permissions? The password may be changed.

  2. The service users must have read/write/delete permissions in GeodiDataFolder at the minimum.

 Access error appear on index files while GEODI starts.

  1. Check if the user can access GeodiDataFolder in the .exe or the service mode.

  2. Make sure other processes do not use files.

  3. This situation occurs when different projects back up to the same target directory. Revert to default settings or check your projects.

 Modules are not getting updated.

  1. For update, server must have access to DECE-STORE and decesoftware.com. If it cannot access to DECE-STORE, you can follow offline update procedure.

 Licence code is invalid.

  1. Your license may be expired.

  2. If you get the error during the first activation phase, there may be a problem accessing DECE servers(DECE-STORE), and you may need an offline installation.

 I forget my GeodiAdmin password.

  1. We are sorry! We wish there were an easy way. However, we cannot offer such a way because of security concerns. You can delete … file in … directory and turn the system to the very beginning. You need to follow the setup steps again.

  2. As a precaution, we suggest you create a backup user with “Edit Permission“ authorization.

 No space left for indexes.

You can change the index location using the settings in https://decesw.atlassian.net/wiki/spaces/geodien/pages/3968073736/GEODI+Server+Installation#GEODI-AppDataFolder

  • No labels