Implementacija ONLYOFFICE Docs Enterprise izdanja koristeći AMI

Uvod

Sada možete lako pokrenuti instancu ONLYOFFICE Docs Enterprise Edition u infrastrukturi oblaka Amazon Web Services koristeći ONLYOFFICE Amazon Machine Image dostupnu na AWS Marketplace.

Amazon Machine Image (AMI) je unapred konfigurisani šablon koji omogućava lako pokretanje instance, što je virtuelni server u privatnom oblaku AWS.

ONLYOFFICE Docs Enterprise Edition AMI uključuje sve potrebne komponente - kako operativni sistem tako i sam softver, kao i volumen za skladištenje - za postavljanje vašeg web kancelarijskog paketa na virtuelnom serveru koji radi pod Linuxom (CentOS).

Kada je vaša instanca ONLYOFFICE Docs Enterprise Edition pokrenuta, možete integrisati ONLYOFFICE Docs sa jednom od platformi za sinhronizaciju i deljenje fajlova, kao što su Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub itd.

Korak 1. Izaberite potrebni ONLYOFFICE AMI i pretplatite se na rešenje

Prijavite se na vaš postojeći AWS nalog ili se registrujte za novi i idite na AWS Marketplace.

Pronađite rešenje ONLYOFFICE Docs Enterprise Edition i izaberite potrebni tip instance – za 50, 100, 200 ili 400 konekcija. Konekcije označavaju broj kartica u pregledaču sa dokumentima koji mogu biti otvoreni za uređivanje istovremeno. Imajte na umu da jedan dokument otvoren od strane dva korisnika znači dve istovremene konekcije, jer je otvoren u dve kartice. Kada dostignete limit, svaki sledeći dokument se otvara u režimu samo za čitanje.

Na stranici Pregled proizvoda možete pročitati opis funkcija softvera.

Pređite na karticu Cene da biste procenili detalje o cenama koji zavise od nekih parametara instance:

• Promenite Region gde će instanca biti pokrenuta, ako je potrebno. Preporučuje se da izaberete region sa najbližom lokacijom. US East (N. Virginia) je izabran po defaultu.
• U meniju Opcija ispunjenja dostupna je samo opcija 64-bitne (x86) Amazon Machine Image (AMI).
• U sekciji Detalji o cenama softvera, izaberite tip pretplate po satu ili godišnje.

  Ukupna cena uključuje troškove za ONLYOFFICE softver i za AWS infrastrukturne usluge korišćene za postavljanje ovog softverskog rešenja.

  Napomena: za više informacija o pretplati na plaćene AMI-je i druge detalje o cenama, molimo vas da se obratite AWS dokumentaciji.

Ako kliknete na EC2 tip instance prikazan u tabeli (npr. t3.large), možete videti detalje o instanci. EC2 tip instance određuje hardver virtuelnog servera korišćenog za postavljanje ONLYOFFICE rešenja.

Dostupni tipovi instanci se razlikuju u zavisnosti od izabrane varijante ONLYOFFICE Docs Enterprise Edition rešenja, tj. od broja dozvoljenih konekcija.

t3.small EC2 tip instance se koristi za ONLYOFFICE Docs Enterprise Edition (50 konekcija). Ima sledeće parametre:

• Memorija: 2 GB
• CPU: 2 virtuelna jezgra
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

t3.medium EC2 tip instance se koristi za ONLYOFFICE Docs Enterprise Edition (100 konekcija). Ima sledeće parametre:

• Memorija: 4 GB
• CPU: 2 virtuelna jezgra
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

t3.xlarge EC2 tip instance se koristi za ONLYOFFICE Docs Enterprise Edition (200 konekcija). Ima sledeće parametre:

• Memorija: 16 GB
• CPU: 4 virtuelna jezgra
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

t3.2xlarge EC2 tip instance se koristi za ONLYOFFICE Docs Enterprise Edition (400 konekcija). Ima sledeće parametre:

• Memorija: 32 GB
• CPU: 8 virtuelnih jezgara
• Skladište: Samo EBS
• Mreža: Do 5 Gigabit Ethernet

Pređite na karticu Korišćenje, gde možete pronaći sledeće informacije:

• Sekcija Opcije ispunjenja prikazuje karakteristike AMI-ja. ONLYOFFICE AMI ima 64-bitnu (x86) arhitekturu.
• Sekcija Komponente šablona prikazuje AWS usluge koje se koriste za ovaj proizvod.
  • EC2 usluga pruža okruženje potrebno za postavljanje virtuelnog servera koji radi pod CentOS-om i instalaciju ONLYOFFICE softverskog rešenja na njemu.
• Uputstva za korišćenje sadrže kratke preporuke o tome kako izvršiti početnu konfiguraciju ONLYOFFICE nakon pokretanja instance.
• Ugovor o licenci za krajnjeg korisnika reguliše uslove pod kojima se pruža rešenje ONLYOFFICE Docs Enterprise Edition.

Kliknite na dugme Nastavite sa pretplatom u gornjem desnom uglu. Otvara se stranica Pretplatite se na ovaj softver:

Pročitajte AWS Ugovor sa korisnikom i kliknite na dugme Prihvati uslove. Sačekajte dok se pretplata obrađuje.

Kada se trenutni datum prikaže u polju Datum stupanja na snagu umesto 'Na čekanju', kliknite na dugme Nastavite sa konfiguracijom u gornjem desnom uglu.

Korak 2. Pokrenite vašu ONLYOFFICE instancu u AWS oblaku

Na stranici Konfigurišite ovaj softver

Na stranici, kliknite na dugme Continue to Launch u gornjem desnom uglu.

Otvara se stranica Launch this software. Na ovoj stranici možete ponovo pregledati Configuration Details.

U sekciji Choose Action možete odabrati način na koji želite da pokrenete instancu. Opcija Launch from Website je podrazumevano izabrana. Ostavite je nepromenjenu kako biste instancu pokrenuli koristeći Launch Instance Wizard koji je dostupan na ovoj web stranici.

U sekciji EC2 Instance Type dostupna je samo jedna opcija (zavisi od prethodno izabranog tipa instance ONLYOFFICE Docs Enterprise Edition sa određenim brojem dozvoljenih konekcija).

U sekcijama VPC Settings i Subnet Settings, ostavite podrazumevane postavke.

Sada treba da kreirate novu Security group i generišete Key pair.

Kreirajte novu sigurnosnu grupu

Sigurnosna grupa omogućava ograničavanje pristupa vašoj instanci tako da joj mogu pristupiti samo poznate IP adrese.

U sekciji Security Group Settings, kliknite na dugme Create New Based on Seller Settings.

Unesite ime sigurnosne grupe (na primer, ONLYOFFICE) i dodajte njen opis.

Koristite listu Source (IP or Group) da postavite potrebna pravila. Možete specificirati jednu IP adresu ili opseg IP adresa, npr. 10.040.196.230/32.

Pravila su specificirana za sledeće portove:

• SSH - port 22 se koristi za pristup vašem serveru koristeći SSH klijent preko SSH protokola.
• HTTP - port 80 se koristi za pristup vašem web ofisu preko web pretraživača putem HTTP protokola.
• HTTPS - port 443 se koristi za pristup vašem web ofisu preko web pretraživača putem sigurnog HTTPS protokola.

Kada završite, kliknite na dugme Save.

Generišite par ključeva

Par ključeva je potreban za sigurno povezivanje sa vašom instancom putem SSH protokola koristeći SSH klijent kao što su PuTTY ili OpenSSH.

U sekciji Key Pair Settings, kliknite na link Create a key pair in EC2.

AWS Management Console će se otvoriti u novoj kartici pretraživača.

Kliknite na dugme Create key pair u gornjem desnom uglu. Unesite ime para ključeva (npr. ONLYOFFICE) u odgovarajuće polje i izaberite format fajla u zavisnosti od softvera koji želite da koristite za daljinsko povezivanje sa vašom instancom:

• pem se koristi za OpenSSH
• ppk se koristi za PuTTY

Kliknite na dugme Create key pair ispod.

Vaš javni ključ će biti sačuvan u AWS EC2. Fajl .pem/.ppk koji sadrži vaš privatni ključ će biti preuzet na vaš lokalni računar i sačuvan u podrazumevani folder Downloads. Molimo vas da ga kopirate i čuvate na sigurnom mestu.

Vratite se na AWS Marketplace, osvežite polje za par ključeva koristeći ikonu sa desne strane i izaberite kreirani par ključeva iz liste.

Nakon toga, dugme Launch postaje otključano. Kliknite na Launch dugme i sačekajte dok se instanca ne implementira. Kada bude spremna, pojavljuje se poruka o uspešnoj implementaciji.

Kliknite na link EC2 Console u ovoj poruci da otvorite detalje instance u AWS Management Console.

Može potrajati neko vreme dok instanca ne postane potpuno funkcionalna nakon što je pokrenete. Uverite se da se status instance promenio iz 'pending' u 'running' u koloni Instance State, i proverite da li je instanca prošla sve statusne provere. Ove informacije su prikazane u koloni Status Checks.

Zatim se možete povezati sa vašom instancom putem SSH da omogućite test primere i proverite funkcionalnost rešenja putem web pretraživača.

Korak 3. Povežite se sa vašim serverom putem SSH

Kada instanca bude pokrenuta, možete joj pristupiti putem SSH koristeći korisničko ime centos i vaš SSH privatni ključ.

Da biste se povezali sa vašim virtuelnim serverom putem SSH, takođe ćete morati koristiti Public DNS ili IP adresu instance.

Oni se mogu pronaći u AWS Management Console. Prebacite se na sekciju Instances u levom meniju, izaberite vašu regiju (US East (N. Virginia) po podrazumevanim postavkama) i izaberite vašu ONLYOFFICE instancu na listi da otvorite detalje instance.

Kliknite na ikonu levo od Public IPv4 DNS ili Public IPv4 address na kartici Description da kopirate potrebnu vrednost u međuspremnik.

Na Windows-u možete koristiti alat PuTTY.

Privatni ključ AWS generisan prilikom postavljanja instance koristi se za autentifikaciju umesto lozinke.

Pokrenite PuTTY. U navigacionom panelu sa leve strane otvorite sekciju Connection -> SSH -> Auth. Idite na sekciju Authentication parameters -> Private key file for authentication, kliknite na dugme Browse i pronađite putanju do .ppk fajla sačuvanog na vašem lokalnom računaru.

Vratite se na sekciju Session u navigacionom panelu sa leve strane. Unesite Public DNS ili IP adresu instance u polje Host Name or IP address, uverite se da je port 22 naveden i da je tip veze SSH izabran, a zatim kliknite na dugme Open.

Zatim kliknite na Yes u prozoru PuTTY Security Alert. Unesite korisničko ime centos i pritisnite Enter.

Na Linux-u možete koristiti SSH klijent kao što je OpenSSH.

Trebaće vam da navedete putanju do .pem fajla sa vašim privatnim ključem sačuvanim na vašem lokalnom računaru, korisničko ime centos i IP adresu ili Public DNS vaše instance.

Unesite sledeću komandu u vaš terminal, navodeći stvarne vrednosti za putanju .pem fajla i IP adresu:

ssh -i /path/onlyoffice.pem centos@your_instance_ip

Unesite yes da nastavite povezivanje sa serverom. Za više informacija, možete se obratiti AWS dokumentaciji.

Da biste istražili funkcionalnost rešenja, omogućite naš test primer, koji će vam omogućiti da otpremite lokalne fajlove za testiranje. Da biste to uradili, izvršite sledeću komandu:

sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example

Dodajte primer u automatsko pokretanje:

sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Korak 4. Pristupite svom Docs Enterprise izdanju putem web pretraživača

Kada se primer pokrene, unesite http://<public IP address>/example/ u adresnu traku web pretraživača, zamenjujući <public IP address> sa javnom IP adresom ili javnim DNS-om koji je obezbedio Amazon.

Otvara se stranica sa primerom ONLYOFFICE Docs Enterprise izdanja. Ovde možete:

1. Otpremiti fajl sa vašeg računara koristeći opciju Upload file.
2. Kreirati novi prazan tekstualni dokument, tabelu, prezentaciju ili obrazac koristeći opcije Create new -> Document, Spreadsheet, Presentation, ili Form template. Ako želite da kreirate fajl sa uzorkom sadržaja, prvo označite polje With sample content.

Otpremeljeni ili kreirani fajl će se otvoriti u novoj kartici pretraživača sa odgovarajućim ONLYOFFICE Online Editorom kako biste mogli testirati mogućnosti uređivanja.

Fajl će se takođe pojaviti na listi Your documents na stranici sa primerom ONLYOFFICE Docs Enterprise izdanja.

Ako želite da proverite mogućnosti zajedničkog uređivanja, izaberite drugog test korisnika sa liste Username i zatim kliknite na isti dokument na listi Your documents da biste ga otvorili u novoj kartici pretraživača.

Da integrišete ONLYOFFICE Docs sa vašom web aplikacijom, možete se obratiti API dokumentaciji.