5.3.2. Sunucu kümesi yönetim sunucusu
5.3.2.1. Genel bilgiler
Sunucu kümesini yönetmek için, küme yönetim sunucusu kullanabilirsiniz. Sunucuyu (ras) ve sunucu kümesi yönetimi için kullanılan komut satırını (rac) içerir.
Şekil 76. Yönetim sunucusu
Sunucu kümesi ile yönetim sunucusu (ras) aynı sürüme sahip olmalıdır. Komut satırı yardımcı programını (rac) kullanıyorsanız, aşağıdaki kısıtlamaları göz önünde bulundurun:
- Komut satırı yardımcı programı (rac) sürüm 8.3.1 ve 8.3.2 sadece yönetim sunucusu (ras) sürüm 8.3.1 ve 8.3.2 ile birlikte kullanılabilir.
- Komut satırı yardımcı programı (rac) sürüm 8.3.3 ve 8.3.4 sadece yönetim sunucusu (ras) sürüm 8.3.3 ve 8.3.4 ile birlikte kullanılabilir.
- Komut satırı yardımcı programı (rac) sürüm 8.3.5−8.3.8 sadece yönetim sunucusu (ras) sürüm 8.3.5−8.3.8 ile birlikte kullanılabilir.
- Komut satırı yardımcı programı (rac) sürüm 8.3.9 ve üstü sadece yönetim sunucusu (ras) sürüm 8.3.9 ve üstü ile birlikte kullanılabilir. Sürümü yönetim sunucusu sürümünden daha eski olan komut satırı yardımcı programını kullanırsanız, yalnızca komut satırı yardımcı programı sürümüne karşılık gelen platformda uygulanan özellikler kullanılabilir. Belirli bir özelliğe ihtiyacınız varsa, bu özelliğin uygulandığı komut satırı yardımcı programı sürümünü kullanın (yukarıda belirtilen kısıtlamaları göz önünde bulundurarak).
Hem yönetim sunucusu hem de komut satırı yardımcı programı tüm desteklenen işletim sistemlerinde çalışabilir. Birden fazla yönetim sunucusu aynı anda tek bir sunucu kümesine bağlanabilir. Bir yönetim sunucusu yalnızca bir sunucu aracısına bağlanabilir.
Yönetim sunucusu (ras) bir uygulama, Windows servisi veya Linux hayalet programı olarak çalışabilir. Genel prosedür aşağıdaki gibidir:
- Yönetim sunucusu başlatılır (bir uygulama veya servis/hayalet program olarak).
- Komut satırı yardımcı programı gerekli eylemleri gerçekleştirmek için yönetim sunucusuna bağlanır.
- İşlemler süresince yönetim sunucusu sunucu kümesine bağlıdır. İşlemler tamamlandıktan sonra kümeyle bağlantısı kesilir. Bu nedenle, küme durdurma veya yeniden başlatma ile ilişkili planlanmış sunucu kümesi işlemleri sırasında yönetim sunucusunu durdurmaya gerek yoktur. Sunucu kümesi sürümünü değiştirmek istisnadır. Bu durumda, sunucu kümesi sürümüyle eşleşmesi için yönetim sunucusu sürümünü değiştirmeniz gerekir.
Yönetim sunucusu ile yönetim yardımcı programı 1C:Enterprise sunucusu ile birlikte yüklenir.
Yönetim sunucusu ile yönetim yardımcı programı arasındaki etkileşim için ağ bağlantı noktası 1545 kullanılır. Bu, yönetim sunucusu başlatma komut satırının (ras) --port parametresi kullanılarak yeniden tanımlanabilir.
Yönetim yardımcı programı, sunucu kümesini yönetmek için gereken tüm işlemleri gerçekleştirmenize olanak tanır. Bununla birlikte, aşağıdaki özellikler desteklenmez:
- Sunucu kümesi yöneticileri, çalışma sunucusu yöneticileri ve infobase yöneticileri için işletim sistemi kimlik doğrulaması.
Yönetim yardımcı programı (rac) tüm gerekli parametreleri komut satırından alır ve bilgileri standart çıkış akışına (stdout) gönderir. Başarılı olursa, yardımcı programın dönüş kodu 0'a eşittir. Aksi takdirde, dönüş kodu sıfır dışında bir değerdir ve standart hata akışına (stderr) bir hata mesajı gönderilir.
Yardımcı program işlemi sonucu, tablo halinde sunulan bir veya daha fazla veri nesnesinin (örneğin, kümede kayıtlı infobase sunucularının listesi) açıklamasıdır:
<Parameter name> : <Parameter value>
Her bir parametre ayrı bir satırda görüntülenir. Boş bir satır, nesne açıklamasının sonunu gösterir. <Parametre adı> yardımcı program komut satırı parametrelerinin adlarıyla eşleşir. Parametre komut satırından ayarlanamıyorsa (veya salt okunursa), adı ilgili COM nesnesinin özellik adından oluşturulur. Bunun için, özellik adındaki tüm kelimeler ve kısaltmalar küçük harfe dönüştürülür ve "-" ile ayrılır. Örneğin, MemoryExcessTime çalışma süreci özelliği memory-excess-time haline dönüştürülecektir.
Başarıyla tamamlanan küme öğesi oluşturma komutları (yöneticiler hariç) oluşturulan öğenin kimliğini yukarıda belirtilen formatta akışa gönderir.
Rastgele karakterlere izin veren dizeler çift tırnak içinde görüntülenir. Bu tür dizelerdeki mevcut çift tırnak işaretleri yinelenir.
Tarihler XML formatındadır (https://www.w3.org/TR/2012/REC-xmlschema11-2-20120405/#dateTime).
Yönetim sunucusunun (ras) veya yönetim yardımcı programının (rac) parametreleri hakkında daha fazla bilgi için help komut satırı parametresini içeren ilgili yürütülebilir dosyayı çalıştırın:
ras help rac help
ITS diski ayrıca Java arşivlerinden oluşan bir paket içerir. Konsol yönetim yardımcı programı (https://1c-dn.com/library/1c_enterprise_8_administrative_service_api/) olmadan Java dilindeki bir programdan yönetim sunucusuyla etkileşim kurmak için kullanabilirsiniz.
5.3.2.2. Yönetim sunucusunu başlatma
5.3.2.2.1. Windows'ta
Uygulama modunda
Yönetim sunucusunu uygulama modunda başlatmak için şu komut satırını kullanın:
ras cluster --port=<port> <host[:port]>
Komut aşağıdaki anahtarlara sahip olabilir:
cluster
Yönetim sunucusunu sunucu kümesi yönetim modunda başlatır.
--port veya -p
Yönetim yardımcı programının yönetim sunucusuyla etkileşim kuracağı ağ bağlantı noktasını belirtir. Varsayılan değer: 1545.
<host[:port]>
Yönetim sunucusu tarafından yönetilen sunucu kümesine ait sunucu aracısının adresini belirtir.
Sunucu aracısının adresi açıkça belirtilmemişse varsayılan değer localhost:1540'tır.
Servis modunda
Yönetim sunucusunu servis modunda başlatmak için, yönetim sunucusunu servis olarak kaydetmeniz gerekir. Bu işlem, sc yardımcı programı kullanılarak yapılabilir. Kaydı tamamlamak için yönetici yetkilerine sahip olmanız gerekir.
Sunucu hizmetinin kaydını gerçekleştiren toplu iş dosyasının bir örneğini inceleyelim.
Register-ras.bat:
@echo off rem %1 – 1C:Enterprise full version set SrvUserName=<user name> set SrvUserPwd=<user password> set CtrlPort=1540 set AgentName=localhost set RASPort=1545 set SrvcName="1C:Enterprise 8.3 Remote Server" set BinPath="\"C:\Program Files\1cv8\%1\bin\ras.exe\" cluster --service --port=%RASPort% %AgentName%:%CtrlPort%" set Description="1C:Enterprise 8.3 administration server" sc stop %SrvcName% sc delete %SrvcName% sc create %SrvcName% binPath= %BinPath% start= auto obj= %SrvUserName% password= %SrvUserPwd% displayname= %Desctiption%
Bu toplu iş dosyasını kullanmadan önce, yönetim sunucusu servisi adına çalışacak gerçek kullanıcı verilerini (ad ve şifre) belirtin (set SrvUserName= ve set SrvUserPwd= satırları). Bu toplu iş dosyası, yönetim sunucusunun kaydını aşağıdaki parametrelerle gerçekleştirir:
- Servis adı: 1C:Enterprise 8.3 Remote Server.
- Gösterilen ad: 1C:Enterprise 8.3 administration server.
- Yönetim sunucu bağlantı noktası: 1545.
- 1C:Enterprise sunucu kümesi adresi: localhost:1540.
- Servis başlatma modu: Automatic.
Örnek:
register-ras 8.3.3.100
5.3.2.2.2. Linux'ta
Uygulama modunda
Yönetim sunucusunu uygulama modunda başlatmak için şu komut satırını kullanın:
./ras cluster --port=<port> <host[:port]>
Komut aşağıdaki anahtarlara sahip olabilir:
cluster
Yönetim sunucusunu sunucu kümesi yönetim modunda başlatır.
--port veya -p
Yönetim yardımcı programının yönetim sunucusuyla etkileşim kuracağı ağ bağlantı noktasını belirtir. Varsayılan değer: 1545.
<host[:port]>
Yönetim sunucusu tarafından yönetilen sunucu kümesine ait sunucu aracısının adresini belirtir.
Sunucu aracısının adresi açıkça belirtilmemişse varsayılan değer localhost:1540'tır.
Hayalet program modunda
Yönetim sunucusunu (ras) hayalet program modunda başlatmak için, özel bir komut satırı anahtarı kullanmanız gerekir:
./ras cluster --daemon --port=<port> <host[:port]>
Yönetim sunucusunu (ras) başlatmaya yönelik komut satırı anahtarları Windows'ta ve Linux'ta aynıdır.