Instalacija ONLYOFFICE Apps Developer uz dodatne parametre skripte

Uvod

ONLYOFFICE Apps Developer je plaćena verzija dokumentacionog centra gde možete povezati korisnike i dokumente na jednom mestu kako biste poboljšali saradnju.

ONLYOFFICE Apps Developer dolazi kao automatski skript za instalaciju za Linux operativne sisteme sa instaliranim Docker-om. Skript će postaviti Docker kontejnere sa svim komponentama potrebnim za ispravan rad ONLYOFFICE Apps Developer i lako ga je pokrenuti, upravljati i ažurirati.

Nakon što preuzmete skript za instalaciju ONLYOFFICE Apps Developer, možda ćete morati da ga pokrenete sa dodatnim parametrima, na primer, ako želite da instalirate svaku komponentu na zasebnoj mašini.

Koristite sledeću komandu da prikažete listu svih dostupnih Docker skript parametara:

bash apps-developer-install.sh docker -h

Koristite sledeću komandu da prikažete listu svih dostupnih DEB/RPM skript parametara:

bash apps-developer-install.sh package -h

Ispod možete pronaći kratak opis i neke primere korišćenja ovih parametara.

Kada pokrenete skript sa parametrima, bićete upitani da izaberete način na koji želite da instalirate ONLYOFFICE Apps. Upišite Y i pritisnite Enter da instalirate ONLYOFFICE Apps koristeći Docker. Upišite N i pritisnite Enter da instalirate ONLYOFFICE Apps iz DEB/RPM paketa.

Pristupni podaci

Parametar	Opis
-reg, --registry	URL docker registra (npr. https://myregistry.com:5000)
-un, --username	prijava na docker registar
-p, --password	lozinka za docker registar

Ovi parametri se koriste u slučaju da vam pružimo pristupne podatke za pristup testnom repozitorijumu kako biste mogli da pokrećete kontejnere iz slika koje su u njemu skladištene.

Primer

bash apps-developer-install.sh -reg URL -un username -p password

Tip instalacije

Parametar	Opis	Vrednosti	Podrazumevano
-it, --installationtype	tip instalacije	community|developer|enterprise	developer

Ovaj parametar vam omogućava da instalirate određeno rešenje: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer ili ONLYOFFICE Apps Enterprise.

Primer

bash apps-developer-install.sh -it community

Ovo će instalirati rešenje ONLYOFFICE Apps Community.

Provera hardvera

Parametar	Opis	Vrednosti	Podrazumevano
-skiphc, --skiphardwarecheck	koristite za preskakanje provere hardvera	true|false	false

Ovaj parametar vam omogućava da preskočite proveru da li sistem ispunjava minimalne hardverske zahteve.

Primer

bash apps-developer-install.sh -skiphc true

Ovo će preskočiti proveru hardvera.

Ažuriranje komponenti

Parametar	Opis	Vrednosti	Podrazumevano
-u, --update	koristite za ažuriranje postojećih komponenti	true|false	false

Ovaj parametar vam omogućava da instalirate najnovije verzije potrebnih komponenti ako su odgovarajuće komponente instalirane na vašoj mašini zastarele.

Primer

bash apps-developer-install.sh -u true

Ovo će zaustaviti one kontejnere koji treba da budu ažurirani, ukloniti ih i zatim pokrenuti najnovije verzije odgovarajućih komponenti ONLYOFFICE Apps Developer. Ako trenutna verzija komponente odgovara najnovijoj dostupnoj, takav kontejner neće biti pogođen. Ako ste preskočili neke komponente tokom prethodne instalacije, one će takođe biti preskočene. Podaci ONLYOFFICE Apps-a bi trebalo automatski da se preuzmu.

Ažurirajte samo Docs na verziju 7.2.1.34 i preskočite ažuriranje za sve ostale komponente:

bash apps-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false

Ažurirajte samo ONLYOFFICE Apps na verziju 1.2.0 i preskočite ažuriranje za sve ostale komponente:

bash apps-developer-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false

Instalacija komponenti

Parametar	Opis	Vrednosti	Podrazumevano
-ia, --installapps	instalirajte ONLYOFFICE Apps	true|false	true
-idocs, --installdocs	instalirajte ONLYOFFICE Docs	true|false	true
-irbt, --installrabbitmq	instalirajte RabbitMQ	true|false	true
-irds, --installredis	instalirajte Redis	true|false	true
-imysql, --installmysql	instalirajte MySQL	true|false	true

Ovi parametri vam omogućavaju da navedete da li je potrebno instalirati određenu komponentu ili ne. Mogu se koristiti ako želite da instalirate svaku komponentu na zasebnoj mašini.

• Koristite vrednost true da instalirate komponentu.
• Koristite vrednost false da preskočite instalaciju komponente.

Primer

bash apps-developer-install.sh -idocs false

Ovo će instalirati sve komponente ONLYOFFICE Apps Developer bez ONLYOFFICE Docs.

bash apps-developer-install.sh -ia false -idocs true -imysql false -irbt false -irds false

Ovo će preskočiti instalaciju ONLYOFFICE Apps, MySQL, RabbitMQ i Redis i instalirati samo ONLYOFFICE Docs.

Verzija komponente

Parametar	Opis
-asv, --appsversion	verzija ONLYOFFICE Apps
-docsv, --docsversion	verzija ONLYOFFICE Docs

Ovi parametri mogu se koristiti za instalaciju određene verzije ONLYOFFICE Apps ili ONLYOFFICE Docs ukoliko iz nekog razloga ne želite da instalirate najnoviju verziju dostupnu u repozitorijumu. Podrazumevano, slika označena kao latest koristi se za pokretanje kontejnera komponente.

Primer

Otvorite repozitorijum na Docker Hub u vašem pregledaču, izaberite ONLYOFFICE Docs i idite na karticu Tags da biste videli sve dostupne oznake u repozitorijumu. Navedite verziju koju želite da instalirate:

bash apps-developer-install.sh -docsv 7.2.1.34

Ovo će instalirati ONLYOFFICE Apps sa verzijom ONLYOFFICE Docs 7.2.1.34.

Ime slike ONLYOFFICE Docs

Parametar	Opis
-docsi, --docsimage	Ime slike ONLYOFFICE Docs

Ovaj parametar može se koristiti za određivanje imena slike ONLYOFFICE Docs iz koje bi trebalo pokrenuti kontejner. Navedena slika treba da bude sačuvana u našem zvaničnom javnom repozitorijumu na Docker Hub.

Primer

bash apps-developer-install.sh -docsi onlyoffice/documentserver-de

Ovo će pokrenuti kontejner iz navedene slike ONLYOFFICE Docs sačuvane u repozitorijumu.

Podešavanje za hostove

Parametar	Opis
-ash, --appshost	Host za ONLYOFFICE Apps
-esh, --elastichost	Hostovi za OpenSearch

Ovi parametri mogu se koristiti za povezivanje komponenti ukoliko ih instalirate na različitim mašinama.

Primer

bash apps-developer-install.sh -esh 192.168.3.202

Ovo će instalirati ONLYOFFICE Apps i povezati ga sa OpenSearch instaliranim na drugoj mašini koja ima IP adresu 192.168.3.202.

Podešavanje za core.machinekey

Parametar	Opis
-mk, --machinekey	Podešavanje za ključ core.machinekey

Ovaj parametar omogućava vam da navedete svoj sopstveni machinekey prilikom instalacije ONLYOFFICE Apps Developer.

note

Ovaj parametar se upisuje u konfiguracionu datoteku /app/onlyoffice/config/appsettings.json (putanja je navedena unutar onlyoffice-studio kontejnera).

Primer

bash apps-developer-install.sh -mk yourmachinekey

Eksterni port za ONLYOFFICE Apps

Parametar	Opis	Podrazumevano
-ep, --externalport	Eksterni port za ONLYOFFICE Apps	80

Ovaj parametar omogućava vam da promenite port na kojem će ONLYOFFICE Apps raditi. Podrazumevano se koristi port 80.

Primer

bash apps-developer-install.sh -ep 8080

Podešavanja za JWT zaglavlje i tajnu

Parametar	Opis
-jh, --jwtheader	Podešavanje za JWT zaglavlje
-js, --jwtsecret	Podešavanje za tajni ključ JWT

Ovi parametri omogućavaju vam da navedete JWT zaglavlje i svoj sopstveni tajni ključ JWT prilikom instalacije ONLYOFFICE Apps Developer. JWT zaglavlje definiše HTTP zaglavlje koje će se koristiti za slanje JWT. Tajni ključ se koristi za potpisivanje JSON web tokena i validaciju tokena prilikom zahteva ka ONLYOFFICE Docs.

note

Ovi parametri se upisuju u sledeće konfiguracione datoteke (putanje su navedene unutar onlyoffice-studio i onlyoffice-document-server kontejnera):

• Za ONLYOFFICE Apps - /app/onlyoffice/config/appsettings.json
• Za Document Server - /etc/onlyoffice/documentserver/local.json

Primer

bash apps-developer-install.sh -js yoursecret

MySQL server

Parametar	Opis	Podrazumevano
-mysqlrp, --mysqlrootpassword	Lozinka za root nalog MySQL servera	automatski generisano
-mysqlh, --mysqlhost	Host MySQL servera	localhost
-mysqlport, --mysqlport	Broj porta MySQL servera	3306

Ako ne navedete eksplicitno host i port, koriste se podrazumevane vrednosti. Root lozinka se automatski generiše ako je ne postavite.

Primer

bash apps-developer-install.sh -mysqlrp new-secret-pw

Ova komanda vam omogućava da postavite svoju lozinku za root nalog MySQL servera tokom instalacije ONLYOFFICE Apps Developer.

Baza podataka ONLYOFFICE Apps

Parametar	Opis	Podrazumevano
-mysqld, --mysqldatabase	Ime baze podataka ONLYOFFICE Apps	onlyoffice_apps
-mysqlu, --mysqluser	Korisnik baze podataka ONLYOFFICE Apps	-
-mysqlp, --mysqlpassword	Lozinka baze podataka ONLYOFFICE Apps	automatski generisano

Ovi parametri omogućavaju vam da kreirate bazu podataka ONLYOFFICE Apps navodeći prilagođeno ime baze, kao i korisničko ime i lozinku za nalog sa superuser ovlašćenjima na kreiranoj bazi. Ako ne navedete eksplicitno ime baze podataka, koristi se podrazumevana vrednost. Ako ne postavite lozinku, ona se automatski generiše.

Primer

bash apps-developer-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password

RabbitMQ server

Parametar	Opis	Podrazumevano
--rabbitmqprotocol	Protokol za povezivanje sa RabbitMQ-om	amqp
--rabbitmqhost	Host RabbitMQ servera	localhost
--rabbitmqport	Broj porta RabbitMQ servera	5672
--rabbitmqusername	Korisničko ime za RabbitMQ	-
--rabbitmqpassword	Lozinka korisnika RabbitMQ-a	-
--rabbitmqvirtualhost	Virtuelni host RabbitMQ-a	/

Koristite ove parametre da povežete ONLYOFFICE Apps sa RabbitMQ serverom koji već radi na drugoj mašini. Preskočite instalaciju RabbitMQ-a parametrom -irbt false, a zatim navedite parametre povezivanja vašeg servera. Ako ne navedete eksplicitno protokol, host, port ili virtuelni host, koriste se podrazumevane vrednosti.

Primer

bash apps-developer-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password

Ovo će instalirati ONLYOFFICE Apps bez RabbitMQ-a i povezati ga sa RabbitMQ serverom koji radi na hostu mq.example.com.

Redis server

Parametar	Opis	Podrazumevano
--redishost	Host Redis servera	localhost
--redisport	Broj porta Redis servera	6379
--redisusername	Korisničko ime za Redis, ako server zahteva autorizaciju	-
--redispassword	Lozinka korisnika Redis-a, ako server zahteva autorizaciju	-

Koristite ove parametre da povežete ONLYOFFICE Apps sa Redis serverom koji već radi na drugoj mašini. Preskočite instalaciju Redis-a parametrom -irds false, a zatim navedite parametre povezivanja vašeg servera. Korisničko ime i lozinka potrebni su samo ako vaš Redis server zahteva autorizaciju.

Primer

bash apps-developer-install.sh -irds false --redishost redis.example.com --redispassword password

Ovo će instalirati ONLYOFFICE Apps bez Redis-a i povezati ga sa Redis serverom koji radi na hostu redis.example.com.

OpenSearch server

Parametar	Opis	Podrazumevano
--elasticprotocol	Protokol za povezivanje sa OpenSearch-om	http
--elasticport	Broj porta OpenSearch servera	9200

Koristite ove parametre zajedno sa parametrom -esh, --elastichost opisanim u odeljku „Podešavanje za hostove“ iznad da povežete ONLYOFFICE Apps sa OpenSearch serverom koji radi na drugoj mašini. Ako ne navedete eksplicitno protokol i port, koriste se podrazumevane vrednosti.

Primer

bash apps-developer-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200

Ovo će povezati ONLYOFFICE Apps sa OpenSearch serverom koji radi na hostu search.example.com preko HTTPS-a.

Prelazak na HTTPS

Parametar	Opis
-led, --letsencryptdomain	definiše domen za Let's Encrypt sertifikat
-lem, --letsencryptmail	definiše adresu e-pošte administratora domena za Let's Encrypt sertifikat
-cf, --certfile	putanja do fajla sa sertifikatom za domen
-ckf, --certkeyfile	putanja do fajla sa privatnim ključem za sertifikat

Ovi parametri omogućavaju prebacivanje radnog prostora na HTTPS. Mogu se koristiti samo za Docker verziju.

Primer

bash apps-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com

Ovo će automatski kreirati i instalirati letsencrypt.org sertifikat potpisan od strane CA na vaš server i restartovati NGINX servis kako bi promene stupile na snagu.

bash apps-developer-install.sh docker --certfile path --certkeyfile path

Ovo će primeniti vaš sopstveni SSL sertifikat.