1 of 6

Kurulum

Liman otomatik DEB paketi olarak Aciklab deposuna eklenmektedir. Bu paketler Ubuntu ve RHEL tabanlı işletim Sistemlerini desteklemektedir.

Güncelleme

Eğer 1.x sürümünden güncelliyorsanız sistem üzerine güncelleme öncesi NodeJS 20 sürümü konumlandırılmalıdır. Eğer halihazırda 2.x sürümü bir Liman'a sahipseniz güncel paketi sunucuya atıp kurulumu yapabilirsiniz veya depolarımız üzerinden güncelleme yaptırabilirsiniz.

Güncelleme Notları

2.x'e güncelleme

Sistem üzerine güncelleme öncesi NodeJS 20 sürümü konumlandırılmalıdır.

Ubuntu 22.04 Server

Ubuntu 22.04 (Jammy Jellyfish) üzerinde Liman kurulumu.

Liman 22.04 (Jammy Jellyfish) sürümünü desteklemektedir. Liman paketleri Aciklab DEB depolarında bulunmaktadır. Fakat liman paketinin bağımlı olduğu paketlerden (PHP ve PostgreSQL) dolayı farklı depoların eklemesi önerilmektedir.

1. Ubuntu'ya güncel PHP ekleme

Ubuntu 20.04 ve 22.04 resmi depolarında PHP güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

2. Ubuntu'ya NodeJS yükleme

Ubuntu resmi depolarında NodeJS sürümü eski olduğu için aşağıdaki depoların eklenmesi gerekmektedir.

sudo apt install -y ca-certificates curl gnupg gnupg2
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update

3. Ubuntu'ya PostgreSQL yükleme

Ubuntu 20.04 ve 22.04 resmi depolarında PostgreSQL güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo apt install gnupg2 ca-certificates -y
wget -O- https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor > pgsql.gpg
sudo mv pgsql.gpg /etc/apt/trusted.gpg.d/pgsql.gpg
sudo apt update

4. Liman paketi indirilmesi

4.1. GitHub üzerinden son sürüm indirilmesi

2.0 sürümüne ait en son çıkan paketi yukarıdaki adresten sunucunuza indirerek direkt şu şekilde çalıştırmalısınız.

sudo apt install ./liman-2.0-916.deb -y

4.2. Depo üzerinden kurulum (opsiyonel)

Depo üzerinden Liman MYS kurmak için öncelikle Liman'ın bulunduğu AcikLab deposunu sisteminize eklemeniz gerekmektedir. Öncelikle aşağıdaki iki komut ile depo adresini paket kaynak listenize eklemelisiniz:

4.2.1. Ubuntu 22.04 - jammy

echo "deb [arch=amd64] http://depo.aciklab.org/ jammy main" | sudo tee /etc/apt/sources.list.d/acikdepo.list
wget -O- http://depo.aciklab.org/public.key  | gpg --dearmor > aciklab.gpg
sudo mv aciklab.gpg /etc/apt/trusted.gpg.d/aciklab.gpg

4.2.2. Ubuntu 20.04 - focal

echo "deb [arch=amd64] http://depo.aciklab.org/ focal main" | sudo tee /etc/apt/sources.list.d/acikdepo.list
wget -O- http://depo.aciklab.org/public.key  | gpg --dearmor > aciklab.gpg
sudo mv aciklab.gpg /etc/apt/trusted.gpg.d/aciklab.gpg

5. Depodan Liman paketini yükleme

Bu adımdan sonra Liman MYS'yi yükleyebilirsiniz:

sudo apt update
sudo apt install liman

6. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

sudo limanctl administrator

Bu adım sonunda karşınıza liman web arayüzünden giriş yapacağınız kullanıcı adı ve parolanız çıkacaktır. Liman'ı kurduğunuz sunucunun ip adresini web tarayıcınız üzerine yazıp bu bilgiler ile giriş yaparsanız Liman'ın Web arayüzüne giriş yapmış olacaksınız.

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

sudo limanctl reset administrator@liman.dev

Ubuntu 24.04 Server

Ubuntu 24.04 (Noble Numbat ) üzerinde Liman kurulumu.

Liman 24.04 (Noble Numbat) sürümünü desteklemektedir. Liman paketleri Aciklab DEB depolarında bulunmaktadır. Fakat Liman paketinin bağımlı olduğu paketlerden (PHP ve PostgreSQL) dolayı farklı depoların eklemesi önerilmektedir.

1. Ubuntu'ya güncel PHP ekleme

Ubuntu 24.04 resmi depolarında PHP güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

2. Ubuntu'ya NodeJS yükleme

Ubuntu resmi depolarında NodeJS sürümü eski olduğu için aşağıdaki depoların eklenmesi gerekmektedir.

3. Ubuntu'ya PostgreSQL yükleme

Ubuntu 24.04 resmi depolarında PostgreSQL güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

4. Liman paketi indirilmesi

4.1. GitHub üzerinden son sürüm indirilmesi

2.0 sürümüne ait en son çıkan paketi yukarıdaki adresten sunucunuza indirerek direkt şu şekilde çalıştırmalısınız.

4.2. Depo üzerinden kurulum (opsiyonel)

4.2.1. Ubuntu 24.04 - noble

5. Depodan Liman paketini yükleme

Bu adımdan sonra Liman MYS'yi yükleyebilirsiniz:

6. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

Oracle Linux (RHEL based) 8.x Sunucu

Oracle Linux (RHEL based) 8.x üzerinde kurulum dokümantasyonu

1. PHP 8.1'in Etkinleştirilmesi

PHP'nin 8.1 sürümü için gerekli depolar eklenir ve sürüm etkinleştirilir.

2. Postgresql-15'in Etkinleştirilmesi

Postgresql-15 sürümü için gerekli depolar eklenir ve sürüm etkinleştirilir.

3. Kurulumun Gerçekleştirilmesi

Liman paketini indirebilmek için Açıklab deposundan indirilir.

Paketler güncellenir ve liman paketi kurulur.

4. Ek Yapılandırmalar Yapılır

LDAP sertifikalarını etkinleştirmek için aşağıdaki komut çalıştırılır. Aksi halde domain entegrasyonlarında bağlantı hatası alınacaktır.

5. Yönetici Parolasının Oluşturulması

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

Docker Compose

Docker kullanarak Liman yükleme

1. Docker Compose Yükleme

Docker Compose kurulumu için aşağıdaki betikleri çalıştırabiliriz.

sudo curl -L -k "https://github.com/docker/compose/releases/download/v2.17.2/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

2. Docker Compose Up

Ayağa kaldırmak için son docker-compose.yml dosaysını aşağıdaki komutlarla indirelim ve çalıştıralım.

wget https://raw.githubusercontent.com/limanmys/core/master/docker-compose.yml
DB_PASS="Parola" docker-compose up -d

İşlem Sonucu aşağıdaki gibi dönmelidir
[+] Running 5/5
 ✔ Network liman-net       Created                                                      0.1s 
 ✔ Container liman-webssh  Started                                                      0.4s 
 ✔ Container liman-redis   Started                                                      0.6s 
 ✔ Container liman-db      Healthy                                                      6.1s 
 ✔ Container liman-core    Started

3. Kontrol Arayüzüne Erişim

İşlemler başarılı gerçekleşti ise Docker Compose kurduğumuz makinenin ip adresine gittiğimizde aşağıdaki gibi bir arayüz bizi karşılayacaktır.

4. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

sudo docker exec -it liman-core limanctl administrator

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

sudo docker exec -it liman-core limanctl reset administrator@liman.dev

Kubernetes Deployment

Kubernetes ortamına Liman deploy etmek

1. Liman Helm Chartların İndirilmesi

Liman Helm Chart dosyalarını yukarıdaki dosyaları kullanarak indiriniz.

2. Helm Chartın Deploy Edilmesi

helm install liman

3. Kontrol Arayüzüne Erişim

İşlemler başarılı gerçekleşti ise Docker Compose kurduğumuz makinenin ip adresine gittiğimizde aşağıdaki gibi bir arayüz bizi karşılayacaktır.

4. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

kubectl exec liman-core -- limanctl administrator

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

kubectl exec liman-core -- limanctl reset administrator@liman.dev

Ubuntu 24.04 Server

Ubuntu 24.04 (Noble Numbat ) üzerinde Liman kurulumu.

1. Ubuntu'ya güncel PHP ekleme

Ubuntu 24.04 resmi depolarında PHP güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

2. Ubuntu'ya NodeJS yükleme

Ubuntu resmi depolarında NodeJS sürümü eski olduğu için aşağıdaki depoların eklenmesi gerekmektedir.

sudo apt install -y ca-certificates curl gnupg gnupg2
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update

3. Ubuntu'ya PostgreSQL yükleme

Ubuntu 24.04 resmi depolarında PostgreSQL güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo apt install gnupg2 ca-certificates -y
wget -O- https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor > pgsql.gpg
sudo mv pgsql.gpg /etc/apt/trusted.gpg.d/pgsql.gpg
sudo apt update

4. Liman paketi indirilmesi

4.1. GitHub üzerinden son sürüm indirilmesi

2.0 sürümüne ait en son çıkan paketi yukarıdaki adresten sunucunuza indirerek direkt şu şekilde çalıştırmalısınız.

sudo apt install ./liman-2.0-916.deb -y

4.2. Depo üzerinden kurulum (opsiyonel)

4.2.1. Ubuntu 24.04 - noble

echo "deb [arch=amd64] http://depo.aciklab.org/ noble main" | sudo tee /etc/apt/sources.list.d/acikdepo.list
wget -O- http://depo.aciklab.org/public.key  | gpg --dearmor > aciklab.gpg
sudo mv aciklab.gpg /etc/apt/trusted.gpg.d/aciklab.gpg

5. Depodan Liman paketini yükleme

Bu adımdan sonra Liman MYS'yi yükleyebilirsiniz:

sudo apt update
sudo apt install liman

6. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

sudo limanctl administrator

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

sudo limanctl reset administrator@liman.dev

Ubuntu 22.04 Server

Ubuntu 22.04 (Jammy Jellyfish) üzerinde Liman kurulumu.

1. Ubuntu'ya güncel PHP ekleme

Ubuntu 20.04 ve 22.04 resmi depolarında PHP güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

2. Ubuntu'ya NodeJS yükleme

Ubuntu resmi depolarında NodeJS sürümü eski olduğu için aşağıdaki depoların eklenmesi gerekmektedir.

sudo apt install -y ca-certificates curl gnupg gnupg2
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt update

3. Ubuntu'ya PostgreSQL yükleme

Ubuntu 20.04 ve 22.04 resmi depolarında PostgreSQL güncel paketleri olmadığı için aşağıdaki depo eklenmesi gerekmektedir:

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo apt install gnupg2 ca-certificates -y
wget -O- https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor > pgsql.gpg
sudo mv pgsql.gpg /etc/apt/trusted.gpg.d/pgsql.gpg
sudo apt update

4. Liman paketi indirilmesi

4.1. GitHub üzerinden son sürüm indirilmesi

2.0 sürümüne ait en son çıkan paketi yukarıdaki adresten sunucunuza indirerek direkt şu şekilde çalıştırmalısınız.

sudo apt install ./liman-2.0-916.deb -y

4.2. Depo üzerinden kurulum (opsiyonel)

4.2.1. Ubuntu 22.04 - jammy

echo "deb [arch=amd64] http://depo.aciklab.org/ jammy main" | sudo tee /etc/apt/sources.list.d/acikdepo.list
wget -O- http://depo.aciklab.org/public.key  | gpg --dearmor > aciklab.gpg
sudo mv aciklab.gpg /etc/apt/trusted.gpg.d/aciklab.gpg

4.2.2. Ubuntu 20.04 - focal

echo "deb [arch=amd64] http://depo.aciklab.org/ focal main" | sudo tee /etc/apt/sources.list.d/acikdepo.list
wget -O- http://depo.aciklab.org/public.key  | gpg --dearmor > aciklab.gpg
sudo mv aciklab.gpg /etc/apt/trusted.gpg.d/aciklab.gpg

5. Depodan Liman paketini yükleme

Bu adımdan sonra Liman MYS'yi yükleyebilirsiniz:

sudo apt update
sudo apt install liman

6. Yönetici parolası oluşturma

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

sudo limanctl administrator

Liman yönetici parolasını unutmanız durumunda aşağıdaki komutu kullanarak parolasını sıfırlayabilirsiniz.

sudo limanctl reset administrator@liman.dev

Oracle Linux (RHEL based) 8.x Sunucu

Oracle Linux (RHEL based) 8.x üzerinde kurulum dokümantasyonu

1. PHP 8.1'in Etkinleştirilmesi

PHP'nin 8.1 sürümü için gerekli depolar eklenir ve sürüm etkinleştirilir.

sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-8.rpm -y
yum module reset php -y
yum module enable php:remi-8.1 -y

2. Postgresql-15'in Etkinleştirilmesi

Postgresql-15 sürümü için gerekli depolar eklenir ve sürüm etkinleştirilir.

sudo dnf install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm -y
yum module reset postgresql -y
yum module enable postgresql:15 -y

3. Kurulumun Gerçekleştirilmesi

Liman paketini indirebilmek için Açıklab deposundan indirilir.

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
yum install -y nodejs

sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -y
wget https://github.com/limanmys/core/releases/download/release.2.0/liman-2.0-916.rpm -O liman.rpm

Paketler güncellenir ve liman paketi kurulur.

sudo yum update -y
sudo yum install ./liman-2.0-916.rpm -y

4. Ek Yapılandırmalar Yapılır

LDAP sertifikalarını etkinleştirmek için aşağıdaki komut çalıştırılır. Aksi halde domain entegrasyonlarında bağlantı hatası alınacaktır.

file=/etc/openldap/ldap.conf; grep -q '^TLS_REQCERT' $file && sed -i 's/^TLS_REQCERT.*/TLS_REQCERT allow/' $file || echo 'TLS_REQCERT allow' >> $file

5. Yönetici Parolasının Oluşturulması

Kurulum sonrasında ilk yapılması gereken Yönetici parolası oluşturmak. Bunun için aşağıdaki komutlar ile sudo yetkili kullanıcı ile yönetici hesabı oluşturulur:

sudo limanctl administrator