GEODI Desktop Explorer (GDE), İstemci Bilgisayarlardaki verilerin merkezi bir GEODI’de indexlenmesini sağlayan çözümdür. windows, Linux, MacOS ve Pardus ortamlarında çalışır.
GDE her bir bilgisayara manuel veya Uygulama dağıtım araçları ile (SCCM,PDQ,..) otomatik olarak kurulur. Hangi dizinlerin indexleneceği ayarlar ile belirtilebilir.
GDE Windows Servis olarak kurulduğu zaman oturum açmadan da çalışabilir.
GDE otomatiktir, her 3 saatte bir değişen dosyaları işler.
GDE içerikleri sunucuya kopyalamaz. Bir arama sonucu bulunan içerikler, ilgili bilgisayardan bulunur ve açılır. Bilgisayar veya GDE açık değilse arama yapabilirsiniz ama belgeye ulaşamazsınız.
PC’lerdeki dosyaların bir yedeğini almak isterseniz, GEODI projesinde ilgili Kaynak için “İçerikleri Yedekle” ayarını açmalısınız.

Bağlantı İçin Gereken Şartlar

GEODI Sunucusu
1. Server URL → Bu sunucuya GDE kurulacak noktalardan erişim olmalıdır
2. İndexlenen dosyalar için Proje veya var olan bir projede bir kaynak belirlenmelidir
3. GEODI projesi/kaynağı besleme/feed yetkisine bir Token → nasıl alınacağı bu sayfada anlatıldı
4. Hedef bilgisayarlara indexlenencek dizin ve dosyalar için konfigürasyon → Bu sayfada parametreler belirlendi. IP/Sunucu adı bazında ayrımlar yapabilirsiniz.
Uç noktalar
1. Sunucuya erişim olmalıdır
2. Sunucu tarafından gelecek istekler için 1982 portu açık olmalıdır
3. FileServer için tek tek kurulum mümkündür, çok sayıda PC için ManageEngine veya SCCM gibi bir araç önerilir.

Kurulum Checklist

Konu	Açıklama
GEODI kaynak adı	GDE verileri GEODI’de belirleyeceğiniz bir kaynak altında yer alabilir. Bu bilgiyi token alırken kullanmalısınız. Gelen veriler GEODI Arama Arayüzünde “Kaynaklar” ve veri keşfi raporlarında görünecektir. Projeniz ile birlikte “Keşif” adlı hazır bir panel gelecektir. Bu panelde istemcilerden gelen veri sayılarının doğru çalışması için Projenize GDE adlı tanıyıcıyı da eklemelisiniz.
Ayarlar	GDE çok sayıda istemcide çalışır. Ayarlar merkezi olarak belirlenir. Bu sayfada ayarların nasıl yapılacağı anlatılmıştır. FileServer kurulumları ya da ihtiyaç varsa her bir istemci için ayrı ayar seti belirlenebilir.
İstemci Kurulumu	Windows, Linux veya MacOS için kurulum adımları alt sayfalarda belirtilmiştir. The selected root page could not be found.
İzleme	GEODI Ajan Yönetim Paneli sayfasında anlatılan yöntem ile ajanların sağlığı ve sürüm gibi bilgiler izlenebilir.

Merkezi GDE kural ayarları

Ayarlar GEODI sunucusunda <GEODI_APP>/Settings/GEODI/Geodi.DesktopExplorer dizini içinde default.json içinde olmalıdır.

Kurulu GDE istemcileri bu dosyayı sunucudan otomatik olarak alacaktır. GDE kurulumları bu ayarları sunucudan otomatik olarak alacaktır.
Ayarlar kurulum sonrası ve indexleme devam ederken değiştirilebilir, değişiklikler yaklaşık 1h içinde etkin hale gelir.
Birden fazla makinede farklı ayarlar için <ClientIP>.json , <ClientUserName>.json veya <ClientMachineName>.json isimli tanımlar kullanabilirsiniz.

{
  "FolderList": [ "%UserProfile%","\\Users","\\home" ],
  "ExplorerPort": 1982,
  "IgnoreFiles":[ "*.log","*.M2TS","*.MOV","*.MP4","*.MP3","*.OGG","*.AVI","*.3GP","*.ASF","*.FLV","*.MKV","*.MPG","*.MPEG","*.OGV","*.WMV","*.DIVX","*.DAT","*.WMV","*.XVID","*.X264","*.WMV1","*.SEC","*.DIB","*.gif","*.spx","*.wav","*.f4v","*.swf","*.csv","*.txt","*.dxf","*.kml","*.bmp","*.png","*.htm","*.html" ],
  "MetaData": {
	"LDAPDN":"=d.CurrentUser!=null?d.CurrentUser.DistinguishedName:null",
	"IP":"=d.ClientIP",
	"ComputerName":"=d.ClientMachineName",
	"UserName":"=d.ClientUserName"
	}
}

Ayar Adı	Tip	Açıklama
FolderList	string[]*	Taranacak klasörleri belirtmekte kullanılır. Klasörler “,” ile ayrılarak tanımlanabilir. Varsayılan dizin %UserProfile% 'dır (belgeler, indirilenler, masaüstünü kapsar..). https://docs.microsoft.com/tr-tr/dotnet/api/system.environment.specialfolder?view=netframework-4.0 sayfasından tam liste bulunabilir. Değerler büyük/küçük harf duyarlıdır. %UserProfile%\\Desktop şeklinde alt dizinler de tanımlanabilir. Bütün diskleri taramak istiyorsanız [“*”] kullanabilirsiniz.
ExplorerPort	int	0 üzeri bir değer girilirse client açık olduğu sürece Geodi üzerinde içeriklerde görüntülenebilecektir. Seçilen portun açık olduğunu teyid ediniz. GDE-GEODI 2 yönlü haberleşmesi için varsayılanda 1982 portu istemcilerde açık olmalıdır. Bu değer değiştirilebilir. Ayarlarda ExplorerPort değeri belirtilmezse GDE tek yönlü besleme yapar, dosyaları arayabilir ama görüntüleyemezsiniz.
EnableLDAP	bool	true değeri verilirse dosyalara ait LDAP yetkileri de indexlenir. Varsayılan değer : false
IgnoreFolders	string[]	Yoksayılacak klasör listesidir. * kabul edilir. Geodi Settings/IgnoreFolders altınaki ayarlarla birleştirilerek kullanılır. Örnek : `[":\\Özel","C:\User"]` varsayılan değer :null GEODI merkezi file/folder ignore kuralları her zaman geçerlidir. Ayar içinde belirtilen kısıtlar ek olarak gelir. Network kaynağını korumak için varsayılanda 100Mb'dan büyük dosyaların sadece adı ve tarihi indexlenir. Bu sınır Sıkıştırılmış dosya içerikleri için 500Mb olarak ayarlanmıştır. Değerler GEODI sunucuda değiştirilebilir.
IgnoreFiles	string[]	Yoksayılacak dosya listesidir. * kabul edilir. Geodi Settings/IgnoreFileTypes altındaki ayarlarla birleştirilerek kullanılır. varsayılan değer :`[".MP4",".MOV","*.MP3"]` GEODI merkezi file/folder ignore kuralları her zaman geçerlidir. Ayar içinde belirtilen kısıtlar ek olarak gelir. Network kaynağını korumak için varsayılanda 100Mb'dan büyük dosyaların sadece adı ve tarihi indexlenir. Bu sınır Sıkıştırılmış dosya içerikleri için 500Mb olarak ayarlanmıştır. Değerler GEODI sunucuda değiştirilebilir.
Metadata		İstemcilerden gelen dosyaları ayrıştırmak için metaveri tanımlayabilirsiniz. Bu metaveriler için makrolar tanımlanabilir. Metaveriler ile arama <metaname>:<değer> ile yapılır. Örneğin `IP:192.168.1.1` Tanımlanmış metaveriler ve değerleri GEODI arama arayüzünde görülecektir.

Sorun Giderme

Kurulum sonrası veri gelmiyorsa lütfen
- Firewall/Antivirüs ayarlarınıza bakınız ve IT danışmanınıza başvurunuz.
- İstemci Kapalı olabilir
- İstemcide GDE kurulu olmayabilir
- İstemcideki GDE aktif olmayabilir(Geod.Desktopexplorer.exe çalışmıyor olabilir)
- Sunucu-İstemci iletişimi için gerekli port(default 1982) kapalı veya engellenmiş olabilir.
- İstemci GEODI sunucusuna erişemiyor olabilir(GEODI Sunucusu public bir adrese sahip olmayabilir). Bu testi istemcide browser üzerinden de yapabilirsiniz.
- GDE sürekli besleme yapan bir yazılımdır. Firewall/Virüs yazılımları sürekli iletişimi bloklayacak şekilde ayarlanmış olabilir.
- Sabırlı olun, Çok sayıda istemciden aynı anda gelen verileri GEODI Sunucusu kuyruğa alır ve işler. Bu nedenle farklı bir teknik sorun yoksa süreç mutlaka ilerleyecektir.
İstemci makine IP ve İsim değişirse ~3h içerisinde dokümanlarını görüntüleyebilirsiniz.
İstemci makine formatlanırsa yeni bir istemci olarak kaydedilir. Eski indeks korunur.
Merkezi ayar değişiklikleri yaklaşık 1 saat içinde etkin olur.
GetLastEror üzerinde "Client is null \q \n" uyarısı alındığında Kayıt defteri üzerinden URL bilgileri kontrol edilmelidir.

Token Oluşturma

GDE’lerin besleme yapacağı Kaynağa erişimi olan bir kullanıcı ile login olunur. Veya token arayüzünde token
Geodi Token Oluşturma sayfasındaki arayüz açılır
Feed aktifleştirilir. AllowList altında Edit AllowList tıklanır ve açılan listede GDE nin dosyalarımızı göndereceği içerik kaynak seçilir.
“Create” ile token oluşturulur.

GEODI Desktop Explorer(GDE)

Kurulum Checklist

Merkezi GDE kural ayarları

Sorun Giderme

Token Oluşturma