Configuration

In the configuration menu you can manage the application settings, connection addresses, products and their components. The configuration menu is available under the button [Configuration] in the ribbon.

Comarch Auto Update configuration window

For descriptions on how to add and configure products and their components on the example of Comarch ERP Standard, Comarch Retail, Comarch ERP Tools and Comarch Logs View, refer to these articles:

Buttons in the ribbon are grouped into following button groups:

  • General
    [Close] – exits an active application view[Save] – saves the changes made to the current view

    [Refresh] – refreshes the current view

    [Restart Service] – restarts Comarch Auto Update service. It is used to troubleshoot the connection issues between the application and the service or to change the application configuration.

  • Program Configuration
    [Backup Copy] – makes a backup copy of Comarch Auto Update application configuration[Restore] – restores the program configuration from the file created with the [Backup Copy] button

On the right side of the window, there are the parameters applicable to connection configuration and the application settings.

Note
Configuration parameters are editable in the main profile only and are applicable to all other profiles. Fields in the other profiles are insensitive and a relevant message is displayed there.

Following are the configuration parameters grouped into sections:

  • Configuration section
    • Download Folder – default directory to which component, quick fixes and add-ons are downloaded. It is specified during Comarch Auto Update installation and can be changed at any time during work with the application.
    • Main Setup Folder – default directory in which components are installed. After a component is installed, this field is no longer editable.
    • Backup Copy Folder – default directory in which backup copies of component setup folders are created during installation of quick fixes or update of the component. It is specified during Comarch Auto Update installation and can be changed at any time during work with the application.
    • Client ID – unique client ID received along with the license for selected Comarch product. In the setup wizard for child agent, enter the code provided in the parent agent under the agent structure in this field.
Configuration section
  • Connect with the parent agent section – includes the parameters to connect to Comarch servers (in the case of the parent agent) or to connect to the client’s parent agent (in the case of a child agent). The address to connect to Comarch servers is com and the port depends on the client’s region:
    • 9466 (PL)
    • 9460 (FR and ES)
    • 9539 (DE and UK)
    • 8009 is the default WCF port

    A secure SSL connection option is now also available. Following ports should be unblocked for a specified region to ensure a properly established connection:

    • 10466 (PL and EN)
    • 10460 (FR and ES)
    • 10539 (DE)

    A corresponding port should also be unblocked from the router.

    Note
    When switching to SSL communication in the parent agent, the port will propagate automatically, but if a new child is added to the network, then you need to set the port manually in the configuration.
Connect with the parent agent section
  • Configure the service for child agents section – (available only for parent agents) this section is only available in Comarch Auto Update for parent agent version. Here, you can enter the host name and ports over which child agents will connect. This data needs to be provided under Connect with the parent agent section in Comarch Auto Update for child agent version.
Configure the service for child agents section
  • Configure local service connection and UI section – ports to communicate between Comarch Auto Update Service and the application interface. These ports are 11365 and 8010, by default. If nothing is blocking communication over these ports in business environment, then it is not recommended to change them.
Configure local service connection and UI section
  • Update Configuration section
    • Compress version archives – if selected, the component version archives will be compressed during update of the archives which, this way, will use less space
    • Compress database backup copies – if selected, the databases backup copies will be compressed during update of backup copies which, this way, will use less space. This option is not available in the environment running Microsoft SQL Server Express.
    • Undo changes automatically in case of error – rolls back all the changes in case an error occurs during update of a component
    • Delete native images – if deselected, the program ignores the deletion of the native library images that were created during component installation. This parameter is used for Comarch ERP Standard product only.
Update Configuration section
  • Uninstallation Configuration section
    • Delete downloaded files – if selected, downloaded component setup files will be deleted during uninstallation. This parameter is insensitive if the component is installed in any of the profiles.
    • Delete configuration backup copies – if selected, the program will delete the component configuration backup copy available under ConfigurationComponentConfiguration during uninstallation.
    • Delete component configuration on uninstallation – if selected, the program will delete the component configuration available under ConfigurationComponentConfiguration during uninstallation.
Uninstallation Configuration section
  • Add-Ons and Quick Fixes Configuration section
    • Show only the latest add-ons – if selected, only the latest add-on versions will be listed. If deselected, all add-on versions will be displayed.
    • Show only the latest quick fixes – if selected, only the latest quick fix versions will be listed. If deselected, all quick fix versions will be displayed.
Add-Ons and Quick Fixes Configuration section
  • Download Configuration section
    • Size of a single downloadable archive (KB) – size of a single data archive (as part of components, quick-fixes and add-ons) downloaded by Comarch Auto Update within one request. To ensure faster and stable Internet connections, it is recommended to increase the archive size.
    • Archive download timeout (s) – time after which the download of data archive (as part components, quick-fixes and add-ons) will be interrupted. In case of slower and less stable Internet connections, it is recommended to increase this value.
Download Configuration section
  • Auto Update Upgrade Configuration section
    • Upgrade automatically at program startup – if deselected and there is a new program version available, you will be asked whether to upgrade Comarch Auto Update application after you run it. If selected, the program will be upgraded automatically without the user’s interference.
    • Make Auto Update backup copies every – specifies the frequency for creating backup copies of Comarch Auto Update databases. This value is expressed in days. Setting this value to 0 deactivates this option (not recommended).
    • Remove database backup copies older than – deletes the backup copies of Comarch Auto Update databases after a specified time. This value is expressed in days. Setting this value to 0 deactivates this option.
    • Compress service logs after exceeding the size of (MB) – automatically transfers Comarch Auto Update service logs to a separate compressed file when the specified size is exceeded. Value 0 deactivates this option.
    • Number of stored service log archives – used to specify the number of archives with compressed Comarch Auto Update service logs, which will be stored on a disk. Value 0 deactivates this option, whereas value -1 is used to store an infinite number of archives.
    • Delete application logs older than – automatically deletes the UI logs of Comarch Auto Update application, which are older than the specified number of days. Logs are not deleted if the value is -1.
    • Compress application logs – determines if UI logs of Comarch Auto Update application are to be transferred to a separate compressed file.
Auto Update Upgrade Configuration section
  • Language Configuration section – you can select a language of the application interface in this section.
Language Configuration section
  • Communication Configuration For Child Agents section (available for parent agents only) – specifies the standard application communication. The default option is REST which should not be changed if you have an agent network 2020.0 or later. The WCF parameter is used to ensure backward compatibility and to upgrade child agents 2019.0.
Communication Configuration section
  • SSL Connection Configuration For Child Agents section – available for parent agents
    • [Generate Certificates] – generates a certificate that is automatically propagated to child agents. This button is active when the program version installed in all connected agents in the agent network support allows switching to SSL
    • [Send Information] – reattempts certificate sending to child agents
    • [Use SSL Connection] – initiates communication via SSL
    • SSL port – the default communication port is 12365
    • SSL port for local parent agents – the default port is 12365
    • Enter all names of the machine with parent agent installed in the agent network, which are (or will be) used in the network. Separate the names with a semi-colon (;) – type the names of the machines with a parent agent in this field
    • Enter all IP addresses of the machine with parent agent installed in the agent network, which are (or will be) used in the network. Separate the addresses with a semi-colon (;) – type the IP addresses of the machines with a parent agent in this field
    • Child agents with certificates – indicates the ratio of the number of child agents with a downloaded certificate to the number of child agents defined
    • Child agents switched to SSL communication – indicates the ratio of the number of child agents connected via SSL communication to the number of child agents defined
    • [Export Certificates] – exports certificates for Comarch mPOS to be manually added in the Android system
  • SSL Connection Configuration For Child Agents section – available for child agents
    • AutoUpdate service uses encrypted SSL connection
    • AutoUpdate UI uses encrypted SSL connection
    • AutoUpdate uses encrypted SSL connection
    • Parent agent uses encrypted SSL connection
    • [Use SSL Connection] – switches child agent communication from REST to SSL; it opens a window where you can select a zip file with the certificate

How to activate SSL connection

To activate connection via SSL, follow the steps below:

  • Enter SSL ports for child – parent agents communication and child – local parent agents communication; the default port is 12365 for both communication modes
  • Enter the names of the machines with parent agent and their IP addresses
  • Generate a certificate using the [Generate Certificates] button.
    The certificate is generated and propagated to child agents, where it is installed. The whole operation is performed automatically. Select the [Send Information] button to reattept sending the certificate to child agents
  • Select [Use SSL Connection] button – this commences communication via SSL
  • For mobile devices with Comarch mPOS application, use the [Export Certificates] button

Install the .cer certificate on you mobile device (Android → SettingsSecurityInstall certificates). The path can vary depending on your Android system version.

Copy the .pfx certificate into the mPOS folder. In mPOS, go to Start → Settings → Auto Update and enter the following:

  • certificate name (without .pfx extension)
  • certificate password
  • enable SSL support
Note
Communication via SSL for Comarch mPOS application requires the parent agent address in the form of domain name (IP address is not supported).
Note
Comarch mPOS application version must support SSL. This is the current application version 2023.5 as well as 2023.2 version with the latest fixes installed.

Czy ten artykuł był pomocny?