Repozytorium – instalacja dla administratora

• • • Comarch DMS Workflow (Obieg Dokumentów)
    • Comarch DMS Repozytorium

• wpisać instrukcję use admin na konsoli _MONGOSH BETA, zatwierdzić przyciskiem Enter
• wprowadzić na konsoli _MONGOSH BETA następujące polecenie:

db.createUser(
{
user:"admin",
pwd:"Passwd1234",
roles:[{role:"root",db:"admin"}] }
)

• zatwierdzić klawiszem Enter

• wpisać instrukcję use Repository na konsoli _MONGOSH BETA, zatwierdzić przyciskiem Enter
• wprowadzić na konsoli _MONGOSH BETA następujące polecenie, aby dodać użytkownika:

db.createUser(
{
user:"MongoUser",
pwd:"Passwd1234",
roles:[{role:"readWrite",db:"Repository"}] }
)

• w sekcji #network interfaces:

port: 27017 – port domyślny

bindIp: 127.0.0.1 – domyślnie jest w tym miejscu ustawiony localhost – tu powinien być umieszczony adres IP klienta, który komunikuje się z serwerem bazodanowym (dla Comarch DMS Repozytorium: z serwerem IIS).      Jeżeli  zamiast bindIp zostanie wpisane bindIpAll: true,  wówczas można będzie połączyć się z serwerem z każdego komputera.

• w sekcji #security:

Dzięki tej zmianie możliwe będzie logowanie do bazy MongoDB przy użyciu loginu i hasła.

Następnie należy zapisać plik i uruchomić ponownie serwer MongoDB w Menedżerze zadań Windows, klikając na niego prawym przyciskiem myszy i naciskając „Uruchom ponownie”.

Instalacja serwera MongoDB w systemie Linux, dystrybucja Ubuntu

Instalacja serwera MongoDB na Ubunt powinna zostać przeprowadzona według instrukcji producenta, do której można przejść za pomocą następującego linku: Install MongoDB Community Edition on Ubuntu — MongoDB Manual.

Wprowadzanie zmian w pliku mongod.conf

Kiedy zainstalowano serwer, kolejnym krokiem jest wprowadzenie zmian w pliku konfiguracyjnym mongod.conf, dostępnym w lokalizacji: /etc/mongod.conf. Polecenie, które uruchamia plik mongod.conf do edycji, to:

sudo gedit/etc/mongod.conf

Zmiany, których należy dokonać w pliku mongod.conf:

• w sekcji #network interfaces:

port: 27017 - port domyślny

bindIp: 127.0.0.1 - domyślnie jest w tym miejscu ustawiony localhost - tu powinien być umieszczony adres IP      klienta, który komunikuje się z serwerem bazodanowym (dla Comarch DMS Repozytorium: z serwerem IIS).      Jeżeli  zamiast bindIp zostanie wpisane bindIpAll: true,  wówczas można będzie połączyć się z serwerem z  każdego komputera.

• w sekcji #security:

Dzięki tej zmianie możliwe będzie logowanie do bazy MongoDB przy użyciu loginu i hasła.

Po zapisaniu wprowadzonych zmian należy ponownie uruchomić serwer MongoDB, przykładowo używając poniższej komendy:

sudo systemctl restart mongod

Dodawanie administratora MongoDB i bazy danych dla Comarch DMS Repozytorium z poziomu terminala w Ubuntu

Następnie należy zalogować się do MongoDB z poziomu terminala w Ubuntu,  a później utworzyć bazę danych i dodać operatora, dla którego nastąpi łączenie się Comarch DMS Repozytorium z bazą danych.

Aby utworzyć bazę, powinna zostać wpisana komenda: use Repository.

W dalszej kolejności należy utworzyć użytkownika, zaczynając od wpisania komendy use admin. Później konieczne jest wprowadzenie polecenia, które utworzy użytkownika o uprawnieniach administratora na serwerze - w poniższym przykładzie taki użytkownik to admin, zaś jego hasło to Passwd1234. Posiada najwyższy poziom uprawnień na serwerze:

db.createUser(
{
user:"admin",
pwd:"Passwd1234",
roles:[{role:"root",db:"admin"}] }
)

Następnie należy dodać użytkownika, dla którego będzie następowało łączenie się aplikacji Comarch DMS Repozytorium z bazą danych. W tym celu konieczne jest wprowadzenie następującego polecenia:

db.createUser(
{
user:"MongoUser",
pwd:"Passwd1234",
roles:[{role:"readWrite",db:"Repository"}] }
)

Tworzenie i odtwarzanie backupów bazy danych MongoDB

Backupy baz danych Mongo DB mogą być tworzone i odtwarzane za pomocą narzędzi mongodump oraz mongorestore, które należą do MongoDB Database Tools. Można je pobrać ze strony producenta:

Download MongoDB Command Line Database Tools | MongoDB

Z dokumentacją dotyczącą narzędzi do tworzenia i odtwarzania baz MongoDB można się zapoznać na stronie producenta: The MongoDB Database Tools Documentation — MongoDB Database Tools.

Konfiguracja aplikacji na serwerze IIS

Instalacja komponentów

Zanim rozpocznie się konfigurację aplikacji Comarch DMS na serwerze IIS, konieczne jest zainstalowanie dwóch komponentów, niezbędnych do poprawnego działania aplikacji:

• URL Rewrite - do pobrania poprzez link: URL Rewrite : The Official Microsoft IIS Site
• ASP.NET Core 3.1 Runtime - Windows Hosting Bundle Installer - do pobrania poprzez link: Download ASP.NET Core 3.1 Runtime (v3.1.14) - Windows Hosting Bundle Installer (microsoft.com)

• DocumentManager.WebApi
• DocumentManager.WebClient

• <add key=”UseRepository” value=”true” /> – umożliwiający włączenie Repozytorium poprzez wpisanie wartości „true” (jeżeli pozostanie „false”, włączony będzie Manager dokumentów)
• <add key=”RepositoryUrl” value=”http://<ip serwera>/DocumentManager.WebApi” /> – w tym kluczu konieczne jest wprowadzenie adresu URL aplikacji DocumentManager.WebApi, przykładowo:

     http://localhost/DocumentManager.WebApi

• <add key=”RepositoryClientUrl” value=”http://<ip serwera>/DocumentManager.WebClient” /> – w tym kluczu konieczne jest wprowadzenie adresu URL aplikacji DocumentManager.WebClient, przykładowo:

.        http://localhost/DocumentManager.WebClient

• „IdentityMongoDatabaseSettings” – connection string do bazy Comarch DMS Repozytorium, która zawiera konta użytkowników.

• „ApplicationMongoDatabaseSettings” – connection string do bazy Comarch DMS Repozytorium, która zawiera dane aplikacji. Przykładowo:

„mongodb://MongoUser:Passwd1234@localhost:27017/Repository?authSource=Repository”

• „DocumentWorkflowSettings” – adres serwera DMS. Przykładowo:

„http://localhost/Standalone”

• ”StorageSettings” – ustawienia bazy, która przechowuje pliki

„Type” – właściwość, która określa domyślne miejsce przechowywania plików  dodawanych do Comarch DMS  Repozytorium. Może przyjmować wartości:

„IBard” – wtedy pliki dodawane do Repozytorium będą przechowywane   w usłudze Comarch IBARD

„Mongo” – wtedy pliki dodawane do Repozytorium będą przechowywane w bazie MongoDB

• ”IBARDStorageSettings” – parametr uzupełniany, jeśli wybrano bazę IBARD, baza danych, która przechowuje dane wymagane dla IBARD

„ConnectionString” – connection string do bazy z konfiguracją współpracy z IBARD – znajduje się tu ta sama informacja, która w wersji poprzedniej była w IBARDMongoDatabase Settings

Uwaga

W przypadku przechowywania plików z Repozytorium w usłudze IBARD po uzupełnieniu „Connection String” w „IBARDStorageSettings” konieczne jest zalogowanie  do usługi IBARD w sekcji „Przechowywanie plików” w zakładce „Ustawienia” w aplikacji desktop Comarch DMS, klikając przycisk „Autoryzacja”.

 

Przykład uzupełnienia pliku appsettings.json, jeśli wszystkie pliki mają być przechowywane  w usłudze  Comarch IBARD:

• ”MongoStorageSettings” – parametr uzupełniany, jeśli wybrano bazę MongoDB, baza danych, która przechowuje pliki binarne.  W tym parametrze należy uzupełnić „ConnectionString” do  bazy, która będzie służyć do przechowywania plików dodawanych do Comarch DMS Repozytorium. Drugi klucz, ”ChunkSizeBytes”, dotyczy tylko plików przechowywanych w bazie MongoDB, definiuje maksymalny rozmiar pojedynczej części pliku (w bajtach), który jest dodawany do bazy.

Przykład uzupełnienia pliku appsettings.json, jeśli wszystkie pliki mają być przechowywane  w bazie MongoDB:

Możliwa jest również sytuacja, w której podczas pracy z Comarch DMS Repozytorium zostało zmienione miejsce przechowywania plików z usługi IBARD na bazę MongoDB – wtedy możliwe jest korzystanie z plików przechowywanych zarówno w IBARD, jak i w MongoDB. Warunkiem jest uzupełnienie „Connection String”  w kluczu „IBARDStorageSettings” (tak, żeby następowało połączenie z bazą, która przechowuje konfigurację współpracy z IBARD) oraz „Connection String”  w kluczu „MongoStorageSettings” (tak, żeby następowało połączenie z bazą, która przechowuje pliki). Przy takim uzupełnieniu connection stringów domyślnie pliki, które zostaną dodane do Comarch DMS Repozytorium, będą zapisane zgodnie z lokalizacją, którą określono w parametrze Type w sekcji Storage Settings. 

Przykład uzupełnienia pliku appsettings.json, jeśli  pliki mają być zapisywane  w bazie MongoDB, ale możliwa również będzie praca z plikami, które są przechowywane w usłudze IBARD:

• „AllowedOrigins” – adres witryny Comarch DMS Repozytorium, przykładowo http://<IP serwera>

• „JWTSettings” – ustawienia JSON Web Tokens, autoryzacja użytkowników wewnątrz Comarch DMS Repozytorium. Zawiera następujące parametry:

„Key” – klucz szyfrujący,

„Issuer”:”CorelIdentity”,

„Audience”: „CorelIdentityUser”,

„DurationInMinutes”: 60 – czas, po jakim token autoryzujący wygaśnie; podany w minutach

• „Serilog” – framework logujący działanie aplikacji. Zawiera następujące parametry:

„MinimumLevel” –  określa poziom szczegółowości loga

„Default”: „Information” –  definiuje domyślny poziom

„Override” – określa szczegółowe ustawienia logów dla paczek Microsoft oraz System, zapisywanie informacji na poziomie warning i wyżej, czyli error, fatal error.

• „Enrich”: [ „FromLogContext”, „WithMachineName”, „WithProcessId”, „WithThreadId” ] – określa schemat wpisów do dziennika logów. Zawiera następujące parametry:

„WriteTo” – definicja logów „Name”: „Console” – logi do konsoli „Name”: „File” – logi do pliku w formacie txt
„path”: „C:\\temp\\repository.txt” – lokalizacja w której będzie zapisywany log
„outputTemplate”: „{Timestamp:G} {Message}{NewLine:1}{Exception:1}” – format logów „Name”: „File” – logi do pliku w formacie json
„path”: „C:\\temp\\repository.json” – lokalizacja w której będzie zapisywany log
„formatter”: „Serilog.Formatting.Json.JsonFormatter, Serilog”