Ubuntu Server Üzerinde İnternet Erişimi Olmayan(offline) Local Sistemlerde  Neo4j Enterprice Kurulumu ve Yapılandırma Rehberi

MSSQL Server

Neo4j, verileri geleneksel ilişkisel veritabanlarındaki (RDBMS) tablo ve satırlar yerine Düğümler (Nodes), İlişkiler (Relationships) ve Özellikler (Properties) şeklinde saklayan açık kaynaklı ve ACID uyumlu lider bir Graf Veritabanı Yönetim Sistemidir (Graph Database Management System).

İlişkisel veritabanlarında karmaşık JOIN sorguları ile yüksek maliyet oluşturan bağlantılı veri yapıları, Neo4j üzerinde yerel ilişkiler olarak tutulur. Bu sayede milyarlarca veri arasındaki bağlantılar milisaniyeler seviyesinde sorgulanabilir. Neo4j, sorgulama dili olarak son derece esnek ve bildirimsel bir dil olan Cypher (CQL) yapısını kullanır. Dolandırıcılık tespiti (fraud detection), kimlik ve erişim yönetimi, öneri sistemleri, ağ/altyapı haritalama ve bilgi grafikleri (knowledge graphs) gibi yüksek oranda ilişkili verilerin işlendiği senaryolarda yaygın olarak tercih edilmektedir.

Neo4j kurulumuna geçilmeden önce temel işletim sistemi altyapısının hazırlanması gerekmektedir.

Ubuntu server işletim sisteminin yüklenmesi gerekmektedir. İlgili sayfadan ubuntu server işletim  sistemi indirilir. Resmi indirme adresi olan ubuntu.com/download/server adresinden Ubuntu Server 24.04 LTS (veya 22.04 LTS) .iso dosyasını indirin. İndirme işleminden sonra sana makine üzerinden kurulum işlemi yapılmaktadır.

İndirme işleminden sonra sanallaştırma platformunuz üzerinde gerekli kaynak tahsisini (CPU, RAM, Disk) yapılması gerekmektedir. Gerekli kaynak tahsisi yaptıktan sonra Bitir deyip işletim sistemi kurulumuna geçiyoruz.

Gelen önyükleme ekranında “Try or Install Ubuntu Server” seçeneğine basıp ilerleyin.

Dil ve Klavye:

  • Language: English (Sunucu ortamlarında sistem loglarının takibi ve tespiti için İngilizce önerilir).
  • Keyboard layout: Turkish seçin.

Standart Ubuntu kurulumu için ilgili seçenek değiştirilmeden Done butonuna basılır.

Otomatik IP  alması için DHCP seçilmesi gerekir. Sunucuya sabit IP vermek için ilgili ethernet kartını seçip Edit IPv4 -> Manual yapabilir ya da atanan DHCP IP’sini not edebilirsiniz. İlgili ip değeri belirlendikten sonra bir sonraki bölüme geçilmektedir.

Hangi Ethernet kartı üzerinden ip değeri almak istiyorsanız aşağıdaki resimde ilgili bölümden rahatlıkla yapılabilir. Sol üst köşede uzman alanına geçiş yapılması gerekmektedir.

Gelen Proxy ekranında herhangi bir özel yönlendirme yoksa işlem yapmadan Done diyerek bir sonraki ekrana geçin.

Kurulum sihirbazı; sistem güncellemelerini, dil paketlerini ve ek yazılımları resmi Linux depolarından (repository) indirmek için internet bağlantısına ihtiyaç duyar.

Şirket veya veri merkezi ağlarında güvenlik nedeniyle cihazların doğrudan dış internete erişimi engellenmiş olabilir. Tüm HTTP/HTTPS trafiği yetkili bir proxy sunucusundan (örn. Squid, Zscaler) geçtiği durumlarda kurulum aracına bu adres tanıtılır.

Doğrudan internete bağlanabiliyorsanız bu alanı boş bırakarak “Done” seçeneği ile ilerleyebilirsiniz.

Gelen ekranda ilgili bölümlerin seçili olması gerekmektedir.

Use an entire disk seçeneğini işaretleyin. “Set up this disk as an LVM group” kutucuğunu işaretli bırakın (ileride disk boyutunu kolayca artırmak için).

Gelen ekranda tekrardan Done deyip bir sonraki ekrana geçilir.

Gelen ekranda continue dedikten sonra bir sonraki ekrana geçilir.

Gelen ekranda sunucu ismi kullanıcı ve şifre oluşturduktan sonra Continue deyip bir sonraki ekrana geçilir.

Gelen ekranda herhangi bir değişiklik yapmadan Continue deyip bir sonraki ekrana geçilir.

SSH Setup ekranında [X] Install OpenSSH server seçeneğini mutlaka işaretleyin (MobaXterm veya PuTTY ile uzaktan bağlanabilmek için).

Ek snap paketlerini işaretlemeden Done diyerek geçin.

Kurulum bittiğinde ekranın altında Reboot Now seçeneği çıkar.

Sunucu üzerine başarılı bir şekilde bağlantı gerçekleşir.

Mobaxterm üzerinden SSH bağlantısı başarılı bir şekilde yapılmaktadır.

Bağlantı sağlanmış olundu.

Buraya kadar işletim sistemini kurulumunu gerçekleştirip mobaxterm üzerinden bağlantı sağlamış olduk. Şimdi Neo4j enterprise sürümünü ilgili sunucumun içirişine dosyaları atıp neo4j kurulumunu gerçekleştirmiş olacağız.

Neo4j enterprise sürümünü neo4j sayfasından form doldurup 1 aylık deneme sürümünü alabilirsiniz. Ayrıca neo4j yapısı için şart olan java 21 sürümünün indirilmesi gerekmektedir.

İlgili bağlantıdan 21 jdk sürümü indirilmektedir.

WinSCP programı ile Linux sunucusuna bağlantı gerçekleştirilir. Mobaxterm üzerinden çek bırak yöntemi de yapılabilir.

WinSCP ile dosyayı yükleyeceğiniz en uygun geçici konum /tmp dizinidir.

İlgili klasöre kopyalama işlemi yapılmaktadır.

MobaXterm, PuTTY veya WinSCP terminali üzerinden SSH ile sunucunuza bağlanın ve sırasıyla şu komutları çalıştırın:

1. /tmp dizinine geçin

cd /tmp

2. .tar.gz arşivini bulunduğunuz yere çıkarın. Dosya adı neo4j-enterprise-2026.10.1-unix.tar.gz.tar

tar -zxvf neo4j-enterprise-2026.10.1-unix.tar.gz.tar

3. Çıkarılan klasörü kalıcı sistem dizinine (/usr/share/neo4j) taşıyın. Yukarıdaki dizinde çıkardığımız dosyanın ismi neo4j-enterprise-2026.10.1 aşağıda görülmektedir. Aşağıdaki komut çalışıldıktan sonra neo4j klasörü oluşmaktadır.

sudo mv neo4j-enterprise-2026.10.1 /usr/share/neo4j

Not: neo4j-enterprise-2026.10.1-unix.tar.gz.tar indirilen dosyasının adıdır.

İlgili komut ile de görülebilir. Aşağıdaki komutlarla dosyalar kontrol edilmektedir.

ls -l /usr/share/neo4j
ls -l /usr/share/neo4j/bin/neo4j 
ls -l /usr/share/neo4j/bin/neo4j-admin 
ls -ld /usr/share/neo4j/data 
ls -ld /usr/share/neo4j/logs

Yukarıdaki işlemlerden sonra kaldığımız yerden devam edelim. Neo4j enterprise  sürümünün çalışabilmesi için sistemde Java 21 kurulu olmalıdır. Terminalde kontrol edin:

java -version

Sunucu üzerinde java kurulu olmadığı görülüyor. Sunucunun internet erişimi olmadığı için ekranda önerilen sudo apt install … komutları çalışmayacaktır. Sürümlere göre install komutlarını vermektedir.

İnternetli Windows bilgisayarınızdan indirdiğiniz jdk 21 dosyasını WinSCP ile Ubuntu sunucunuzun /tmp klasörüne atın. İlgili bağlantıdan Linux için java indirimi yapılır.

Tar uzantılı indirildiği için aşağıdaki yöntemle oluşturulan yeni klasöre java dosyaları atılmaktadır.

1. Dosyanın bulunduğu /tmp dizinine geçin

cd /tmp

Not: Bir önceki Neo4j tar dosyasını ilk olarak /tmp altına çıkarıp daha sonra belirtilen klasöre taşımıştık. Şimdi ise dizini oluşturup tar dosyası tmp dizinine çıkarılmadan direk olarak oluşturulan dizine çıkarma işlemini yapacağız.

2. Sistemde Java klasörünü oluşturun. Bir sonraki adımda tar uzantılı dosyayı ilgili klasör altına almış olacağız.

sudo mkdir -p /usr/lib/jvm

3. .tar.gz arşivini /usr/lib/jvm klasörüne çıkartın. İlgili java dosyasının adı “OpenJDK21U-jdk_x64_linux_hotspot_21.0.6_7.tar.gz”

sudo tar -zxvf OpenJDK21U-jdk_x64_linux_hotspot_21.0.6_7.tar.gz -C /usr/lib/jvm/

İlgili dizin altına dosyalarımız kopyalamış olduk.

Java’yı çıkardığınız klasörün tam yolunu kontrol edin

Aşağıdaki komutlarla dosyaların ilgili dizinde olduğu takip edilmektedir.

ls -la /usr/lib/jvm  
ls -l /usr/lib/jvm/jdk-21.0.6+7/bin/java
ls /usr/lib/jvm

Başlangıçta indirilen java dosyası /temp klasöründen /usr/lib/jvm klasörüne taşınmıştı. Şimdi ise ilgili dosyayı /usr/bin/java altına ekliyoruz:

sudo ln -sfn /usr/lib/jvm/jdk-21.0.6+7/bin/java /usr/bin/java

Kontrol işlemi yapılmaktadır.

java -version 
readlink -f /usr/bin/java

Önce sistemin Java’yı sorunsuz görmesi için sembolik link oluşturun ve JAVA_HOME değişkenini kalıcı olarak yazın:

JAVA_HOME değişkenini /etc/environment dosyasına ekleyin:

echo 'JAVA_HOME="/usr/lib/jvm/jdk-21.0.6+7"' | sudo tee -a /etc/environment

Değişkeni mevcut oturuma yükleyin:

source /etc/environment

Kontrol işlemi yapılır.

echo $JAVA_HOME

Neo4j Linux kullanıcısını oluştur. Aşağıdaki komutla kontrol edilmektedir.

id neo4j

Eğer kullanıcı bulunamadı diyorsa:

sudo groupadd --system neo4j 
sudo useradd --system -g neo4j -d /usr/share/neo4j -s /usr/sbin/nologin neo4j

Eğer kullanıcı zaten varsa yeniden oluşturma.Kullanıcımızı oluşturduğumuz görmüş oluyoruz.

Oluşturduğumuz neo4j kullanıcısı bir Linux işletim sistemi kullanıcısıdır. Neo4j veritabanının içerisindeki neo4j kullanıcısıyla aynı şey değildir. İsimleri aynı olsa da görevleri tamamen farklıdır.

Görevi:

  • Neo4j servisini çalıştırmak.
  • Dosya ve klasörlere erişmek.
  • Veritabanı dosyalarına yazmak.
  • Log dosyalarını oluşturmak.
  • İşletim sistemi seviyesinde yetkilendirme sağlamak.

Neo4j veritabanı kullanıcısı: neo4j, Neo4j içerisinde bulunur.

Görevi:

  • Veritabanına giriş yapmak.
  • Cypher sorguları çalıştırmak.
  • Verileri okumak ve yazmak.
  • Kullanıcı ve rol yetkilerini yönetmek.
  • Veritabanı erişimini kontrol etmek.

Gerçekte neo4j dizini aşağıdaki gibidir.

/usr/share/neo4j

Neo4j dizinin sahipliğini düzenliyoruz.

sudo chown -R neo4j:neo4j /usr/share/neo4j

Şu anlama gelir:

  • chown: Dosya sahipliğini değiştir.
  • -R: Alt klasörler ve dosyalar dahil.
  • İlk neo4j: Linux kullanıcısı.
  • İkinci neo4j: Linux grubu.
  • /usr/share/neo4j: Yetkileri düzenlenen dizin.

Dosya ve klasör izinleri verilmektedir.

sudo chmod -R u+rwX /usr/share/neo4j

Özellikle aşağıdaki dizinleri kontrol et:

ls -ld /usr/share/neo4j 
ls -ld /usr/share/neo4j/bin 
ls -ld /usr/share/neo4j/conf 
ls -ld /usr/share/neo4j/data 
ls -ld /usr/share/neo4j/logs

data ve logs dizinleri yoksa oluştur:

sudo mkdir -p /usr/share/neo4j/data 
sudo mkdir -p /usr/share/neo4j/logs

Yukarıdaki oluşturma işleminden sonra tekrardan sahipliği belirlenir.

sudo chown -R neo4j:neo4j /usr/share/neo4j
sudo chown -R neo4j:neo4j /usr/share/neo4j/data
sudo chown -R neo4j:neo4j /usr/share/neo4j/logs
sudo chmod -R u+rwX /usr/share/neo4j/data 
sudo chmod -R u+rwX /usr/share/neo4j/logs

Dosya sahipliğini doğrula

ls -ld /usr/share/neo4j/datals -ld /usr/share/neo4j/data/databasesls -l /usr/share/neo4j/data/databases/store_lock

store_lock dosyası veritabanı başlatılırken oluşturulabilir. Dolayısıyla şu anda bulunmaması problem değildir.

Sahiplik şu şekilde olmalı:

sudo systemctl show neo4j -p User -p Group

neo4j neo4j gelmesi gerekirken boş gelmesinin sebebi neo4j servisinin kurulmamasından dolayıdır.

Enterprice lisansı kontrol edilmesi gerekmektedir. İlk servis başlatmadan önce yapılır. Değerlendirme lisansı ise yapılmadır.

sudo -u neo4j /usr/share/neo4j/bin/neo4j-admin server license --accept-evaluation

Ticari lisans kullanılıyorsa aşağısaki komutun yazılması gerekmektedir.

sudo -u neo4j /usr/share/neo4j/bin/neo4j-admin server license --accept-commercial

Veritabanın ilk şifresinin belirlenmesi gerekmektedir.

sudo -u neo4j /usr/share/neo4j/bin/neo4j-admin dbms set-initial-password 'yunus1994'

Bu komut veritabanı henüz kapalıyken çalışır. Neo4j servisini hiç başlatmadan, ‘neo4j’ kullanıcısının şifresini doğrudan sistem yetkilendirme dosyalarına (auth file) yazar. Kapalı devre (air-gapped) ortamlarda, ilk kurulum anında şifre belirlemenin resmi ve en güvenli standart yoludur.

Neo4j bağlantısı kontrol edilir. Uzak masaüstü bağlantısı istiyorsan conf dosyasının içerisine aşağıdaki dosyaların tanımlanması gerekmektedir.

sudo nano /usr/share/neo4j/conf/neo4j.conf

İlgili ifadelerin eklenmesi gerekmektedir.

server.default_listen_address=0.0.0.0 
server.bolt.listen_address=0.0.0.0:7687 
server.http.listen_address=0.0.0.0:7474

Ayrı yere yapmayıp ilgili conf dizininde düzeltme işlemi yapılabilir. Sadece 1 kısmın aktif edilmesi gerekmektedir.

sudo ss -lntp | grep -E '7474|7687'

Conf dosyasında herhangi bir yanlış işlem yapılmışsa aşağıdaki bağlantıda hiçbir şey görünmez. Servis çalıştırıldıktan sonra ilgili portlar görülmektedir. Servis konfigürasyonu yapılmadan ve servis çalıştırılmadan yukarıdaki komutu çalıştırmakla herhangi bir sonuç dönmez.

Systemd servis dosyasını oluştur. Yapılandırmanın yapılması gerekmektedir.

sudo nano /etc/systemd/system/neo4j.service
[Unit]
Description=Neo4j Graph Database Enterprise
After=network.target

[Service]
Type=simple

User=neo4j
Group=neo4j

Environment="JAVA_HOME=/usr/lib/jvm/jdk-21.0.6+7"
Environment="NEO4J_HOME=/usr/share/neo4j"
Environment="NEO4J_CONF=/usr/share/neo4j/conf"

ExecStart=/usr/share/neo4j/bin/neo4j console

Restart=on-abnormal
RestartSec=10

LimitNOFILE=60000
TimeoutSec=120

[Install]
WantedBy=multi-user.target

Burada özellikle Type=simple kullanıyoruz. ExecStart ile neo4j console ön planda çalışacak. RemainAfterExit=yes eklemiyoruz.

Kaydet:

  • CTRL + O
  • Enter
  • CTRL + X

Yukarıda sahiplik kontrolü yapmıştık boş gelmişti. Tekrar aynı komutu çalıştırdığımızda user ve group’un geldiği görülmektedir.

Servis dosyasına izinler verilmektedir.

sudo chown root:root /etc/systemd/system/neo4j.service 
sudo chmod 644 /etc/systemd/system/neo4j.service

Systemd konfigürasyonunu yenileyin, Neo4j’yi açılışa ekleyin ve servisi başlatın:

1. Systemd konfigürasyonunu yenileyin

sudo systemctl daemon-reload

2. Neo4j servisini sistem açılışına ekleyin

sudo systemctl enable neo4j

3. Servisi başlatın

sudo systemctl start neo4j

4. Servis durumunu kontrol edin

sudo systemctl status neo4j

Neo4j Enterprise çalışıyor

ACTIVE (RUNNING)

  • Servis: neo4j.service
  • PID: 19859
  • Java: /usr/lib/jvm/jdk-21.0.6+7/bin/java
  • Otomatik başlatma: Etkin

Conf dosyasındaki varsayılan 127.0.0.1 kısıtlamasını kaldırın. Dış ağ bağlantısını açmak için bu işlem yapılmaktadır. Satırı bulun ve başındaki # işaretini kaldırarak aşağıdaki hale getirin Uzaktan (Neo4j Browser ve Neo4j Desktop) erişim sağlayabilmek için konfigürasyon dosyasını düzenleyin:

sudo nano /usr/share/neo4j/conf/neo4j.conf

Servis tekrardan başlatılır.

sudo systemctl restart neo4j

Firewall üzerinde kısıtlamalara takılmamak için aşağıdaki portlara izin verilmesi gerekmektedir.

sudo ufw allow 22/tcp 
sudo ufw allow 7474/tcp 
sudo ufw allow 7687/tcp 
sudo ufw enable

cypher-shell komutunu çalıştırdığımızda ilgili komutu bulamadığına dair hata mesajı alırız.

cypher-shell komutu ortam değişkenlerine (sistemin $PATH dizinine) eklenmemiş. Bu nedenle sadece cypher-shell yazdığınızda sistem bu aracı bulamıyor; komutu /usr/share/neo4j/bin/cypher-shell şeklinde tam yoluyla çalıştırmanız gerekir.

Neo4j üzerinde ilk şifre değişimini yapmak için aşağıdaki komut kullanılır. Ben başlangıçta şifre belirlediğim için ilgili şifreyle giriş yapabiliyorum.

Boşluklara dikkat edilmesi gerekiyor. Boşluk olacak komut ana dizinde çalıştırılması gerekmektedir.

JAVA_HOME=/usr/lib/jvm/jdk-21.0.6+7  /usr/share/neo4j/bin/cypher-shell

Başlangıçta şifre belirlemeseydim aşağıdaki default olan şifreleri girmiş olacaktık.

Kullanıcı: neo4j | Varsayılan Şifre: neo4j

Çıkış yapmak için  :exit ile çıkın.

Neo4j üzerinde veritabanlarını görebiliriz.

Tekrardan Linux üzerinde cypher-shell  ile neo4j yapısına bağlanmak için aşağıdaki komut bir defa çalıştırıldıktan sonra herhangi bir uzantı yazmadan cypher-shell İle bağlanılır.

Hata alınırsa ilgili komutu bağlayabilirsiniz.

sudo ln -sf /usr/share/neo4j/bin/cypher-shell /usr/bin/cypher-shell

Şimdi Neo4j’ye üç farklı şekilde bağlanabilirsin:

1. Kullanacağın bağlantı portları

PortProtokolKullanım
7474HTTPNeo4j Browser
7687BoltUygulama ve veritabanı bağlantısı
7473HTTPSGüvenli Browser bağlantısı

En önemli iki portun 7474 ve 7687.

Tarayıcıdan (Neo4j Browser): http://192.168.56.107:7474 adresine gidin. Connection URL olarak neo4j:// 192.168.56.103:7687 yazıp belirlediğiniz kullanıcı adı ve yeni şifreyle giriş yapın. 7474 giriş ekranın geldiği port bağlantı sağladıktan sonra 7687 adresiyle giriş yapılır. bolt:// ilgili ifade sadece local desktop zamanında geçerlidir. Browser üzerinden bağlantıda herhangi bir şey istenmez.

Not: 7474 Browser arayüz giriş portudur. Arayüz yüklendikten sonra veri aktarımı 7687 (Bolt) portu üzerinden sağlanır. bolt:// protokolü doğrudan browser erişiminde standarttır.

Neo4j ekranına başarılı bir şekilde bağlandığımızı görmüş olduk.

Neo4j Desktop uygulamasından bağlantı sağlanır. Bağlantı sağlarken hata alırsak protocol kısmının değişmesi gerekmektedir. Desktop ortamından bağlanılacağı zaman protocol kısmının bolt:// olarak değişmesi gerekmektedir.

Başarılı bir şekilde bağlantımız gerçekleşir.

Bu makalede Neo4j offline enterprise kurulumunu bitirmiş olduk. Sizde  internet ortamı olmayan bir ortamda kurmak isterseniz bu şekilde kurulumunu başarılı bir şekilde yapabilirsiniz.

Huzur Allah’tandır. (Necm-43)

Author: Yunus YÜCEL

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir