Requisiti minimi necessari per il corretto funzionamento di Comarch POS e Comarch POS Agent (su dispositivi separati):

• Sistema operativo Microsoft Windows 8.1/10
• Processore Intel Core i3/i5/i7 4th Gen, AMD Ryzen 5 o di una classe simile (Risultato CPU benchmark almeno 3000 pt. per garantire una reazione accettabile)
• 6 GB memoria RAM
• Microsoft .NET Framework 4.7.2
• Microsoft SQL Server 2014 in versione Express o superiore
• Collation Latin1_General_CI_A

Per le installazioni dove Comarch POS e Comarch POS Agent si trovano sullo stesso dispositivo, bisogna garantire (rispetto ai suddetti requisiti)

• Processore migliore, almeno Intel Core i5
• 8 GB memoria RAM o di più

Nota

Bisogna includere:

• requisiti minimi del sistema Microsoft Windows
• requisiti minimi del sistema Microsoft SQL Server

a seconda di quanto la postazione sia caricata da altri programmi e del numero di operazioni eseguite

Durante l’installazione dell’applicazione Comarch POS, Comarch ERP Auto Update viene verificata la versione del componente Microsoft.NET Framework. In caso di mancanza o di una versione inferiore del componente, questo verrà installato nella versione richiesta.

L’installazione dell’applicazione Comarch POS viene eseguita tramite lo strumento Comarch ERP Auto Update.

Dopo l’avvio di Comarch ERP Auto Update bisogna effettuare i seguenti passi:

1.Aggiungere il prodotto Comarch Retail nella scheda Configuration

2. Aggiungere il componente Comarch POS al prodotto Comarch Retail

3. Configurare il componente Comarch POS. Per aprire la finestra di configurazione bisogna selezionare il componente e premere il pulsante [Configuration] che si trova nel menu principale. Nella finestra bisogna inserire i dati della connessione al database della postazione POS.

• Nome server: nome del server insieme all’istanza in cui verrà creato il database
• Nome database: per definizione viene suggerito il nome POSDB_[Codice profilo]
• Dati di accesso: Nome utente, Password

Il pulsante [Test Connection] consente di verificare la connessione al server specificato.

Nota

Un database può essere utilizzato da un’unica postazione POS

4. Salvare le modifiche e chiudere la finestra di configurazione dei prodotti premendo rispettivamente i pulsanti [Salva] e [Chiudi].

5. Nella finestra principale dell’applicazione bisogna selezionare una delle opzioni disponibili:

• [Download]: il prodotto verrà salvato nella cartella indicata durante la configurazione. Percorso predefinito: C:\Comarch ERP Auto Update\Downloads. Dopo lo scaricamento sarà disponibile il pulsante [Installa].
• [Download and Install]: il prodotto viene automaticamente installato dopo lo scaricamento.

Dopo l’installazione dell’applicazione, nella finestra principale dello strumento di installazione verrà visualizzato un messaggio adeguato e sul desktop di Windows e nel menu Start appariranno i collegamenti alle applicazioni Comarch POS.

L’installazione dei prodotti è stata descritta in modo dettagliato nella sezione Comarch ERP Auto Update.

 

L’installazione tramite Comarch ERP Auto Update del componente appropriato consente di utilizzare l’applicazione BI Point alla postazione POS.

Dopo l’avvio dell’applicazione Comarch ERP Auto Update bisogne effettuare i seguenti passi:

1. Selezionare il prodotto Comarch Retail nella scheda Configuration
2. Aggiungere il componente Comarch Retail BI Point al prodotto Comarch Retail.

1. Salvare le modifiche e chiudere la finestra di configurazione dei prodotti premendo rispettivamente i pulsanti [Save] e [Close].
2. Nella finestra principale dell’applicazione bisogna selezionare una delle opzioni disponibili:

• [Download] – il prodotto verrà salvato nella cartella indicata durante la configurazione. Percorso predefinito: C:\Comarch ERP Auto Update\Downloads. Dopo lo scaricamento sarà disponibile il pulsante [Installa].
• [Download and Install] – il prodotto viene automaticamente installato dopo lo scaricamento.

L’indirizzo predefinito presentato alla postazione POS per BI Point è: http://bipoint.comarch.pl. L’indirizzo può essere cambiato nella tabella della postazione POS Configuration Settings nella riga BIPointURL.

L’installazione dei prodotti è stata descritta in modo dettagliato nella sezione Comarch ERP Auto Update.

 

Nota

Per il corretto funzionamento di Comarch ERP Auto Udpate 2020.0 è necessario .NET Framework 4.7.2.

1. Per poter utilizzare tutte le funzionalità della rete degli agenti bisogna, subito dopo l’aggiornamento dell’agente principale, aggiornare gli agenti secondari. Questo è necessario perché non è possibile eseguire le azioni remote tra le versioni 2019.0 e 2020.0.

Perché il processo di aggiornamento di AU venga eseguito in modo corretto, bisogna assicurarsi che tutte le porte richieste siano corrette:

Sull’agente principale:

1. Connessioni in arrivo:

• 5672
• 8009
• 11365

2. Connessioni in uscita:

• 11366: per impostazione predefinita questo è 11366 però possono essere richieste anche altre, a seconda dalla porta configurata sull’agente secondario per la connessione con l’agente principale,
• 8466: porta per la connessione a update.comarch.com per AU 2019.0,
• 9466: porta per la connessione a update.comarch.com per AU 2020.0

Sull’agente secondario:

1. Connessioni in arrivo:

• 11366: per impostazione predefinita questo è 11366 però possono essere richieste anche altre, a seconda della porta configurata sull’agente secondario per la connessione con l’agente principale

2. Connessioni in uscita:

• 5672
• 8009
• 11365

2. Per eseguire il processo di aggiornamento bisogna avviare o riavviare l’UI dell’agente principale (a seconda di quello se esso era avviato nel momento in cui è stato reso disponibile il pacco con la nuova versione di Comarch ERP Auto Update).

 

3. In dipendenza da quello se il parametro Upgrade auotmatically nella finestra di configurazione di AU è selezionato o no, il processo di aggiornamento comincia da solo o richiederà l’approvazione da parte dell’utente.

 

4. Poi dovrebbe apparire la finestra con la barra di progresso:

 

5. Durante l’aggiornamento l’agente principale cambierà automaticamente la porta di connessione al server update.comarch.com da 8466 a 9466. Dopo il completamento dell’aggiornamento è bene controllare che il servizio RabbitMQ sia avviato. È possibile anche aprire la pagina http://localhost:15672 nel browser e accedere come amministratore (Nome utente: admin, Password: admin). Se non si verificheranno alcuni problemi, questo vuol dire che il servizio di rabbit è configurato in modo corretto.

6. Tutti gli agenti secondari saranno visibili nell’elenco come “Offline” fino al loro aggiornamento alla versione 2020.0. Il punto cambierà in “Online” quando otterranno la connessione alla coda di rabbit. Si può aggiornare tutti gli agenti secondari alla volta, utilizzando il pulsante [Upgrade All] o singolarmente, dopo l’estensione di un agente selezionato e la selezione dell’opzione [Upgrade Agent]. Allora comincia il processo di aggiornamento.

7. Durante l’aggiornamento di un agente secondario, se le porte richieste sono aperte, nella colonna “Status” saranno presentati i passi dell’aggiornamento.

8. Dopo il completamento dell’aggiornamento l’agente secondario diventerà “Online” e nella colonna “Version” apparirà l’informazione sui componenti installati. Il “check” verde nella colonna “Name” significa che un dato agente secondario è nella versione attuale.

9. Dopo l’aggiornamento di AutoUdpate alla versione 2020.0. questo utilizzerà la comunicazione WCF per impostazione predefinita.

Per poter utilizzare il componente Comarch mPOS bisogna utilizzare REST.

Per cambiare le modalità di comunicazione agente principale <-> agenti secondari in REST bisogna, nella finestra della configurazione, nella sezione Communication Configuration selezionare il parametro Use REST communication. Dopo il salvataggio l’UI del servizio AU verrà riavviato e la modalità di comunicazione tra l’agente principale e gli agenti secondari sarà cambiata. Il cambiamento della modalità di comunicazione è raccomandato soltanto dopo l’aggiornamento degli agenti secondari perché la comunicazione AU 2019.0 <-> AU 2020.0 può avere luogo soltanto tramite WCF.

 

10. Configurazione richiesta delle porte per AU 2020.0, se sia l’agente principale che quelli secondari sono stati aggiornati alla nuova versione:

Sull’agente principale:

1. Connessioni in arrivo:

• 5672
• 8009
• 11365

2. Connessioni in uscita:

• 9466

Sull’agente principale locale:

1. Connessioni in arrivo:

• 8009

2. Connessioni in uscita:

• 5672
• 8009
• 11365

Sull’agente secondario:

1. Connessioni in uscita:

• 5672
• 8009
• 11365

Risoluzione dei problemi riguardanti il servizio rabbit

Nel caso in cui si verifichino dei problemi riguardanti rabbit, è possibile risolverli nel seguente modo:

1. avviare “cmd.exe” come amministratore ed eseguire le seguenti procedure:
2. cd C:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.5\sbin
3. rabbitmq-service.bat remove
4. rabbitmq-service.bat install
5. rabbitmq-service.bat start
6. rabbitmq-plugins enable rabbitmq_management
7. rabbitmqctl stop (bisogna aspettare un attimo l’esecuzione di questo comando, ogni tanto è necessario arrestare manualmente il servizio RabbitMQ)
8. rabbitmq-server -detached
9. rabbitmqctl start_app (bisogna aspettare un attimo l’esecuzione di questo comando, ogni tanto è necessario avviare manualmente il servizio RabbitMQ)
10. rabbitmqctl add_user admin addussero
11. rabbitmqctl set_user_tags admin administrator
12. rabbitmqctl set_permissions -p / admin “.*” “.*” “.*”

Durante l’esecuzione dei suddetti comandi potrebbe verificarsi un problema relativo all’autenticazione e al file erlang cookie. Per risolverlo bisogna copiare il file: C:\Windows\System32\config\systemprofile\.erlang.cookie

e incollarlo in:

C:\Users\UserName\.erlang.cookie