Instalacija ONLYOFFICE Apps Community sa dodatnim parametrima skripte

Uvod

ONLYOFFICE Apps Community je besplatna verzija centra za dokumente u kojem možete povezati korisnike i dokumente na jednom mestu radi unapređenja saradnje.

ONLYOFFICE Apps Community se isporučuje kao skripta za automatsku instalaciju za Linux operativne sisteme sa instaliranim Docker-om. Skripta će postaviti Docker kontejnere sa svim komponentama potrebnim za ispravan rad ONLYOFFICE Apps Community i jednostavna je za pokretanje, upravljanje i ažuriranje.

Nakon što preuzmete skriptu za instalaciju ONLYOFFICE Apps Community, možda ćete morati da je pokrenete navođenjem nekih dodatnih parametara, na primer, ako želite da instalirate svaku komponentu na zasebnom računaru.

Koristite sledeću komandu za prikaz liste svih dostupnih Docker parametara skripte:

bash apps-install.sh docker -h

Koristite sledeću komandu za prikaz liste svih dostupnih DEB/RPM parametara skripte:

bash apps-install.sh package -h

U nastavku možete pronaći kratak opis i neke primere upotrebe ovih parametara.

Kada pokrenete skriptu sa parametrima, od vas će biti zatraženo da izaberete način na koji želite da instalirate ONLYOFFICE Apps. Unesite Y i pritisnite Enter da biste instalirali ONLYOFFICE Apps pomoću Docker-a. Unesite N i pritisnite Enter da biste instalirali ONLYOFFICE Apps iz DEB/RPM paketa.

Akreditivi

Parametar	Opis
-reg, --registry	URL Docker registra (npr. https://myregistry.com:5000)
-un, --username	korisničko ime za Docker registar
-p, --password	lozinka za Docker registar

Ovi parametri se koriste u slučaju da vam damo akreditive za pristup testnom repozitorijumu kako biste mogli da pokrenete kontejnere iz slika koje su u njemu uskladištene.

Primer

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

Tip instalacije

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

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

Primer

bash apps-install.sh -it enterprise

Ovo će instalirati rešenje ONLYOFFICE Apps Enterprise.

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-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šem računaru zastarele.

Primer

bash apps-install.sh -u true

Ovo će uzastopno zaustaviti kontejnere koje treba ažurirati, ukloniti ih i zatim pokrenuti najnovije verzije odgovarajućih komponenti ONLYOFFICE Apps Community. Ako se trenutna verzija komponente poklapa sa najnovijom dostupnom, 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 treba da budu preuzeti automatski.

Ažurirajte samo Docs na verziju 7.2.1.34 i preskočite ažuriranje svih ostalih komponenti:

bash apps-install.sh -u true -docsi onlyoffice/documentserver -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 svih ostalih komponenti:

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

Instalacija komponenti

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

Ovi parametri vam omogućavaju da navedete da li treba da instalirate određenu komponentu ili ne. Mogu se koristiti ako želite da instalirate svaku komponentu na zasebnom računaru.

• Koristite vrednost true da biste instalirali komponentu.
• Koristite vrednost false da biste preskočili instalaciju komponente.

Primer

bash apps-install.sh -idocs false

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

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

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

Verzija komponente

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

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

Primer

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

bash apps-install.sh -docsv 7.2.1.34

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

Ime slike ONLYOFFICE Docs

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

Ovaj parametar se može koristiti za navođenje imena slike ONLYOFFICE Docs iz koje treba pokrenuti kontejner. Navedena slika treba da bude uskladištena u našem zvaničnom javnom repozitorijumu na Docker Hub-u.

Primer

bash apps-install.sh -docsi onlyoffice/documentserver

Ovo će pokrenuti kontejner iz navedene slike ONLYOFFICE Docs uskladištene u repozitorijumu.

Podešavanje za hostove

Parametar	Opis
-ash, --appshost	host ONLYOFFICE Apps
-esh, --elastichost	hostovi OpenSearch

Ovi parametri se mogu koristiti za povezivanje komponenti ako ih instalirate na zasebnim računarima.

Primer

bash apps-install.sh -esh 192.168.3.202

Ovo će instalirati ONLYOFFICE Apps i povezati ga sa OpenSearch-om instaliranim na drugom računaru koji ima IP adresu 192.168.3.202.

Podešavanje za core.machinekey

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

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

note

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

Primer

bash apps-install.sh -mk yourmachinekey

Eksterni port za ONLYOFFICE Apps

Parametar	Opis	Podrazumevano
-ep, --externalport	eksterni port ONLYOFFICE Apps	80

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

Primer

bash apps-install.sh -ep 8080

Podešavanja za JWT header i secret

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

Ovi parametri vam omogućavaju da navedete JWT header i sopstveni tajni JWT ključ prilikom instalacije ONLYOFFICE Apps Community. JWT header definiše http header koji će se koristiti za slanje JWT-a. 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 kontejnera onlyoffice-studio i onlyoffice-document-server):

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

Primer

bash apps-install.sh -js yoursecret

MySQL server

Parametar	Opis	Podrazumevano
-mysqlrp, --mysqlrootpassword	root lozinka MySQL servera	automatski generisano
-mysqlh, --mysqlhost	host MySQL servera	localhost
-mysqlport, --mysqlport	broj porta MySQL servera	3306

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

Primer

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

Ova komanda vam omogućava da tokom instalacije ONLYOFFICE Apps Community podesite sopstvenu lozinku za MySQL root nalog.

Baza podataka za 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 vam omogućavaju da kreirate bazu podataka ONLYOFFICE Apps navođenjem prilagođenog imena baze podataka, kao i korisničkog imena i lozinke za nalog sa superkorisničkim dozvolama nad kreiranom bazom podataka. Ako ime baze podataka ne navedete eksplicitno, koristi se podrazumevana vrednost. Ako ne podesite lozinku, ona se generiše automatski.

Primer

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

RabbitMQ server

Parametar	Opis	Podrazumevano
--rabbitmqprotocol	RabbitMQ protokol povezivanja	amqp
--rabbitmqhost	host RabbitMQ servera	localhost
--rabbitmqport	broj porta RabbitMQ servera	5672
--rabbitmqusername	RabbitMQ korisničko ime	-
--rabbitmqpassword	RabbitMQ lozinka korisnika	-
--rabbitmqvirtualhost	RabbitMQ virtuelni host	/

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

Primer

bash apps-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	Redis korisničko ime, ako server zahteva autorizaciju	-
--redispassword	Redis lozinka korisnika, ako server zahteva autorizaciju	-

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

Primer

bash apps-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	OpenSearch protokol povezivanja	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 drugom računaru. Ako protokol i port ne navedete eksplicitno, koriste se podrazumevane vrednosti.

Primer

bash apps-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 e-adresu administratora domena za Let's Encrypt sertifikat
-cf, --certfile	putanja do datoteke sertifikata za domen
-ckf, --certkeyfile	putanja do datoteke privatnog ključa za sertifikat

Ovi parametri vam omogućavaju da radni prostor prebacite na HTTPS. Mogu se koristiti samo za Docker verziju.

Primer

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

Ovo će automatski kreirati i instalirati sertifikat koji je potpisao CA letsencrypt.org na vaš server i ponovo pokrenuti NGINX servis da bi promene stupile na snagu.

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

Ovo će primeniti vaš sopstveni SSL sertifikat.