APPENDICI > Installazione via Automation Console

L’intera installazione è eseguita attraverso i commandlet PowerShell messi a disposizione dalla IrionEDM Automation Console. Si noti che, i parametri utilizzati nei commandlet e gli argomenti ad essi associati, sono solo un sottoinsieme di quelli offerti dalla piattaforma e rappresentano, pertanto, una casistica di installazione di base. Per l’elenco completo dei commandlet e dei parametri ad essi associati, si rimanda al manuale di IrionEDM.

Le operazioni di seguito illustrate si riconducono a procedure che è possibile automatizzare completamente.

Per soddisfare esigenze particolari, quali ad esempio la distribuzione su larga scala dell’applicativo (tramite Microsoft SMS o simili), sono disponibili per ogni specifica release, i dettagli dei files da copiare, registri per componenti COM, files di configurazione e script di database.

È da notare che il sottoinsieme di script di aggiornamento da eseguire dipende dalla versione originale del database. Il setup ed i comandi di Admin effettuano automaticamente questa selezione.

L’amministrazione del sistema avviene tramite cmdlet Powershell e consente di eseguire operazioni di gestione dei Catalog. Le funzioni preminenti sono:

✓ Attività amministrative dell’installazione

✓ Installazione/Upgrade dei database di Catalog

✓ Configurazione dei servizi

✓ Gestione licenze e privilegi

✓ Attività di Deploy delle solution

✓ Export ed Import di oggetti del Catalog

✓ Modifica delle configurazioni

✓ Gestione dei permessi

Tramite questi comandi si può inoltre predisporre l’integrazione con eventuali sistemi già disponibili per gestire il change management, processi di deployment, backup, disaster recovery ecc.

Presentiamo di seguito i comandi necessari all’installazione. Prerequisito essenziale è la conoscenza di Windows Powershell come shell di esecuzione dei comandi.

Per un'introduzione all'uso della Powershell in IrionEDM, si veda il paragrafo relativo alla IrionEDM Automation Console.

L’installazione è divisa in due fasi: Setup e Configurazione.

La procedura di Setup crea il folder di installazione e vi copia dentro tutti i file, le cartelle e registra i componenti necessari al funzionamento del software. L’operazione è eseguita attraverso il seguente comando:

& 'IrionDQ 2016 Setup.exe' /install /installlocation <installatonPath> /instance <IDQinstanceName> /quiet

La fase di Configurazione riguarda la creazione del Catalog IrionEDM , l’installazione dei servizi Controller, Agent e WebApi e la loro corretta integrazione al catalogo.

Gli step da eseguire per una configurazione standard sono i seguenti:

1. Installazione del Catalog IrionEDM . Effettuato attraverso il comando:

New-IDQCatalog -Server <dbServer> -Instance <instanceName> -Name <catalogName> -ExecutionCredential <pscredential> -DboCredential <pscredential>

2. Registrazione del Catalog IrionEDM sulla Catalog List. Effettuato attraverso il comando:

3. Importazione della licenza per il Catalog IrionEDM . Effettuato attraverso il comando:

Import-IDQLicense -Catalog <string> -Filename <string>

4. Installazione e avvio dei servizio Controller e registrazione del Catalog IrionEDM . Effettuato attraverso il comando:

Install-IDQControllerService -Catalogs <string> -Port <int> –Start -StartMode Automatic -Credential <pscredential>

5. Installazione e avvio dei servizio Agent. Effettuato attraverso il comando:

Install-IDQWorkflowAgentService -LogonProvider Default -LogonType Interactive -LoadUserProfile -Port <int> –Start -StartMode Automatic -Credential <pscredential>

6.Registrazione dell’Agent sul Catalog IrionEDM . Effettuato attraverso il comando:

7. Registrazione del Web Repository sul Catalog IrionEDM e installazione del servizio Web Api. Effettuato attraverso i comandi:

Install-IDQWebApiServer -Catalog <string> -LogicalService <string> -ServerName <string> -Prefix <string> -Port <int> –Start -StartMode Automatic -Credential <pscredential>

8. Ulteriore step facoltativo, nel caso la relativa licenza lo preveda, riguarda la possibilità di inserire utenze named tra quelle che possiedono i permessi per accedere al Catalog IrionEDM . Lo step è manuale ed è eseguibile tramite UI IrionEDM Administrator.

N.B. Affinché venga garantita la corretta esecuzione di tutti i commandlet, è indispensabile possedere i necessari permessi sulle directory di sistema intaccate dalla procedura di aggiornamento.

Inoltre, per garantirne il funzionamento, tali commandlet devono essere eseguiti all’interno della IrionEDM Automation Library, o di una shell Windows PowerShell in cui sia stato precedentemente Importato il modulo AutomationImportModule.ps1 presente nella directory di installazione di IrionEDM.

Viene proposta di seguito una tabella riepilogativa dell’esecuzione degli step per ciascun tipo di Server dell’infrastruttura di IrionEDM 2016.

A seconda della configurazione adottata è possibile che più di un Server risieda sulla stessa macchina fisica.

	Controller Server	Workflow Server	Web Api Server	Client
Setup	X	X	X	X
Configurazione Step 1	O	O	O	O
Configurazione Step 2	X	X	X	X
Configurazione Step 3	O	O	O	O
Configurazione Step 4	X
Configurazione Step 5		X
Configurazione Step 6	O	O	O	O
Configurazione Step 7			X
Configurazione Step 8				X

Legenda:

X: Da eseguire necessariamente sulla macchina
O: Da eseguire una volta sola su una qualsiasi delle macchine

La generazione dell’oggetto pscredential, argomento del parametro –Credential, è effettuato attraverso la seguente procedura powershell standard:

$mypassword = ConvertTo-SecureString "LaMiaPassword" -AsPlainText -Force

$mypscredential = New-Object System.Management.Automation.PSCredential("myusername", $mypassword)