Installation Guide

1.3.6 Etereweb setup

From version 36, Etere changed the installation method for Etereweb, by developing a new installer called EtereUpdate.exe, which is also capable to execute system maintenance faster than the old procedure from Etere Configuration.

In this chapter it's described how it works and how to upgrade both etereweb and databases.

1. At the start, EtereUpdate.exe asks to select a valid license file.

etereupdate_license

2. Etere Update queries the Etere Update server via internet and shows all the projects and applications available for the customer.

etereupdate_home

On the right, using the button Refresh catalogue info, it's possible to query the server again. With the button Get updates from file, it's possible to select a .dat file, generated by Etere Support, to load the applications to update in case the customer has no access to the server and can't download automatically the needed updates.

3. In the Settings tab, insert the authentication credentials to access the SQL server.

etereupdate_settings

Once the credentials are set, it will be possible, in the home page, to assign the databases to upgrade:
• Select "Database Etere 1-6 Main" clicking on the checkbox or on the label.
• The "Assign database" button will become selectable.
• Click it to choose the SQL server and the main database.
• Confirm with OK button or clear the fields with Clear button.
Repeat the same procedure for all the other entries in the home tab and assign the proper database. Don't assign anything if the related database doesn't exist (e.g.: if the historical db does not exist, leave empty the entry "Database Etere 2-6 History").
In case of issues connecting to the SQL server, the user is warned with an error popup while trying to open the list of databases.
Note: It's not possible to assign the databases if more entries are selected.

For each database assigned, Etere Update displays the last update time and date and the database status (if it is already upgraded or not), as well as the just assigned server and db in the Destination column.

In the same columns, if Etereweb is already installed, Etere Update shows if the last version is already installed or not.


ETEREWEB INSTALLATION

First of all, in the server which will host the website, the windows features mentioned in the chapter 1.3.3.0 Etere Web Setup (old) should be installed.

In order to install Etereweb, select the checkbox in the Home tab and press Next.

The next page allows to choose a port and host name for the website and which version you want to update to.

etereupdate_web_install

Clicking the Next button again, leads you to the SQL Programmability page, which shows a summary of the selected databases the application is going to upgrade, the connection string written in the web.config file inside the website folder (if the connection string is not supposed to be written in the web.config file, Etere Update shows <Do not set in web.config>) and the SQL user the website will use to connect to SQL.
Note: Before launching the Etereweb installation, it's mandatory to assign and select also the databases, otherwise no connection string will be written in the web.config file and the website will return an error.

etereupdate_sql_programmability

To start the installation and the upgrade of the databases previously selected, click now on Start button.

To upgrade Etereweb the procedure is the same. The only difference is that EtereUpdate.exe overwrites the old web instance, so it doesn't allow to select a different port and hostname.

etereupdate_web_upgrade

At the end of the installation procedure, this page shows the steps performed and their outcome:

etereupdate_web_install_end

From here it's possible to close the installer or go back to the home page.


REPORT SERVER

If the Reporting server configuration on SQL side has been done already, on Etere Update it's possible to set the connection to the Report server.

Enable Reports Etere entry and click on Assign report server.

Provide the requested information (if already in use, they can be found in Etere Configuration > Configuration editor > Reporting service > Setup) and confirm. Etere Update will query the reports database and establish the connection to allow upgrade it as well.

etereupdate_reportserver

During the update, if the entry Reports Etere is selected, the page REPORT Server will show the information provided and allows to choose the version to upgrade to.

etereupdate_reportserver_install


LOGS

In the Logs tab, you can find the details of all the operations executed by Etere Update since the last startup. Potential errors are highlighted with a red font.

The buttons on the left allow to:
• Enable/Disable the word wrap
• Clear the logs view
• Open the folder to access the complete log files.

etereupdate_logs

etereupdate_license
etereupdate_home
etereupdate_settings
etereupdate_web_install
etereupdate_sql_programmability
etereupdate_web_upgrade
etereupdate_web_install_end
etereupdate_reportserver
etereupdate_reportserver_install
etereupdate_logs