Versions Compared

Version Old Version 44 New Version Current
Changes made by

Ozan Ergun

serdar ak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Table of Contents
stylenone

Installation

...

...

GEODI Download

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

  2. Download setup file and trigger it.

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

  4. GEODI management interface will be opened in the browser with Download the setup file and run it. GEODI may run as a Windows service or EXE during a log-on user session. For uninterrupted service, you must choose Windows Service.

  5. During the setup, a license code will be asked. The setup automatically downloads from the DECE-STORE and installs the modules included in your license.

    1. (info) If DECE-STORE (service.decesoftware.com) access is available, offline installation is required. Offline installation and maintenance is somewhat more complicated. We suggest following the standard installation by allowing limited access to DECE-STORE.

  6. After installation, the GEODI Manager Page opens at http://127.0.0.1:3323/manageraddress after installation.

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

  8. You need to create the Windows service for GEODI to work continuously. GEODI Setup as a Windows Service

  9. Congratulations, you installed GEODI.

    1. (info) This address is locally available; you must define an address reachable from the endpoints for Classification and GDE Discovery Agents.

  10. The next step is to download install templates for regulations from the DECE-STORE.

Info

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

Support Q - FAQ and Tech News

...

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.

...

  1. You may search DECE-STORE for countries, regulations, or needs. Once these add-ons are installed, the update will be automatic.

    1. (info) If you prefer offline installation, the module updates should be done manually. We suggest that you allow limited access to DECE-STORE for complete automatic updates.

Info

GEODI Download

GEODI AppDataFolder

GEODI stores workspace definitions, indexes, and logs in the %appdata% directory that , which is created automatically during installation. This directory belongs to the login user. This directory is created automatically during installation.

  1. If the user who installed GEODI and the Windows service user differ, the following settings should be made. Otherwise, you won’t

...

  1. be able to access

...

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

  2. GEODI must be closed during these changes.

  3. The existing %appdata% directory must be moved into the new folder. After %appdata% is moved into the new directory, , which should have read/write permissions must be assigned to for the service user. The existing project(s) and license info remain valid that way.

Info

Disk Requirement

Make sure the disk has enough storage for the index and index backups. The index size is about 10% to 20% of the total data size.

GEODI Logs are kept in the same area. Logs older than 90 days will automatically be deleted.

Defining SSL Certificate

For Classification and Agent PC Discovery projects, the GEODI address must be secure and accessible from to clients. You To ensure this, you must make the following settings in GEODI for the SSL Certificate. For details you may , refer to System Configuration - Security Settings the page. Definitions must be made before agent deployments.

The following SSL definitions are made should be in the SystemSettings.json file in the GEODI installation directory.

Info

"AppPort":443,
"NoSSLPort":80,
"ForceHttpsRedirect": true,
"SSLLocalCertificateSerial":"<certificate-serial-number>"

Expand
titleTo obtain the certificate serial number
Tip

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.

: In cases where certificates are managed with a load balancer, you
Expandnote
titleLoad Balancer Case
Note

You do not need to make any additional definitions on the GEODI side in cases where certificates are managed with a load balancer.

...

Installation as a Windows Service

After installation, GEODI is turned into becomes a continuous service that will run continuously 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 which that GEODI will index. If the user does not have cannot access to these sources, you need to must add authorized users to GEODI as well. If you’d like to . To uninstall the service, you can do it by running run 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.

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

...

...

Mapped Sources

...

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

Note

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 Installation

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 waythe GEODI setup as usual.

License Update

Run LicenseUpdate.bat to open the dialog.

...

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

 

...

Frequently Asked Questions

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

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

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

Expand
titleShould 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.)

Expand
titleWhat 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+8+Server+Installation#License-Update page. Then, you should restart the service.

Expand
titleCan I install more than one GEODI for Discovery?

Yes, each GEODI can discover the same or different data sources. Management and reporting are centralized through the Master GEODI.

Expand
titleIs it possible to install active-passive or redundant mode?

Yes, you can set up a redundant configuration for high availability. GEODI also supports an active-active configuration.

Troubleshooting

Expand
titleGEODI is not getting started.

  1. Control your licence. If you are using a trial licencelicense, make sure 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. Disk The disk may be full.

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

Expand
titleGEODI service is not getting started.

  1. Servis kullanıcısı geçerli mi, yetkileri yeterli mi? Şifresi değişmiş olabilir. Is the service user still valid , and has enough permissions? Password The password may be changed.

  2. Service user The service users must have Readread/Writewrite/Delete delete permissions in GeodiDataFolder as at the minimum.

Expand
titleAccess error appear on index files while GEODI starts.

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

  2. Dosyaların başka bir işlem tarafından kullanılmadığından emin olunuz. Make sure files are not used by 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.

...

Expand
titleLicence code is invalid.

  1. Your licence license may be expired.

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

Expand
titleI forget my GeodiAdmin password.

  1. We are really sorry! Wish there was an easy way. However, we cannot offer such a way because of security concerns. You can delete … file in … directory and turn You should delete the %appdata%DeceAuthentication directory. This action will return the system to the very beginning. You need to follow setup steps again.

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

Expand
titleNo space left for indexes.

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