1.3.5 Etereweb setup (old)

Important note: From Etere version 36 and above, follow the procedure described in Chapter 1.3.6.0 Etereweb setup.

Etere Web Setup

1. The Etere Web Application (Etere Web Setup) installation is embedded into the Etere Update main menu, as shown below. It runs outside the Etere environment, requires only the lib_utils component and optionally wsetup.ini for the default Data Connection properties.
Notes:
- If both "Etere Web Setup" and "Web API Setup" use port 80 (default port) for communication with the SQL Server, both setups cannot be run concurrently; otherwise, one of the setups will fail.
- Before Etere Web setup, Etere application modules must be installed and configured in the workstation, and the database must be connected.

installation_etereweb_setup

2. Launch the Etere Installer; open the Etere Web setup wizard through the related button, to start the application initialisation process. The setup must be launched from the server where you want to install or upgrade Etereweb. You would need Administrator privileges to proceed.

Before starting, Etere Web Installer checks the setup site's SQL database settings against the current Etere configuration SQL database. If the SQL databases differ, a pop-up message asks the user whether to update the website's database settings in the "Web.config" file, located in the website folder.

On the Management page, you can check the current version of Etere Web installed on the workstation, along with all other installed versions and their respective bindings.

Here, you can view the versions that have been downloaded but not installed yet, marked with the label <to be installed>.

setup_management

By simply clicking the Check for updates button, you can see all the latest Etere Web releases and check whether they have already been installed or downloaded, or are available for download.

Selecting a version available for download would enable the button Download and Install, which will create a folder named "EtereInstall" (if not already present) in the local user's downloads folder, where the selected Etere Web package will be saved. 

The installation will start once the download is done. 

Check_for_updates

3. If a version has already been downloaded, clicking the Next button on the Management page is enough to start the installation.

4. The Settings tab contains the information about the installation package.

• Web site name: It displays the network site name where the Etere Web Setup application is available. Etere Web Setup can manage the DNS, which retrieves the IP address (the hostname is not necessarily needed) to fulfil the settings. A DNS Server can be another machine in the network; the user must be granted specific Windows permissions to manage DNS.

• Inherit binding from: This setting allows the new website to inherit impersonation, hostname, and binding port from the last installed site.

The settings in the Data Connection section are auto-retrieved by the Etere application.

Moreover, the data provider would be configured with the same network provider name (e.g., MSOLEDBSQL) as in Etere desktop applications.

The SQL Databases and SQL server names are automatically retrieved from Etere's connection settings.

• Authentication Mode: Not manageable; only SQL Authentication is allowed.
Enter the username and password of an SQL account with high privileges (e.g., sa) in the Authentication section.

Click Next to start the installation.

5. In the Installation tab, the user can check the outcome of the installation, open the file folder, or access the Etere website with the default browser.
• Run: indicate if the installation step has been performed or is yet to be performed.
• Step: List the various steps to be performed in sequence by the installation program (see detailed information below).
• State: Click on the status under the "State" column to view the step's details.

The steps performed in this installation phase are:

• Check Prerequisites
The required software must be installed:
-Microsoft .NET Framework 4.6 or later
-IIS 7.0 or later
-ASP .Net 4.5
-IIS Windows Features listed below must be enabled:
Windows_Features

• Create Website
- Creates a physical path directory in C:\inetpub\wwwroot, named as the Etere Web package the user is installing. Grants Read/Execute access to Everyone.
- Creates application pools
- Creates a new site in IIS pointing to the physical path created and creates the virtual directories according to the media folders available in Etere.

When creating the website between the primary domain and the trusted domain, it is recommended to use Microsoft's built-in "IIS_IUSR" account instead of the "Everyone" current network user account for setting access rules.

• Extract Files
Extract files from the installation package to the physical path on the website.

• Streaming Server Setup
Using this function, the user can set up the Etere Web Player Streaming Service (EtereWPlayer) if installed on the same server. Select the related feature in the Etere Desktop installation process to install the Streaming Server.
If the Etere Web installation is launched and the Streaming server is not installed, the Etere Web installer will skip this step.

• Database Setup
Updates specific Etere Web stored procedures and functions in the database.
Database Setup requires a Full-text catalogue to be in place. If the record does not exist, you can perform the System Maintenance task Full-text Search to create the log.

• Website Setup
This process updates the Web.config file by setting the database connection strings in the physical path.

• Finalization
When the installation cannot proceed further, this process automatically rolls the site and directories back to the previous state.

6. Upon installation, select one of the options available from the installation menu:

Back to Management: Select this option to return to the Etere Web Setup Management menu. See below for more details.

Customise site appearance: By selecting this option, the Etere Web Customisation wizard launches immediately, where you can customise the appearance of Etere Web, e.g., changing the background colour, title character colour, standard image for assets, etc.

Browse: This option launches the Etere Web User Login screen, where you can log in to the newly installed Etere Web and start using the features.

Etere Web Management

In the "Management" tab, all versions of Etere Web are displayed under their respective network sites. The "Management" tab toolbar allows users to manage the Etere Web applications.

Properties - The Properties button allows viewing the following setup information of a specific site:
The Web site tab displays site information (site name, hostname, binding port, and DNS server).
The Web config tab displays the current SQL database settings of the setup site.
The virtual dirs tab contains only the Set up virtual directories button, which lets you view the media folders configured in Etere and create virtual folders for the website. It basically allows repeating the Create website step.

If a DNS server is used in the domain, the Etere Web Setup is capable of managing the DNS server; the user can click on the specific version (under the Site Name) to be installed and select the hostname related to the local host or add a new hostname to the DNS server, and click to confirm the changes.

Delete - Using the delete function, the user can remove the selected website and delete its application pool and physical directory from the Management panel if no other sites use it.
Before executing this function, the website must be stopped.

Start/Stop - These functions allow users to start or stop the website.
Note: If the error message "The object identifier does not represent a valid object" pops up when attempting to amend the Stop/Start status, it indicates that the default website does not have an HTTP binding.

Customise - This feature opens a dialogue box that allows you to customise the website's appearance. Changes allowed for customisation include the general aspects of the web appearance.
In the "Configuration" droplist, select a predefined template in the system, load the variables and values defined in the template, and start customising the website appearance by changing the values. Once saved, the user can rename and save the new template so it appears in the drop-down list. However, users are not allowed to modify or delete any preset template.
In the dialogue box, select one of the following actions after making changes to the template:
• Delete: It deletes the selected changes.
• Apply to the website:
   ✓It applies the selected configuration to the website if no changes have been made.
   ✓If changes are made to the selected configuration, it saves the changes to the database and applies the new configuration to the website.
• Save As: It saves the amended template with a different name.

Browse - This feature opens the website with the default browser, using its hostname or local hostname.

Etere Web Setup Log

During the Etere Web Setup, the log containing detailed information about the setup process is saved on the local PC in the C:\Users\[user_name]\AppData\Local\Etere\Log folder. The log file name is Etere.Web.Installer*.log.

Use the toolbar icons <Open Log File> or <Open Log Folder> in the Etere Web Setup menu to locate and view the log file.