Betik parametreleriyle ONLYOFFICE Workspace Community kurma
Giriş
ONLYOFFICE Workspace Community, belgeleri, projeleri, müşteri ilişkilerini ve e-posta yazışmalarını tek bir yerden yönetmek için geliştirilmiş ortak çalışma sisteminin ücretsiz sürümüdür.
ONLYOFFICE Workspace Community, Docker kurulu Linux işletim sistemleri için otomatik kurulum betiğiyle sunulur. Betik, ONLYOFFICE Workspace Community'nin doğru çalışması için gereken tüm bileşenleri Docker kapsayıcıları olarak kurar; çalıştırması, yönetmesi ve güncellemesi kolaydır.
ONLYOFFICE Workspace Community kurulum betiğini indirdikten sonra, örneğin her bileşeni ayrı bir sunucuya kurmak için betiği ek parametrelerle çalıştırmanız gerekebilir. Kullanılabilir tüm betik parametrelerinin listesini görüntülemek için şu komutu kullanın:
bash workspace-install.sh -h
Bu parametrelerin kısa açıklamalarını ve bazı kullanım örneklerini aşağıda bulabilirsiniz.
Görüntü adı
| Parametre | Açıklama |
|---|---|
-ci, --communityimage | ONLYOFFICE Community Server görüntü adı |
-di, --documentimage | ONLYOFFICE Docs görüntü adı |
-mi, --mailimage | ONLYOFFICE Mail görüntü adı |
-cpi, --controlpanelimage | ONLYOFFICE Control Panel görüntü adı |
Bu parametreler, kapsayıcının hangi görüntüden başlatılacağını belirtir. Belirtilen görüntü, Docker Hub üzerindeki resmi genel depoda bulunmalıdır.
Örnek
bash workspace-install.sh -ims false -di onlyoffice/documentserver -ics true -icp true
Bu komut, depoda bulunan belirtilen ONLYOFFICE Docs görüntüsünden bir kapsayıcı çalıştırır; ayrıca ONLYOFFICE Community Server ve ONLYOFFICE Control Panel kapsayıcılarını da çalıştırır.
Bileşen sürümü
| Parametre | Açıklama |
|---|---|
-cv, --communityversion | ONLYOFFICE Community Server sürümü |
-dv, --documentversion | ONLYOFFICE Docs sürümü |
-mv, --mailversion | ONLYOFFICE Mail sürümü |
-cpv, --controlpanelversion | ONLYOFFICE Control Panel sürümü |
Bu parametreler, depodaki en son sürümü kullanmak istemiyorsanız belirli bir bileşen sürümünü kurmanızı sağlar. Varsayılan olarak her bileşen kapsayıcısını çalıştırmak için latest etiketli görüntü kullanılır.
Örnek
Docker Hub deposunu tarayıcınızda açın, bileşeni seçin ve kullanılabilir tüm etiketleri görmek için Tags sekmesine geçin. Gerekli bileşenler için kurmak istediğiniz sürümü belirtin:
bash workspace-install.sh -ics true -cv 8.9.0.150 -ids false -icp true -cpv 1.6.0.52 -ims true -md "yourdomain.com"
Bu komut ONLYOFFICE Community Server 8.9.0.150 sürümünü, ONLYOFFICE Control Panel 1.6.0.52 sürümünü ve sürümü açıkça belirtilmediği için ONLYOFFICE Mail'in en son sürümünü kurar.
Sunucu IP adresi
| Parametre | Açıklama |
|---|---|
-dip, --documentserverip | ONLYOFFICE Docs IP adresi |
-mip, --mailserverip | ONLYOFFICE Mail IP adresi |
-mdbip, --mailserverdbip | ONLYOFFICE Mail veritabanı IP adresi |
Bu parametreler, bileşenleri ayrı makinelere kuruyorsanız bileşenleri birbirine bağlamak için kullanılabilir.
Örnek
bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Bu komut, ONLYOFFICE Community Server'ı ONLYOFFICE Control Panel ile birlikte kurar ve 192.168.3.202 IP adresine sahip başka bir makineye kurulu ONLYOFFICE Docs ile bağlar.
ONLYOFFICE Mail alan adı
| Parametre | Açıklama |
|---|---|
-md, --maildomain | ONLYOFFICE Mail alan adı |
Bu parametre, ONLYOFFICE Mail için kullanılacak özel bir alan adı belirtmenizi sağlar.
Örnek
bash workspace-install.sh -md "yourdomain.com"
Bu komut, ONLYOFFICE Mail dahil tüm ONLYOFFICE Workspace Community bileşenlerini yourdomain.com alan adıyla kurar.
E-posta yazışması için kullanılacak alan adınız geçerli olmalı ve bu makine için yapılandırılmış olmalıdır. Yani DNS ayarlarında alan adınızı ONLYOFFICE Mail'in kurulu olduğu makinenin IP adresine yönlendiren uygun bir A kaydı bulunmalıdır.
Yukarıdaki komutta "yourdomain.com" parametresi ONLYOFFICE Mail için hizmet alan adı olarak anlaşılmalıdır. Bu alan adı genellikle yazışmaların yürütüleceği alan adının MX kaydında belirtilir. Kural olarak "yourdomain.com" değeri mx1.onlyoffice.com gibi görünür.
Bileşen güncelleme
| Parametre | Açıklama | Değerler | Varsayılan |
|---|---|---|---|
-u, --update | mevcut bileşenleri güncellemek için kullanın | true|false | false |
Bu parametre, makinenizde kurulu bileşenler eskiyse bunların en son sürümlerini kurar.
Örnek
bash workspace-install.sh -u true
Bu komut, güncellenmesi gereken kapsayıcıları durdurur, kaldırır ve ilgili ONLYOFFICE Workspace bileşenlerinin en son sürümlerini başlatır. Mevcut sürümü en son kullanılabilir sürümle aynı olan kapsayıcılar etkilenmez. Önceki kurulumda atlanan bileşenler de atlanır. Portal verileri otomatik olarak korunur.
Kimlik bilgileri
| Parametre | Açıklama |
|---|---|
-un, --username | dockerhub kullanıcı adı |
-p, --password | dockerhub parolası |
Bu parametreler, bir test deposuna erişmek için kimlik bilgileri verildiğinde kullanılır ve oradaki görüntülerden kapsayıcı çalıştırmanızı sağlar.
Örnek
bash workspace-install.sh -md "yourdomain.com" -un username -p password
Bileşen kurulumu
| Parametre | Açıklama | Değerler | Varsayılan |
|---|---|---|---|
-ics, --installcommunityserver | ONLYOFFICE Community Server'ı kur | true|false|pull | true |
-ids, --installdocumentserver | ONLYOFFICE Docs'u kur | true|false|pull | true |
-ims, --installmailserver | ONLYOFFICE Mail'i kur | true|false|pull | true |
-icp, --installcontrolpanel | ONLYOFFICE Control Panel'i kur | true|false|pull | true |
Bu parametreler, belirli bir bileşenin kurulup kurulmayacağını belirtmenizi sağlar. Her bileşeni ayrı bir sunucuya kurmak için kullanılabilirler.
- Bileşeni kurmak için
truedeğerini kullanın. - Bileşen kurulumunu atlamak için
falsedeğerini kullanın. - Bileşeni kurmadan indirmek için
pulldeğerini kullanın.
Örnek
bash workspace-install.sh -ims false
Bu komut, ONLYOFFICE Mail dışındaki tüm ONLYOFFICE Workspace bileşenlerini kurar.
bash workspace-install.sh -ics false -ids true -icp false -ims false -es true
Bu komut ONLYOFFICE Mail, ONLYOFFICE Community Server ve ONLYOFFICE Control Panel kurulumunu atlar ve yalnızca ONLYOFFICE Docs'u kurar.
Kurulum türü
| Parametre | Açıklama | Değerler | Varsayılan |
|---|---|---|---|
-it, --installation_type | kurulum türü | WORKSPACE|WORKSPACE_ENTERPRISE | WORKSPACE_ENTERPRISE |
Bu parametre, belirtilen çözümü kurar: ONLYOFFICE Workspace veya ONLYOFFICE Workspace Enterprise Edition.
Örnek
bash workspace-install.sh -it GROUPS
Bu komut, ONLYOFFICE Community Server ve ONLYOFFICE Control Panel bileşenlerini içeren ONLYOFFICE Workspace çözümünü kurar.
Bir bileşeni harici sunucu olarak kullanma
| Parametre | Açıklama | Değerler | Varsayılan |
|---|---|---|---|
-es, --useasexternalserver | harici sunucu olarak kullan | true|false | false |
Bu parametre, bileşenler ayrı sunuculara kurulurken kullanılır.
- ONLYOFFICE Docs ve ONLYOFFICE Mail'i ayrı makinelere kurarken
truedeğerini kullanın. - ONLYOFFICE Community Server'ı ONLYOFFICE Control Panel ile birlikte ayrı bir makineye kurarken
falsedeğerini kullanın.
Örnek
bash workspace-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true
Bu komut ONLYOFFICE Docs, ONLYOFFICE Community Server ve ONLYOFFICE Control Panel kurulumunu atlar ve yalnızca ONLYOFFICE Mail'i kurar.
bash workspace-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Bu komut, ONLYOFFICE Community Server'ı ONLYOFFICE Control Panel ile birlikte kurar ve başka bir makineye kurulu ONLYOFFICE Docs ile bağlar.
Takas dosyası oluşturma
| Parametre | Açıklama | Değerler | Varsayılan |
|---|---|---|---|
-ms, --makeswap | takas dosyası oluştur | true|false | false |
Bu parametre 6 GB'lık bir takas dosyası oluşturur. Varsayılan olarak true değeri belirtilir, bu nedenle betiği çalıştırırken bu parametreyi belirtmeniz gerekmez. Takas dosyası otomatik olarak oluşturulur.
Örnek
bash workspace-install.sh -ms false
Takas dosyası zaten varsa kurulum sırasında yenisinin oluşturulmasını önlemek için bu komutu kullanın.
Betiği -ms parametresi olmadan yeniden çalıştırırsanız betik onlyoffice_swapfile dosyasının var olup olmadığını denetler. Takas dosyası zaten varsa betik bir daha takas dosyası oluşturmaz.
MySQL sunucusu
| Parametre | Açıklama | Varsayılan |
|---|---|---|
-mysqlh, --mysqlhost | MySQL sunucusu ana bilgisayarı | localhost |
-mysqlprt, --mysqlport | MySQL sunucusu bağlantı noktası | 3306 |
-mysqlru, --mysqlrootuser | MySQL sunucusu root kullanıcısı | root |
-mysqlrp, --mysqlrootpassword | MySQL sunucusu root parolası | my-secret-pw |
Bu parametreleri açıkça belirtmezseniz varsayılan değerler kullanılır.
Örnek
bash workspace-install.sh -mysqlru root -mysqlrp new-secret-pw
Bu komut, ONLYOFFICE Workspace kurulumu sırasında MySQL root hesabı için özel bir parola belirler.
ONLYOFFICE Community Server veritabanı
| Parametre | Açıklama | Varsayılan |
|---|---|---|
-mysqld, --mysqldatabase | ONLYOFFICE Community Server veritabanı adı | onlyoffice |
-mysqlu, --mysqluser | ONLYOFFICE Community Server veritabanı kullanıcısı | onlyoffice_user |
-mysqlp, --mysqlpassword | ONLYOFFICE Community Server veritabanı parolası | onlyoffice_pass |
Bu parametreler, ONLYOFFICE Community Server veritabanını özel bir adla, ayrıca süper kullanıcı yetkilerine sahip bir hesabın kullanıcı adı ve parolasıyla oluşturmanızı sağlar. Bu parametreleri açıkça belirtmezseniz varsayılan değerler kullanılır.
Örnek
bash workspace-install.sh -mysqld communitydatabase -mysqlu username -mysqlp password
ONLYOFFICE Mail veritabanı
| Parametre | Açıklama | Varsayılan |
|---|---|---|
-mysqlmd, --mysqlmaildatabase | ONLYOFFICE Mail veritabanı adı | onlyoffice_mailserver |
-mysqlmu, --mysqlmailuser | ONLYOFFICE Mail veritabanı kullanıcısı | mail_admin |
-mysqlmp, --mysqlmailpassword | ONLYOFFICE Mail veritabanı parolası | Isadmin123 |
Bu parametreler, ONLYOFFICE Mail veritabanını özel bir adla, ayrıca oluşturulan veritabanında süper kullanıcı yetkilerine sahip bir hesabın kullanıcı adı ve parolasıyla oluşturmanızı sağlar. Bu parametreleri açıkça belirtmezseniz varsayılan değerler kullanılır.
Örnek
bash workspace-install.sh -md "mx.yourdomain.com" -mysqlmd maildatabase -mysqlmu username -mysqlmp password
ONLYOFFICE Community Server bağlantı noktası
| Parametre | Açıklama | Varsayılan |
|---|---|---|
-cp, --communityport | ONLYOFFICE Community Server bağlantı noktası | 80 |
Bu parametre, ONLYOFFICE Community Server'ın çalıştığı bağlantı noktasını değiştirir. Varsayılan bağlantı noktası 80'dir.
Örnek
bash workspace-install.sh -cp 8080
core.machinekey ayarı
| Parametre | Açıklama |
|---|---|
-mk, --machinekey | core.machinekey anahtarı ayarı |
Bu parametre, ONLYOFFICE Workspace Community kurulurken özel bir machinekey belirtmenizi sağlar.
Bu parametre /app/onlyoffice/CommunityServer/data/.private/machinekey yapılandırma dosyasına yazılır.
Örnek
bash workspace-install.sh -mk yourmachinekey
JWT gizli anahtarı ayarı
| Parametre | Açıklama |
|---|---|
-jwt, --jwtsecret | JWT gizli anahtarı ayarı |
Bu parametre, ONLYOFFICE Workspace Community kurulurken özel bir JWT gizli anahtarı belirtmenizi sağlar. Gizli anahtar, JSON web belirtecini imzalamak ve ONLYOFFICE Docs'a yapılan istekte belirteci doğrulamak için kullanılır.
Bu parametre şu yapılandırma dosyalarına yazılır (yollar kapsayıcıların içindeki yollardır):
- Community Server için -
/var/www/onlyoffice/WebStudio/web.appsettings.config - Document Server için -
/etc/onlyoffice/documentserver/local.json
Örnek
bash workspace-install.sh -jwt yoursecret