Versions Compared

Key

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

On this page, you will find the Setup This page contains the installation link, requirements, settings, and the path you will follow for the commissioning phases.

Privacy Issues

GEODI is designed to make it easier for you to access and explore your data repository. To do this, it needs access to the data. You can find your questions about the security and privacy of your data during the setup stages at GEODI Privacy Issues

Before Installation

Before Installation

...

Subject

...

Description

...

GEODI Setup Link

...

GEODI Setup

After running the setup, GEODI starts in default mode and automatically opens a tab in the browser. You can access the administration and query interface by right-clicking on GEODI in the System-Tray. Windows service or IIS service setups can be activated later.

GEODI Setup in Default Mode

Please consult for non-internet environments.

...

License Activation

...

  1. Before setup, you must specify an email address to which the License will be linked and provide it to DECE sales or technical teams. You will receive an email with the license key when your license is created.

  2. You must enter an e-mail address set when GEODI was first started in default mode. Then you continue by entering the transmitted license code. After this process, GEODI Modules included in your License will be automatically downloaded and installed. Now you can move on to project creation and other settings.

...

Setup of Modules

...

After activating your License, the modules will be downloaded and installed automatically. You should make settings after setup. Please ask for support from DECE teams for modules not included in these pages.

...

Public Address / SSL Identification

...

A public address is needed for users to access the GEODI server. An SSL-certified FQDN is recommended for secure access. Our users use addresses like geodi.yourdomain.com or arabul.yourdomain.com. After the public address definition and SSL certificate setup on the server, GEODI Configuration should be done as follows.

For SystemSettings.json setting GEODI Server Installation and Configuration

Code Block
"SSLLocalCertificateSerial":"<Sertifika serial no>"

...

System Configuration / Security Settings

deployment stages for discovery, classification, or other topics.

Table of Contents
stylenone

Installation

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

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

  3. After installation, the GEODI Manager Page opens at http://127.0.0.1:3323/manager.

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

  4. The next step is to install templates for regulations from the DECE-STORE. 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, which is created automatically during installation. This directory belongs to the login user.

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

...

Authorizations and LDAP settings

...

Procedures should be taken to create users and determine authorizations and groups.

GEODI User/Authorization Management

...

GEODI Windows Service Setup

...

Windows service setup is optional after default mode. All settings you created in default mode are valid.

GEODI Setup as a Windows Service

...

Backup and Redundancy

...

Only index backup and redundant operation is possible.

Index Backup and Recovery from Backup

Active-Passive and Active-Active configuration

...

Creating the Project, Connecting Resources

...

To perform operations such as indexing, data discovery and classification in GEODI, a Project must first be created. Resources, authorizations, and rules are defined on the project wizard.

GEODI Project Wizard

Source: Folder

https://decesw.atlassian.net/wiki/spaces/geodien/pages/3987177473/Source+Database+Data+Source

https://decesw.atlassian.net/wiki/spaces/geodien/pages/3973841133/Source+Webpage

Source: Email

Source: Cloud Servers, FTP, SharePoint

Source: MOBIDI Data

It is possible to customize some appearance and content in the GEODI user interface. You can remove and add GEODI data display options (Content, Map Calendar...), and it is also possible to use different-looking themes.

Design your own GEODI

...

If OCR License is available

...

OCR takes a long time and consumes a lot of CPU resources. Therefore, we recommend that you consider some considerations when applying it to extensive data.

  • GEODI OCR Engine OCRs scanned documents in default mode and present them with GEODI. You can search and find scanned documents.

  • It can also output scanned pages as SPDF (Searchable PDF). The SPDF option can extend the time from x3 to x5 compared to the default mode. It also requires additional disk space for SPDF files.

  • GEODI OCR can also OCR huge scanned images such as A0, and A1 maps. This option is turned off in default mode.

  • If you have a GEODI 360 license, you can also OCR videos. In this case, you have to allocate much higher CPU resources.

...

If a Corporate Search License is available

...

Having an Enterprise Search license technically means that there will be more users. To provide uninterrupted service to users, FKM and index backup procedures should be operated in addition to the server being sufficient.

For Institutional Search to be effective, it is recommended that data is presented in a single project and authorizations are organized appropriately.

Different units have different data access needs. GEODI Enterprise Search solution provides access to all of them from a single platform. Separate training should be planned for each unit when necessary. DECE teams will support you at all stages.

For trainings : GEODI Courses

...

If Data Discovery License is Available

...

You will connect a large number of sources for data discovery. If enterprise search is not included, it will be available to a limited number of users. Depending on your purpose (Institutional sensitive data discovery Finance, PCI/DSS GDPR), the selection of sources and recognizers determines the success of the result.

The discovery panel will provide information about the results from the first moment of indexing. This panel may be shared live or as a PDF.

The discovery panel will show the risks and incompatibilities. According to the results of this panel, you can carry out Destruction and Quarantine procedures after Indexing.

...

If Geographic Archive License is Available

...

The Geo Archive application is a use case of GEODI Enterprise Search. System requirements, authorization, and other considerations apply.

For a municipality, road administration, or an organization that produces geographic data, it is recommended to have at least one of the LandParcel Recognizer, Station Number Recognizer, or GeoArchive modules. The DECE team will provide the necessary support for the setup of these modules.

...

If GDE License is Available

...

The GEODI endpoint or PC discovery tool is called GEODI Desktop Explorer, or GDE for short. GDE can be installed on multiple PCs. GDEs will feed GEODI Server with the selected directories and file types on the endpoint. GDE and Backpup option will ensure files on the PCs to be stored in a central location.

You can find all the necessary steps for GDE setup and deployment of agents to the endpoints on the following page.

GEODI Desktop Explorer(GDE) Setup

...

If Classification License is available

...

GEODI Classification solution consists of several components. You can find all the necessary steps for the setup and deployment of agents on the following pages.

GEODI Desktop and Office Classifier Installation and Configuration

GEODI OWA Classifier Installation and Configuration

...

Frequently Asked Questions

...

We have answered the problems and solutions you may encounter during setup or other processes as much as possible on the attached page. DECE teams will provide support for the answers you cannot find.

GEODI FAQ

System Configuration and Security Settings

The SystemSettings.json file in C:\Program Files\Dece Software\GEODI\ içerisinde contains the settings. The most commonly used settings are here. Please refer to Sistem Yapılandırma - Güvenlik Ayarları for all keys.

...

Setting Name

...

Type

...

Default

Value

...

Category

...

Description

...

AppData folder

...

String

...

null

...

System

...

Use this settings if you want to store WorkSpace, Log, Index, Dictionaries, and All metadata other then the default place(%appdata%/dece..).

...

AppPort

...

int

...

3323

...

WebServer

...

It is used to determine the port to be used by the WebServer launched via GEODI.exe.

If it is set to 80, there is no need to write a port on the client side. If SSL certificate is set, there is no need to write a port on the client side when using SSL port 443.

...

SSLLocalCertificateSerial

...

String

...

null

...

WebServer

...

It is used to activate SSL with a valid certificate installed under Computer Certificates. It is an alternative to specifying a certificate file with SSL certificate.

...

ShowWebExceptionStackTracebool

...

bool

...

false

...

WebServerSecurity

...

Allows error details to be displayed in case of Web request errors. By default, details are not displayed.

...

LogExceptionStackTrace

...

bool

...

false

...

System

...

Provides logging of additional details of Scan and System initialization errors.

Related Pages

...

  1. 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, which should have read/write permissions 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 to clients. To ensure this, you must make the following settings in GEODI for the SSL Certificate. For details, refer to the page. Definitions must be made before agent deployments.

The following SSL definitions 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.

Expand
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 becomes 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 must add authorized users to GEODI. To uninstall the service, 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

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.

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

(info) You can update the GEODI setup as usual.

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

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

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

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

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

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

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

Expand
titleI forget my GeodiAdmin password.
  1. You should delete the %appdata%DeceAuthentication directory. This action will return the system to the very beginning.

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

Expand
titleNo space left for indexes.

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