DSpace 8 telepítése Ubuntu 24.04 alatt

  • Linux
  • 2025. február 17.
Tartalomjegyzék

Rendszergazdai jelszó beállítása

Először is állítsd be a rendszergazdai (root) jelszót, hogy szükség esetén beléphess root felhasználóként. Futtasd az alábbi parancsot:

sudo -i passwd

Ezután add meg a saját felhasználói jelszavadat a hitelesítéshez. Majd amikor a rendszer kéri, adj meg egy új jelszót a root fiókhoz, és erősítsd meg.

A helyi szerver frissítése

Mielőtt bármilyen új szoftvert telepítenél, mindig érdemes frissíteni a csomaglistát és a már telepített csomagokat. Futtasd a következő parancsokat:

sudo apt update
sudo apt upgrade -y

Az első parancs frissíti a csomaglistát az elérhető legújabb verziókra, míg a második telepíti az összes elérhető frissítést. A -y kapcsoló automatikusan elfogadja a frissítéseket, így nem kell manuálisan megerősítened.

Root felhasználóként való bejelentkezés

Ha root felhasználóként kell dolgoznod, használd az alábbi parancsot:

su

Amikor a rendszer kéri, add meg a korábban beállított root jelszót.

JAVA telepítése

A DSpace telepítéséhez szükséged lesz Java-ra. Telepítsd a megfelelő verziót az alábbi paranccsal:

sudo apt install openjdk-17-jdk -y

Ellenőrizd a telepített Java verzióját:

java -version

Ha a verzió megfelelően megjelenik, a Java sikeresen települt.

Java változók beállítása

A Java megfelelő működéséhez be kell állítani a környezeti változókat. Nyisd meg a nano szövegszerkesztőt az alábbi paranccsal:

sudo nano /etc/environment

A fájl végére adj hozzá két új sort:

JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"
JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"

Mentéshez nyomd meg CTRL + X, majd Y és Enter.

Ezután forrásold a fájlt, hogy a változások érvénybe lépjenek:

source /etc/environment

Ellenőrizd, hogy a Java Home megfelelően beállt-e:

echo $JAVA_HOME

Ha a helyes útvonal jelenik meg, a beállítás sikeres volt.

Apache Maven és Apache ANT telepítése

A Maven és ANT eszközök szükségesek a DSpace csomagok összeállításához. Telepítsd őket az alábbi paranccsal:

sudo apt install maven ant -y

Ellenőrizd a Maven telepítését:

mvn -v

Ha a verzióinformáció megjelenik, a telepítés sikeres.

PostgreSQL telepítése

A DSpace adatbázisának kezeléséhez PostgreSQL-re van szükség. Telepítsd a következő paranccsal:

sudo apt-get install postgresql postgresql-client postgresql-contrib libpostgresql-jdbc-java -y

Ellenőrizd a telepített PostgreSQL verzióját:

psql -V

A telepítés után indítsd el az adatbázis szervert:

sudo pg_ctlcluster 16 main start

Az adatbázis állapotának ellenőrzése:

sudo systemctl status postgresql

Ha az állapot “active (running)”, akkor a szerver sikeresen elindult. Kilépéshez nyomd meg a q billentyűt.

Új PostgreSQL felhasználó létrehozása

Először állíts be egy új jelszót a PostgreSQL alapértelmezett “postgres” felhasználójának:

sudo passwd postgres

Add meg és erősítsd meg az új jelszót. Ezután jelentkezz be a PostgreSQL felhasználóként:

su postgres

Ellenőrizd, hogy az adatbázis szerver UTF8 karakterkódolást használ-e:

psql -c "SHOW SERVER_ENCODING"

Ha az eredmény UTF8, akkor nincs szükség további beállításra. Kilépéshez használd az exit parancsot.

TCP/IP kapcsolat engedélyezése

Nyisd meg a PostgreSQL konfigurációs fájlt:

sudo nano /etc/postgresql/16/main/postgresql.conf

Keress rá erre a sorra:

#listen_addresses = 'localhost'

Távolítsd el a # karaktert a sor elejéről, így engedélyezve a kapcsolatokat a helyi gépről:

listen_addresses = 'localhost'

Majd nyisd meg a pg_hba.conf fájlt a biztonsági beállítások módosításához:

sudo nano /etc/postgresql/16/main/pg_hba.conf

Adjuk hozzá az alábbi sort a fájl végéhez:

host dspace dspace 127.0.0.1 255.255.255.255 md5

Ez engedélyezi a dspace nevű adatbázis felhasználójának, hogy csatlakozzon az adatbázishoz az adott IP-címről.

Ezután indítsd újra a PostgreSQL szolgáltatást, hogy az új beállítások érvénybe lépjenek:

sudo systemctl restart postgresql

Solr telepítése

A Solr egy nyílt forráskódú keresőplatform, amelyet a DSpace keresési funkcióinak támogatásához használunk. A telepítés során letöltjük a Solr csomagot, kicsomagoljuk, majd szolgáltatásként telepítjük:

  1. Csomag letöltése és kicsomagolása: Navigálj az otthoni könyvtárba, majd töltsd le a Solr csomagot:

    cd
sudo wget https://downloads.apache.org/lucene/solr/8.11.4/solr-8.11.4.zip

    Miután a letöltés befejeződött, csomagold ki a ZIP fájlt:

    sudo unzip solr-8.11.4.zip

  2. Solr szolgáltatás telepítése: A Solr-t most telepítjük szolgáltatásként:

    sudo bash solr-8.11.4/bin/install_solr_service.sh solr-8.11.4.zip

  3. Szolgáltatás indítása és engedélyezése: Engedélyezd és indítsd el a Solr-t, majd ellenőrizd az állapotát:

    sudo systemctl enable solr
sudo systemctl start solr
sudo systemctl status solr

    Ha a szolgáltatás fut, a Solr webes felülete elérhető lesz a böngésződben a http://localhost:8983/solr címen.

Apache Tomcat (tomcat10) telepítése

A DSpace webalkalmazásainak futtatásához szükség van egy Java-alapú webszerverre, mint például a Tomcat. Az alábbi lépések segítenek a tomcat10 telepítésében és konfigurálásában:

  1. Telepítés: Root felhasználóként telepítsd a tomcat10 csomagot:

    sudo apt install tomcat10 -y

  2. Biztonsági beállítások módosítása: Annak érdekében, hogy a Tomcat hozzáférjen a DSpace könyvtárhoz, módosítsd a Tomcat szolgáltatás konfigurációs fájlját:

    sudo nano /lib/systemd/system/tomcat10.service

    Illeszd be az alábbi sort:

    ReadWritePaths=/dspace/

    Ez biztosítja, hogy a Tomcat írási jogosultságot kapjon a /dspace/ könyvtárra.

  3. DSpace könyvtár létrehozása és jogosultságok beállítása: Hozz létre egy könyvtárat a DSpace telepítéséhez, és állítsd be a megfelelő jogosultságokat:

    cd
sudo mkdir /dspace
sudo chown -R dspace:dspace /dspace/

  4. Tomcat konfiguráció módosítása: Nyisd meg a Tomcat konfigurációs fájlt:

    sudo nano /etc/tomcat10/server.xml

    Illeszd be a következő blokkot, amely a HTTP kérések kezelését és az UTF-8 kódolást biztosítja:

    <Connector port="8080" protocol="HTTP/1.1"
			minSpareThreads="25"
			enableLookups="false"
			redirectPort="8443"
			connectionTimeout="20000"
			disableUploadTimeout="true"
			URIEncoding="UTF-8"/>

  5. Tomcat újraindítása: A változtatások érvényesítéséhez töltsd újra a szolgáltatás konfigurációt és indítsd újra a Tomcat-et:

    sudo systemctl daemon-reload
sudo systemctl restart tomcat10.service

Build könyvtár létrehozása

A DSpace forráskódjának összeállításához (build) létrehozunk egy külön könyvtárat:

cd
sudo mkdir /build
sudo chown -R dspace:dspace /build
cd /build

Ez a könyvtár fogja tartalmazni a letöltött DSpace forráskódot és az összeállítási folyamat során keletkező fájlokat.

DSpace 8.0 letöltése

  1. Letöltés: Töltsd le a DSpace 8.0 verzióját a GitHub repository-ból:

    sudo wget https://github.com/Dspace/Dspace/archive/refs/tags/dspace-8.0.zip

  2. Kicsomagolás és mappába lépés: Csomagold ki a ZIP fájlt, majd lépj be az így létrejött mappába:

    sudo unzip dspace-8.0.zip
cd DSpace-dspace-8.0/

Adatbázis beállítása

A DSpace működéséhez egy PostgreSQL adatbázisra van szükség. Kövesd az alábbi lépéseket:

  1. Átváltás a PostgreSQL felhasználóra:

    su postgres

  2. Navigálás a konfigurációs könyvtárba:

    cd /etc/postgresql/16/main

  3. Új felhasználó és adatbázis létrehozása: Hozd létre a dspace felhasználót, majd az adatbázist, és aktiváld a szükséges kiterjesztést:

    createuser --username=postgres --no-superuser --pwprompt dspace
# Create the user named dspace. Enter the password when it asks. This is the connection password for the DSpace database; note it down. 
createdb --username=postgres --owner=dspace --encoding=UNICODE dspace
psql --username=postgres dspace -c "CREATE EXTENSION pgcrypto;"
exit

    Az első parancs során megadott jelszót később a konfigurációban fogod használni.

Helyi konfiguráció (local.cfg)

A DSpace működéséhez testreszabott konfigurációs fájlra van szükség:

  1. Másold át a mintafájlt és nyisd meg szerkesztésre:

    cd /build/DSpace-dspace-8.0/dspace/config
sudo cp local.cfg.EXAMPLE local.cfg
sudo nano /build/DSpace-dspace-8.0/dspace/config/local.cfg

  2. Konfiguráció módosítása: Győződj meg róla, hogy a következő beállítások megfelelőek:

    dspace.dir=/dspace
dspace.name = <Add meg a Repository nevét>
default.language = en_US
solr.server = http://localhost:8983/solr
db.username = dspace
db.password = [PostgreSQL jelszó]

    A db.password-nek meg kell egyeznie a PostgreSQL felhasználó létrehozásakor beállított jelszóval.

Telepítési csomag összeállítása

Az előző lépések után össze kell állítanod a DSpace telepítési csomagot:

  1. Átváltás root felhasználóra és a forráskód könyvtárába lépés:

    sudo su
cd /build/DSpace-dspace-8.0

  2. A csomag összeállítása Maven segítségével:

    mvn package

    Ez a parancs letölti a szükséges függőségeket és összeállítja a telepítési csomagot. A folyamat eltarthat egy ideig, a géped teljesítményétől függően.

Backend telepítése

A backend telepítése során a DSpace alapvető szolgáltatásait konfiguráljuk és telepítjük:

  1. Telepítő csomag elérése és friss telepítés futtatása:

    cd /build/DSpace-dspace-8.0/dspace/target/dspace-installer/
ant fresh_install

    Ez a parancs létrehozza a szükséges adatbázis struktúrákat, konfigurációs fájlokat, valamint inicializálja a backend szolgáltatásokat.

Webalkalmazások Tomcat10-be másolása

A backend telepítése után a létrejött webalkalmazásokat át kell helyezni a Tomcat alapértelmezett könyvtárába, hogy a szerver kiszolgálhassa őket:

sudo cp -R /dspace/webapps/* /var/lib/tomcat10/webapps*

Ez biztosítja, hogy a Tomcat a megfelelő helyről tudja betölteni a DSpace alkalmazásait.

DSpace Solr mappák átmásolása

Ahhoz, hogy a Solr megfelelően kezelje a DSpace keresési funkcióit, az alábbi lépések szükségesek:

  1. Solr konfigurációs mappák másolása:

    sudo cp -R /dspace/solr/* /var/solr/data

  2. Könyvtár jogosultságainak módosítása:

    Állítsd be, hogy a Solr szolgáltatás hozzáférhessen az adatokat:

    sudo chown -R solr:solr /var/solr/data

  3. Solr újraindítása:

    Alkalmazd a változtatásokat:

    sudo systemctl restart solr

    Ellenőrizd a Solr webes felületét a

    http://localhost:8983

    címen, és győződj meg róla, hogy a bal oldali panelen elérhető a

    Core Selector

    .

Adatbázis inicializálása

Az esetleges adatbázis frissítések és migrációk elvégzéséhez futtasd az alábbi parancsot:

cd /dspace/bin/
./dspace database migrate

Ez a lépés biztosítja, hogy az adatbázis struktúrája naprakész legyen a telepített DSpace verzióhoz.

DSpace Adminisztrátor fiók létrehozása

Hozz létre egy adminisztrátori fiókot a rendszer kezeléséhez:

sudo /dspace/bin/dspace create-administrator

Kövesd a megjelenő utasításokat a felhasználónév, jelszó és egyéb adatok megadásához.

Jogosultságok módosítása

Annak érdekében, hogy a Tomcat megfelelően hozzáférjen a DSpace fájlrendszeréhez, módosítsd a fájlok tulajdonjogát:

sudo chown -R tomcat:tomcat /dspace/

Tomcat újraindítása

A módosítások alkalmazása után töltsd újra a Tomcat szolgáltatást:

sudo systemctl restart tomcat10.service
sudo systemctl daemon-reload

Most nyisd meg a böngészőt, és ellenőrizd, hogy a REST API interfész elérhető-e a http://localhost:8080/server címen.

Frontend telepítése

A DSpace felhasználói felületét Angular alapú webalkalmazásként készítették, így a következő lépések a frontend telepítését és konfigurálását írják le.

Node.js és NPM telepítése

Telepítsd a Node.js-t és az NPM-et, amelyek szükségesek a frontend fejlesztéséhez és futtatásához:

sudo apt install nodejs npm -y

Ellenőrizd a telepítés sikerét a verziószámok megjelenítésével, ha szükséges.

Yarn és PM2 telepítése

A Yarn egy alternatív csomagkezelő, amelyet az Angular projekt kezeléséhez használunk, míg a PM2 segít az alkalmazás futásának menedzselésében:

sudo npm install --global yarn
sudo npm install --global pm2

DSpace Angular front end telepítése

  1. DSpace felhasználó home könyvtárába lépés és csomag letöltése: Az Angular alapú DSpace felületet a DSpace felhasználó home könyvtárába fogjuk telepíteni:

    sudo su
cd /home/dspace

    Töltsd le a dspace-angular csomagot:

    sudo wget https://github.com/DSpace/dspace-angular/archive/refs/tags/dspace-8.0.zip

  2. Csomag kicsomagolása és felesleges fájl törlése: Csomagold ki a letöltött fájlt:

    unzip dspace-8.0.zip

    Majd távolítsd el a ZIP csomagot:

    rm  dspace-8.0.zip

  3. Projekt könyvtárba lépés és függőségek telepítése: Lépj be a kicsomagolt mappába:

    cd /home/dspace/dspace-angular-dspace-8.0

    Telepítsd a projekt függőségeit a Yarn segítségével:

    yarn install

Konfiguráció beállítása

  1. Navigálj a konfigurációs könyvtárba:

    cd /home/dspace/dspace-angular-dspace-8.0/config/

  2. Konfigurációs fájl másolása és szerkesztése:

    Másold át az alapértelmezett konfigurációs fájlt, majd nevezd át:

    cp config.example.yml config.prod.yml

    Nyisd meg a fájlt szerkesztésre:

    nano config.prod.yml

    Ellenőrizd, hogy a következő beállítások megfelelőek:

    rest:
  ssl: false
  host: localhost
  port: 8080

    Ezek a beállítások határozzák meg, hogyan érheti el a frontend a backend REST API-t.

A frontend build összeállítása

A production build elkészítéséhez futtasd a következő parancsot:

yarn run build:prod

Ez a parancs optimalizált változatot készít az alkalmazásból. Megjegyzés: Ha a build során memóriahiány miatt hibák lépnek fel, növeld a géped RAM kapacitását (legalább 5-6 GB ajánlott).

Miután a build elkészült, lépj ki a root környezetből:

exit

A felhasználói felület indítása

  1. PM2 konfiguráció létrehozása: Hozz létre egy PM2 JSON konfigurációs fájlt:

    sudo nano /home/dspace/dspace-angular-dspace-8.0/dspace-ui.json

    Illeszd be a következő tartalmat:

    {
    "apps": [
        {
           "name": "dspace-ui",
           "cwd": "/home/dspace/dspace-angular-dspace-8.0/",
           "script": "dist/server/main.js",
           "instances": "max",
           "exec_mode": "cluster",
           "env": {
              "NODE_ENV": "production"
           }
        }
    ]
}

  2. Alkalmazás indítása PM2-vel: Indítsd el a frontend alkalmazást:

    sudo su
pm2 start /home/dspace/dspace-angular-dspace-8.0/dspace-ui.json

  3. Automatikus indítás beállítása cron segítségével: Ahhoz, hogy a szolgáltatás rendszerindításkor automatikusan elinduljon, adj hozzá egy cron bejegyzést:

    crontab -e

    A megnyíló szerkesztőben add hozzá a következő sort:

    #Auto start dspace-angular
@reboot bash -ci 'pm2 start /home/dspace/dspace-angular-dspace-8.0/dspace-ui.json'

    Mentsd el a fájlt a CTRL + O-val, majd lépj ki a CTRL + X-szel.

A DSpace felhasználói felület elérése

Nyisd meg a böngészőt, és látogasd meg a következő URL-t: http://localhost:4000

Itt láthatod a DSpace frontendet, és ellenőrizheted, hogy az alkalmazás megfelelően működik.