PAW Kurulum

Hedef kitle: Orkestratör sunucusunu kuran ve güncelleyen sistem yöneticileri Ön koşullar: Sunucuda yönetici yetkisi, RPA WORK Portal API erişimi (Client ID ve Client Secret)


Genel Bakış

PAW Kurulum (PAW Setup), Orkestratör'ü bir Windows sunucusuna kuran ve güncelleyen masaüstü uygulamasıdır. RPA WORK Portal'daki API erişiminizle bağlanır, ortamınızın bilgilerini portaldan alır, Orkestratör'ün web uygulamalarını IIS'e kurar ve yeni sürüm paketlerini portaldan indirip yükler.

Orkestratör altı uygulamadan oluşur; ortamda hangilerinin kurulacağını portal belirler:

Uygulama

Varsayılan site adı

Varsayılan port

Backend Api

paw.api.backend

7724

Resource Api

paw.api.resource

7723

Shared Api

paw.api.shared

7722

Ui Api

paw.api.ui

7721

Bp Api (Blue Prism)

paw.api.bp

7725

Ui (web arayüzü)

paw.ui

80

Backend için ayrıca PAW Backend Service - <ortam adı> adlı bir Windows hizmeti kurulur.

Bu sayfada öğrenecekleriniz:

  • Ön koşullar ve ilk kurulum adımları

  • API erişimi ve ortamı açma

  • Ortam ayarları ve düzenleme

  • Sürüm yükleme ve uygulama yayınlama

  • Bakım işlemleri, ortamı kaldırma ve ayarların saklandığı yer


Ön Koşullar

Koşul

Açıklama

Yönetici yetkisi

PAW Kurulum her açılışta yönetici izni (UAC) ister.

IIS

Web Sunucusu (IIS) ve Uygulama Geliştirme altındaki Application Initialization ile WebSocket Protocol rolleri etkin olmalıdır; değilse yayınlama ve kurulum durur.

Veritabanı ve servisler

SQL Server, Elasticsearch ve Ui kuruluyorsa Redis sunucuya erişilebilir olmalıdır.

Sertifika

https kullanılacaksa sertifika sunucunun Kişisel (My) ya da Web Barındırma (WebHosting) deposunda olmalıdır.

İnternet

Portal'a (https://api.rpa.work) erişim: kimlik doğrulama, ortam bilgisi ve sürüm paketleri buradan gelir.

PAW Kurulum'un kurulum paketi .NET Desktop Runtime'ı gerekirse kendisi kurar.


İlk Kurulum

  1. PAW Kurulum'u açın ve yönetici iznini onaylayın.

  2. Client ID ve Client Secret'ı girip Kimlik Bilgilerini Doğrula'ya tıklayın.

  3. Ortamı Aç ile ortamı portaldaki bilgilerden oluşturun.

  4. Düzenle ile veritabanı, Elasticsearch ve (Ui varsa) Redis bilgilerini girip Kaydet'e tıklayın. Yeni ortamda bu bilgiler boştur; doldurulmadan kurulum yapılamaz.

  5. Sürüm Yükle sayfasında Güncellemeleri Denetle, Tümünü indir ve Sürümleri Yükle ile Orkestratör'ü kurun.

  6. Bağlantı Test Et ve Api Url Test Et ile kurulumu doğrulayın.

  7. Gerekirse Lisans İçe Aktar ile lisans dosyasını yükleyin.


Giriş Ekranı (API Erişimi)

Kullanıcı adı ve şifreyle giriş yoktur; uygulama portal API erişimiyle çalışır.

Öğe

Açıklama

API Erişimi

Birden çok erişim kayıtlıysa görünür; etkin erişimi seçer. Öğeler "Şirket - Ortam" adıyla listelenir, Filtre kutusuyla aranır. Hiçbir erişime bağlı olmayan yerel ortamlar listenin sonundadır.

Client ID

Portaldaki API erişiminin kimliği (GUID). Kayıtlı erişimde salt okunurdur.

Client Secret

Yalnızca yeni erişim eklerken ya da kimlik bilgilerini değiştirirken görünür.

Kimlik Bilgilerini Doğrula

Bilgileri portalda doğrular ve kaydeder. Ortam bu adımda oluşmaz.

Kimlik Bilgilerini Değiştir (kalem)

Yeni Client ID / Client Secret girmek için formu açar; yenisi doğrulanana kadar eskisi geçerlidir.

API Erişimi Ekle

Başka bir portal ortamı için ikinci bir erişim ekler; diğer erişimler korunur.

API Erişimini Kaldır (çöp kutusu)

Seçili erişimi bu makineden kaldırır (aşağıda).

Beta sürümleri dahil et

Portal bu erişime beta izni verdiyse görünür; seçiliyse PAW Kurulum ve ürün paketleri beta kanalından denetlenir.

Ortamı Aç

Etkin erişimin ortamını portaldan günceller ve Ortam Detayı'nı açar.

Güncellemeleri Denetle

Yalnızca PAW Kurulum'un kendi güncellemesini denetler; varsa İndir ve kur ile kurulur ve uygulama yeniden başlar.

Doğrulamada karşılaşılabilecek mesajlar: "Client ID geçerli değil.", "Portal API’ye ulaşılamadı. URL ve ağ bağlantısını kontrol edin.", "Portal kimlik doğrulaması başarısız oldu.", "Bu API erişimine portalda lisans bağlanmamış.", "Bu API erişimi için portalda ortam (Production / Development) seçilmemiş.", "Bu API erişimine bağlı lisans iptal edilmiş."

Ortamı Aç

Ortamın adı ve kurulacak uygulamalar portaldan gelir. Yeni ortamda site adları, portlar, wwwroot yolu ve URL'ler portalın varsayılanlarıyla doldurulur. Var olan ortamda yalnızca sizin değiştirmediğiniz alanlar portal değerleriyle güncellenir.

Makinede hiçbir erişime bağlı olmayan tek bir yerel ortam varsa Ortamı Devral sorulur: Evet derseniz o ortamın ayarları yeni adla bu erişime bağlanır, Hayır derseniz yeni bir ortam oluşturulur.


Ortam Detayı

Ortamın ayarları salt okunur kartlarda gösterilir. Üstteki şerit düğmeleri:

Düğme

Ne yapar

Düzenle

Ortam Düzenleme sayfasını açar. https kullanan bir uygulamanın sertifikası yenilenmişse önce yeni sertifikayı seçmeyi önerir (Sertifika Yenilendi).

Api Url Test Et

Her API'nin /api/Version adresine istek atar ve dönen sürümü gösterir. Alt menüden tek API seçilebilir.

Bağlantı Test Et

SQL, Elasticsearch ve Ui Redis bağlantılarını dener; alt menüden tek bağlantı seçilebilir.

Uygulama Yayınla

Ayarları IIS'e uygular (aşağıda). Alt menüden tek uygulama seçilebilir.

Sürüm Yükle

Sürüm Yükle sayfasını açar.

Redis Önbelleğini Temizle

Ui Redis'teki yapılandırılmış veritabanını onay sormadan tamamen boşaltır.

Hangfire Başlat

Backend Api'de zamanlanmış işleri (Hangfire) başlatır.

Lisans İçe Aktar

.lic lisans dosyasını seçtirir, lisanstaki şirketin lisans anahtarını veritabanında günceller ve Redis önbelleğini temizler.

Script Çalıştır

RPA WORK'ün verdiği şifreli .pscr SQL betiğini ortamın veritabanında çalıştırır.

Kartlar: Genel Yapılandırma, Elasticsearch Yapılandırması, her uygulama için <Uygulama> Yapılandırması, BP Url Yapılandırması, Ui Yapılandırması ve Ui Redis Yapılandırması. Parolalar gösterilmez. Geri giriş ekranına döner.


Ortam Düzenleme

Uygulamaları Düzenle ile ortamdaki uygulamaları açıp kapatırsınız (en az biri açık kalmalıdır); Kaydet ayarları saklar. Geri kaydedilmemiş değişiklikleri onay sorarak atar. Zorunlu alan boşsa alanın yanında uyarı çıkar.

Genel Yapılandırma

Alan

Zorunlu

Açıklama

Kimlik Doğrulama

Evet

SQL Server Authentication ya da Windows Authentication.

Veri Kaynağı

Evet

SQL Server sunucu ve örnek adı.

Veritabanı Adı

Evet

Orkestratör veritabanı.

Kullanıcı Adı / Şifre

Evet

SQL Server Authentication'da SQL kullanıcısı. Windows Authentication'da IIS uygulama havuzlarının çalışacağı Windows hesabı; veritabanına bu hesapla bağlanılır.

Ek SQL Bağlantı Parametreleri

Hayır

Varsayılan MultipleActiveResultSets=True;TrustServerCertificate=True.

wwwroot Yolu

Evet

Varsayılan C:\inetpub\wwwroot\. Her uygulamanın klasörü bu yolun altında site adıyla açılır.

Elasticsearch Yapılandırması

Elastic Search Sunucusu (ör. http://sunucu:9200/), Elastic Search Kullanıcı Adı ve Elastic Search Parola zorunludur. API'lerin hata logları bu sunucuya yazılır.

Uygulama kartları

Her açık uygulama için:

Alan

Zorunlu

Açıklama

Site Adı

Evet

IIS site ve uygulama havuzu adı, wwwroot altındaki klasör adı.

Maksimum İşçi Süreçleri

Evet

Uygulama havuzunun işçi süreci sayısı. Varsayılan 1.

Bağlantı Protokolü

Evet

http ya da https. https seçilince port 443 olur.

IP Adresi

Evet

* (tüm atanmamış) ya da bir IP adresi.

Port

Evet

Varsayılanlar yukarıdaki tabloda.

Sunucu Adı

Hayır

IIS bağlamasındaki ana bilgisayar adı.

Sertifika Parmak İzi

https'te evet

Makinedeki sertifikalardan seçilir; süresi dolmuş olanlar işaretlidir.

Sunucu Adı Gösterimi Gerekli

https'te evet

True ise bağlama SNI ile yapılır.

Ui kartında ayrıca Ui Api Url (zorunlu), Recaptcha Site Anahtarı, Recaptcha Gizli Anahtar ve Şirket Logosu Stili vardır. BP Url Yapılandırması'ndaki Bp Api Url, Blue Prism entegrasyonu için Backend Api ve Ui Api ayarlarına yazılır. URL'lerin sonu kaydederken /api/ ile tamamlanır.

Ui Redis Yapılandırması

Ui Redis Sunucusu, Ui Redis Port, Ui Redis Parola ve Ui Redis Veritabanı Numarası zorunludur; Ui Redis Servis Adı isteğe bağlıdır. + ile toplam beş sunucuya kadar ek sunucu satırı eklenir.

Kaydet

  • Kapatılan bir uygulama IIS'te kuruluysa, bu uygulamaların da kaldırılıp kaldırılmayacağı sorulur. Evet derseniz IIS sitesi, uygulama havuzu ve klasörü silinir.

  • Aynı sunucu adı ve port iki uygulamada kullanılamaz; başka bir API erişiminin ortamındaki site adları ve bağlamalarla da çakışamaz.

  • Site adı değiştiyse IIS sitesi, havuzu ve klasörü yeni ada taşınır. Port, IP ve protokol değişiklikleri IIS'e Uygulama Yayınla ile uygulanır.

  • Ayarlar (parolalar hariç) portala bildirilir; bildirilemezse Ortam Detayı'nda uyarı çıkar.


Sürüm Yükle

Sayfa açılınca portaldaki son sürümler okunur. Her ürün için bir kart vardır: Orchestration her zaman, Resource ve Robot Resource Api kuruluysa. Kartta Kurulu, İndirilen ve Son sürüm bilgileri ve durum görünür: Kurulu değil, Güncel, Güncelleme var ya da Paket yayınlanmamış.

Düğme

Ne yapar

Güncellemeleri Denetle

Önce PAW Kurulum'un güncellemesini denetler; varsa ürün paketlerinden önce onun kurulmasını ister. Sonra ürünlerin son sürümlerini okur.

Tümünü indir (ya da karttaki indir simgesi)

Güncellemesi olan paketleri, mevcut ve indirilecek sürümü ve boyutu gösterip onay alarak indirir.

Sürümleri Yükle

Son paketler indirildiyse etkinleşir; yüklenecek uygulamaları gösterip onay alır ve kurulumu başlatır.

Resource / Robot güncellemesini yayınla

Orchestrator güncelken yalnızca yeni Resource/Robot paketleri indirildiyse Sürümleri Yükle'nin yerinde çıkar; Orkestratör'ü yeniden kurmadan Resource Api'yi yayınlar.

⚠️ Dikkat: Kurulum, bütün şirketlerdeki etkin Production makinelerini kurulum boyunca devre dışı bırakır ve çalışan makinelerin durmasını bekler. Kurulumu iş yükünün az olduğu bir zamanda yapın.

Kurulum adımları:

  1. Kurulum hazırlanır, üretim kaynakları devre dışı bırakılır.

  2. Üretim kaynaklarının durması beklenir. Üretim makineleri listesinde her makinenin durumu ve hazır makine sayısı görünür; 5 dakika sinyal vermeyen makine hazır sayılır. 30 dakika sonra Kaynaklar hâlâ çalışıyor sorulur: Yine de devam et, Beklemeye devam et ya da İptal.

  3. Sunucu rolleri, Redis ve Elasticsearch bağlantıları denetlenir; PAW Windows hizmeti durdurulup kaldırılır; sürüm dosyaları çıkarılır.

  4. Siteler bakım sayfasına alınır ("We’ll be back soon!"), uygulamalar kurulur (eski klasör <site adı>.old olarak saklanır) ve yapılandırma IIS'e yayınlanır.

  5. UI Redis önbelleği temizlenir, bakım sayfası kaldırılır, Elasticsearch log indeksleri silinip yeniden oluşturulur, Hangfire başlatılır.

  6. Üretim kaynakları yeniden etkinleştirilir ve kurulan sürüm portala bildirilir.

Kurulum sırasında bir adım başarısız olursa hata ve aşama gösterilir; Yeniden dene ya da İptal seçilir. Dosyalar değiştikten sonraki bir adımda hata olursa siteler bakım sayfasında kalır. İptal ederken makineler devre dışıysa hemen etkinleştirmek ya da devre dışı bırakmak seçilir. Önceki bir kurulumdan "güncelleniyor" olarak kalan makineler için sayfada uyarı ve Makineleri etkinleştir düğmesi çıkar.


Uygulama Yayınla

Uygulama Yayınla dosya kopyalamaz; uygulama dosyalarını Sürüm Yükle kurar. Yayınlama onay sormadan şunları yapar:

  1. IIS sitesini ve uygulama havuzunu siler (klasör kalır).

  2. Site klasörüne ortam ayarlarını (environmentsettings.json, şifreli veritabanı bağlantısıyla) ve log ayarlarını (nlog.config) yazar.

  3. Ui için şirket logosunu giriş sayfasına kopyalar.

  4. Backend Api için Hangfire iş kuyruğu tablolarını boşaltır ve PAW Backend Service - <ortam adı> hizmetini yeniden kurup başlatır.

  5. Resource Api için indirilen Resource ve Robot paketlerini dağıtıma hazırlar; PAW Kaynak makineleri güncellemeyi buradan alır.

  6. Uygulama havuzunu ve siteyi ayarlara göre yeniden oluşturur (her zaman çalışır, boşta kapanmaz, önyüklemeli).

Klasör yoksa "Yolu mevcut değil" hatası çıkar; önce Sürüm Yükle ile kurulum yapılmalıdır.


API Erişimini ve Ortamı Kaldırma

Giriş ekranındaki API Erişimini Kaldır seçili erişimi bu makineden kaldırır. Erişime bağlı bir ortam varsa ortamı da kaldır kutusu çıkar (varsayılan işaretli):

  • Kutu işaretli değilse yalnızca erişim kaldırılır; ortamın dosyaları, IIS siteleri ve hizmeti kalır. Aynı kimlik bilgileri yeniden eklenince ortam yeniden bağlanır.

  • Kutu işaretliyse ikinci bir onayda silinecekler listelenir: IIS siteleri ve uygulama havuzları, site klasörleri, Windows hizmeti ve klasörü, ortam ayarları. Bu işlem geri alınamaz. Veritabanları, sertifikalar ve Resource/Robot kurulumları silinmez; başka ortamların da kullandığı siteler korunur.


Ayarların Saklandığı Yer

Ne

Nerede

Ortam ayarları (her ortam bir dosya)

C:\ProgramData\RPA WORK\PAW Setup\Configuration\<ortam adı>.json

API erişimleri

C:\ProgramData\RPA WORK\PAW Setup\Configuration\portal.json

İndirilen sürüm paketleri

C:\ProgramData\RPA WORK\PAW Setup\Version\

Backend hizmetinin dosyaları

C:\ProgramData\RPA WORK\PAW Setup\Services\<ortam adı>\

Uygulama ayarları

<wwwroot yolu>\<site adı>\environmentsettings.json ve nlog.config

Ortam ve erişim dosyaları makineye bağlı bir anahtarla şifrelenir; başka bir makineye kopyalanınca açılmaz. Dil ve tema seçimi kullanıcı başına saklanır.