﻿



          HiSecOS - S O F T W A R E - R E L E A S E - D O C U M E N T

                     Hirschmann Automation and Control GmbH

                            HiSecOS Release  04.1.01
 
                                  2021/07/06

                                C O N T E N T S
                                ===============


    1.   Software Update
    1.1      Update via ACA
    1.2      Update via HTTP or HTTPS
    2.   Release Notes
    2.1      Supported Hardware
    2.2      Web Browser
    3.   History of Changes
    4.   Software Version Message
    5.   Contact
    6.   END USER LICENSE AGREEMENT
    7.   Copyright of integrated Software


This document is delivered with the software as the file "Readme_04.1.01.txt".


.----------------------------------------------------------------------------.
| Before you start with the installation, refer installation guide.          |
'----------------------------------------------------------------------------'


1. Software Update
==================
A software update replaces the installed operating software completely with the
new software release.

.----------------------------------------------------------------------------.
|  Prior to a software update, disconnect all redundant connections.         |
'----------------------------------------------------------------------------'

+-------------------------  C A U T I O N -----------------------------------+
| When updating, please consider that any unsaved configuration parameters   |
| will be lost and the saved values will become active.                      |
+-------------------------  C A U T I O N -----------------------------------+

.----------------------------------------------------------------------------.
|  Please be patient while updating, the update process needs some           |
|  minutes to complete.                                                      |
'----------------------------------------------------------------------------'

+-------------------------  C A U T I O N  ----------------------------------+
| On some variants there is no backup image. Make sure that the              |
| update has ended successfully before restarting the device.                |
+----------------------------------------------------------------------------+


After a successful update, the device can be restarted.

.----------------------------------------------------------------------------.
|  Do configuration or Check the redundancy configuration again before you   |
|  reconnect all redundant connections.                                      |
'----------------------------------------------------------------------------'

1.1 Update via ACA
===================
The ACA enables a local update of the software release.

Prior to the actual software update, load the software onto the ACA using your
PC.

Then connect the ACA to the device and start the update via the System Monitor 1.
Proceed as described below:

1. Cold start the device
2. Press the <1> key when the following message appears:
   "Press <1> to enter System Monitor 1"
3. After that the menu "System Monitor 1" is displayed
4. Press the <2> key "Update Operating system"
5. After that the following message is displayed:
   "Update Operating System"
6. Press the <1> key "ENVM"
7. Enter the full path to your image file when prompted, e. g.,
   /usb0/HiSecOS-eagle4007-04101.bin, and confirm the input
8. After that the image will be transferred from the ACA to the device's
   internal flash.
9. After a successful update, press the <q> key "End (reset and reboot)"

Details about the System Monitor 1 are described in chapter 1 of the basic
configuration user manual.


1.2 Update via HTTP or HTTPS
============================
For an HTTP update you need access from your computer to update the software.
Now open the graphical user interface.
In the dialog "Software", click on the "...".
A second browser window will be opened. Here you select the update software.
Then click the "Update" button to transfer the software.


2. Release Notes
================

2.1 Supported Hardware
======================
This software release 04.1.01 is released exclusively for the following hardware:

HiSecOS-eagle4007-04100.bin:
- EAGLE40-07206			(8GB RAM, from serial number LR2019xxxxxxxx)

The following accessories are supported:
+ Terminal cable
+ AutoConfiguration Adapter ACA22-USB (EEC)
+ AutoConfiguration Adapter ACA21-USB (EEC)
+ 6-pin terminal block (50 pieces) for supply voltage
+ 2-pin terminal block (50 pcs.) for signal contact and input
+ Industrial HiVision Network Management Software
+ M-SFP-SX/LC
+ M-SFP-SX/LC EEC
+ M-SFP-MX/LC EEC
+ M-SFP-LX/LC
+ M-SFP-LX/LC EEC
+ M-SFP-LX+/LC
+ M-SFP-LX+/ LC EEC
+ M-SFP-LH/LC
+ M-SFP-LH/LC EEC
+ M-SFP-LH+/LC
+ M-SFP-LH+/LC EEC
+ SFP-GIG-LX/LC
+ SFP-GIG-LX/LC EEC
+ SFP-GIG BA LX/LC EEC
+ SFP-GIG BB LX/LC EEC
+ SFP-GIG BA LX+/LC EEC
+ SFP-GIG BB LX+/LC EEC
+ SFP-GIG BA LH/LC EEC
+ SFP-GIG BB LH/LC EEC

Note: Operate EAGLE40-07 devices with fiber optic SFP transceivers only.
Copper SFP transceivers are inadmissible.

2.2 Web Browser
================
Third-party software such as web browsers validate certificates based on
criteria such as their expiration date and current cryptographic parameter
recommendations. Old certificates can cause errors, for example, when they
expire or cryptographic recommendations change. Upload your own, up-to-date
certificate or regenerate the certificate with the latest firmware to solve
validation conflicts with third-party software.

The Software Release 04.1.01 is optimized for the following web browsers with 
HTML5 support:

Web browser:
- Mozilla Firefox
- Chrome
- Edge

In the Web browser, go to the address "http://<The management agent's IP
address>" or "https://<The management agent's IP address>/".
Initial password: "private" or password which are set after first password 
change.

3. History of Changes
=====================

Software Release 04.1.01
------------------------
New Feature supported:
None

Security Fix:
None

Open points and decisions:
 - FDB: After adding static mac address to interface-1, same mac is getting learned to other interface-2 while traffic is send with same mac as source mac on interface-2
 - No support of copper SFP in device, it might work with hot plug in and port goes down after reboot
 - Eagle web become unresponsive, once web remain open for more than a day
 - Vlan tagged packet not getting filtered by l2 filtering if matched on vlan interface with untagged egress port
 - After creating around 1000 L2 filter rule via CLI, web of L2 filter rule gives error to contact to manufacturer


4. Software Version Messages
===========================
After a successful software update, the correct version should
be displayed upon entry of the CLI command "show system info".
The version strings for this software release are:

Firmware software release (RAM).............HiSecOS-04.1.01  2021-06-07 12:08
Firmware software release (FLASH)...........HiSecOS-04.1.01  2021-06-07 12:08
Bootcode software release (FLASH)...........HiBootS-04.1.01  2021-06-07 12:17



5. Contact
==========

       .----------------------------------------------------------------.
       |                                                                |
       |  If you have further questions, please contact your Hirschmann |
       |  contract partner.                                             |
       |                                                                |
       |  Current information and the latest news concerning our        |
       |  products can be accessed via our web site at                  |
       |  http://www.beldensolutions.com                                |
       |                                                                |
       '----------------------------------------------------------------'

.------------------------------------------------------------------------------.
| Hirschmann Competence Center                                                 |
|                                                                              |
| In the long term, product excellence alone is not an absolute guarantee of a |
| successful project implementation. Comprehensive service makes a difference  |
| worldwide. In the current scenario of global competition, the Hirschmann     |
| Competence Center stands head and shoulders above the                        |
| competition with its comprehensive spectrum of innovative services:          |
| - Consulting incorporates comprehensive technical advice, from system        |
|   evaluation through network planning to project planning.                   |
| - Training offers you an introduction to the technological fundamentals,     |
|   product briefing and user training with certification.                     |
| - Support ranges from commissioning through the standby service to           |
|   maintenance concepts.                                                      |
| With the Competence Center, you firmly rule out any compromise:              |
| the client specific package leaves you free to choose the service            |
| components that you will use.                                                |
| Internet:                                                                    |
| http://www.hicomcenter.com                                                   |
`------------------------------------------------------------------------------'


6. END USER LICENSE AGREEMENT
=============================

These Hirschmann Software Conditions constitute a legally-binding contract 
between Hirschmann Automation and Control GmbH, Stuttgarter Strasse 45-51, 
72654 Neckartenzlingen (hereinafter referred to as "Hirschmann") and the 
Customer concerning the use of Hirschmann software products, i.e. machine-readable 
computer programs  and associated files, whether in packaged form, or received 
electronically, and any modified version, upgrades, updates and other copies of 
such programs and files owned by Hirschmann as well as the associated media, 
printed materials and documentation in electronic format (hereinafter referred 
to as “Software”). Software shall include applications running as embedded software 
in a Hirschmann network infrastructure device (hereinafter referred to as the 
“Embedded Software"). By clicking the "I accept" button during the download or 
installation process or by using the Software in another way, the Customer agrees 
to all of the conditions of these Hirschmann Software Conditions. If the Customer 
does not agree to one of these Hirschmann Software Conditions, the Customer is not 
entitled to use the Software and is obliged to stop the download or installation 
process immediately and to return to Hirschmann or destroy all copies of the 
Software in the Customer's possession. 

1. Definitions
"Customer"
A Customer for the purposes of this contract is a natural person who or a legal 
entity which agrees to these Hirschmann Software Conditions as stipulated above.

“Embedded Software”
Shall have the meaning ascribed to it above.

“Client-server Application”
A distributed application structure that partitions tasks or workloads between 
a service, called servers, and service requesters, called clients.

“Software”
Shall have the meaning ascribed to it above. 

"Third party"
A third party for the purposes of this contract is a natural person who or a legal 
entity which receives Software deliveries from the Customer and not from Hirschmann. 
Apart from required acknowledgement of the third party to these Hirschmann Software 
Conditions, in the event of a transfer of the Software to a third party, agreement 
on the contract terms with the third party shall be incumbent upon the Customer, on 
its own responsibility.

2. Subject of the Contract
Pursuant to this contract, the Customer receives without time limit the right of 
use of the Software delivered to it on the hardware specified  therefor, as well as 
the use of necessary literature and documentation. To the extent Embedded Software 
is concerned, the right of use granted under these Software Conditions is limited 
to use of the Hirschmann product, system or device specifically envisaged for this. 
The right of use is not exclusive and - insofar as nothing to the contrary arises 
from these Software Conditions - is not transferable. 
To the extent that it is necessary and not otherwise agreed upon between the 
contractual partners, installation of the Software will be performed by the 
Customer on its own responsibility and in accordance with the installation 
instructions. 
The selection of the Software and consultation regarding the applications intended 
by the Customer, and also instruction, training and other technical support of the 
Customer, are not a subject of this contract. They may be the subject of a separate 
contract. Without such agreement, only the Customer assumes the risk associated 
with the selection of programs and their suitability for the applications intended. 
Hirschmann is liable in such an event only within the scope of sub-paragraph 10 of 
these Software Conditions.

3. Extent of Performance and Function
The extent of performance and function of the delivered programs is determined by 
the product descriptions valid at the time the contract is entered into.

4. Updates
Insofar as the Software is labelled or designated as an update, in order to use this, 
it is necessary to obtain a license for a product which is defined by Hirschmann as 
suitable for the update (hereinafter referred to as a "suitable product"). 
A Software product which is labelled as an update replaces and/or augments the 
starting product. The Customer may use the resulting updated product only in 
compliance with the provisions of these Software Conditions. 
Insofar as the Software is an update of a component of a software program 
package which the Customer has licensed as a unified product, the Software may 
be used only as part of that unified product package and may not be separated for 
use on more than one computer. 
If the Software is a client-server application the client can be used on different 
hardware.

5. License Fees
Fees for the right of use of the delivered Software shall be agreed upon as a one-
time license fee, plus the corresponding value-added tax as required by law. 
In the absence of a specific agreement to the contrary, the license fees for the 
Software provided are included as a once-off license fee in the purchase price of 
the products, systems or devices equipped with the Software.

6. Right of Use
The Software may only be used on one item of the hardware provided therefor. 
Any additional use of the Software on further hardware requires a separate 
agreement with Hirschmann and is only permissible after payment of the 
corresponding fee for right of use. Copies may only be made for archive purposes, 
as replacements, or for fault diagnosis. All rights to the Software (including 
documentation), especially the right of copying, distribution and translation, 
remain the rights of Hirschmann. The Customer must ensure that the Software and 
documentation are not accessible to third parties without Hirschmann's previous 
written permission. The copyright notice located on the original is to be affixed 
to all copies. 
The Customer may transfer the right of use of the Software to a third party (for 
instance, through a re-sale contract) only if the latter acknowledges these 
Hirschmann Software Conditions and the Customer proves to Hirschmann without 
being requested to do so that it has handed over to the third party, deleted, 
destroyed or otherwise made unusable all of the tangible and intangible copies of 
the Software (including all components, media and printed materials and all 
updates). If the Software to be transferred is an update, the proven transfer, 
deletion, destruction or deactivation must also encompass all of the previous 
versions of the Software. 
With the transfer, all rights of use of the Customer are cancelled, including the 
rights of any copies, which are to be transferred to the third party. The Customer 
may not transfer Software to a third party if there is a justifiable supposition 
that the third party might breach the conditions of the Hirschmann Software 
Conditions, especially that it might create unauthorized copies. This is also valid 
with regard to employees of the Customer.
The Customer is not entitled to grant sub-licenses concerning the Software to third 
parties.
In the event of a breach of the rights of use or upon a modification of the Software 
by the Customer, Hirschmann may withdraw the right of use from the Customer 
and - irrespective of other existing rights - demand the return or the destruction of 
the Software as well as that of any existing copies. The right of use of the Software 
may be terminated without notice by Hirschmann if a significant cause exists. A 
significant cause shall exist for Hirschmann especially if the Customer breaches the 
conditions of this contract and continues its actions in breach of contract, even 
though Hirschmann has warned it against such actions. The right of use is granted 
subject to the complete payment of the one-time license fee.

7. Proprietary Rights
With reservation of all rights of use granted under section 6, Hirschmann remains 
the proprietor of all rights, especially those of copyrighted exploitation rights, 
also those of copying, distribution and translation of the delivered programs, of 
the literature and documentation and similar items pertaining thereto, and of all 
complete or partial back-up copies made by the Customer within the scope of its 
use. If the program is delivered to the Customer only in machine code, then the 
Customer will not acquire access to the source code. The Customer is obligated to 
prevent unauthorized access by third parties to the Software, as well as to the 
documentation, by appropriate precautionary measures. Delivered original data 
carriers and back-up copies are to be maintained in a secure place to prevent 
unauthorized access by third parties. The Customer will instruct its employees in 
an appropriate manner concerning Hirschmann's proprietary rights.

8. Obligation to Inspect and Report Defects
The Customer is obliged to examine the delivered Software, including documentation, 
within 8 working days after delivery, especially with regard to data carriers 
and manuals, as well as to the operability of the basic program functions. 
Defects which are thereby ascertained or ascertainable must be reported to 
Hirschmann without undue delay. The notification of defects must contain a 
best-efforts description in detail of the defects. Defects which are not 
ascertainable within the framework of the described and orderly examination must 
be reported within 8 working days after their discovery in compliance with the 
described defect requirements. Upon failure to fulfil the obligation to examine and 
inspect, the Software is considered as accepted with due regard for concerned 
defects.

9. Warranty 
The Customer is aware that, in accordance with the state-of-the-art technology, it 
is not possible to produce a computer program which is completely free of errors. 
Hirschmann warrants that the programs delivered as Software will fulfil the 
functional and performance features which are contained in the valid product 
descriptions at the time of entry into the contract, or which are separately agreed 
to. Excepted from this are defects which represent only non-essential deviations 
from the respective valid product description. 
Hirschmann assumes no responsibility that the Software will run without 
interruption or error, that all Software errors can be eliminated by Hirschmann, 
and that the functions contained in the Software may be executed in all of the 
combinations selected by the Customer or that they correspond to its 
requirements. Hirschmann assumes the obligation to rectify Software errors which 
impair use in compliance with the contract and which are not of an immaterial 
nature, specifically at Hirschmann's selection and, depending on the significance of 
the error, by the delivery of improved software or through information regarding 
the elimination or through circumvention of the effects of the error. The 
precondition for the rectification of errors is that the effects of the errors be 
reproducible, that they be adequately described by the Customer, and that the error 
be reported to Hirschmann within the term stipulated in section 8. 
The warranty is excluded to the extent that the error is due to the Customer or a 
third party making modifications of any kind to the Software or data carriers or 
treating them in an improper manner. Hirschmann warrants that the data carrier is 
free from material or manufacturing defects. Hirschmann will replace any defective 
data carriers with data carriers which are free of defects.
The Customer has the right to demand a reduction of the user's fee upon an 
unsuccessful replacement shipment, or to rescind the contract without cost. In the 
event of rescission, the Customer will return to Hirschmann any data carrier with 
the Software and documentation pertaining thereto or will destroy any existing 
copies. For further claims, especially for compensation for damage which does not 
occur in the programs themselves, Hirschmann assumes liability pursuant to 
section 10. 

10. Liability of the Licenser/Exclusion of Liability
Claims against Hirschmann as well as its employees or agents for compensation for 
damage, irrespective of the legal basis, are excluded, especially a claim for 
replacement of damage which does not occur to the Software itself. 
This does not apply to the extent that Hirschmann is liable under mandatory law, 
e.g. in the case of (i) personal injury or damage to privately-used property pursuant 
to the German Product Liability Act, (ii) due to loss of life, personal injury or 
damage to health which is due to a negligent or intentional breach of duty by 
Hirschmann or one of Hirschmann's legal representatives or one of Hirschmann's 
vicarious agents, (iii) insofar as the cause of damage or loss is due to intentional 
behaviour or gross negligence by Hirschmann or a legal representative or a 
vicarious agent of Hirschmann, (iv) if the Customer asserts rights due to a 
deficiency under a quality guarantee or the particular duration of a quality, (v) 
Hirschmann negligently breaches a fundamental contract obligation whose 
fulfilment is what makes the due performance of the contract possible at all and on 
whose compliance the Customer may regularly rely (cardinal obligation), or (vi) 
claims for recourse in the purchase supply chain (§ 445a of the 
German Civil Code (BGB)) are concerned.  
Hirschmann is not liable for the replacement of data unless Hirschmann willfully or 
through gross negligence caused the data's destruction and the Customer has 
determined that that data can be reconstructed at reasonable cost from data 
material which is available in machine-readable form.
The provisions set out in these Software Conditions concerning the exclusion of 
liability (section 10) shall apply only if the Customer is a businessperson (§ 14 of 
the BGB), a legal entity under public law or a public-law special fund.

11. Statute of Limitation/Warranty Period
All claims directed against Hirschmann due to a quality defect or a defect in title 
become time-barred 12 months after the statutory warranty commencement, unless the 
German Product Liability Act or other legislation, particularly § 445b of the BGB 
(recourse claims in the purchase supply chain) prescribe longer periods. 
The period of limitations for claims based on liability for damage and loss arising 
out of loss of life, personal injury or damage to health which is due to a negligent 
or intentional breach of duty by Hirschmann or a legal representative or vicarious 
agent of Hirschmann, and for other damage and loss which is due to an intentional 
or grossly negligent breach of duty by Hirschmann or a legal representative or 
vicarious agent of Hirschmann, shall be determined in accordance with the statutory 
provisions. 
 

12. Return of the Program
If the program delivered based on this contract is partially or wholly exchanged 
within the framework of the warranty performance, then the Customer is obligated 
to verifiably destroy the original of the program or to return it to Hirschmann.

13. Termination of the Contract
The Customer is able to terminate the contract at any time in whole or in part.  
In the event of the termination of this contract, the Customer is obliged to 
return to Hirschmann or verifiably destroy the original as well as all copies and 
partial copies of the programs concerned and also modified copies of the pertinent 
programs associated with other software materials. This applies correspondingly 
for program documentation and other delivered literature. Retention of an archive 
copy for back-up reasons requires a separate, written agreement. The license fee 
paid - insofar as nothing to the contrary is agreed - will not be refunded.

14. Written Form
Supplementary agreements and modifications must be in written form. This 
applies also to a waiver of this written-form requirement.

15. Choice of Law, Legal Venue
The application of German law is hereby agreed. For any disputes which should 
arise as a result of the contractual relationship when the Customer is a fully-
qualified merchant, a legal entity under public law or a special fund under public 
law, then the court at the place of Hirschmann's headquarters will have 
jurisdiction.

16. Partial Invalidity
If a condition of this contract should be or become invalid, the validity of the 
remaining conditions shall not be affected thereby. In such an event, the invalid 
condition is to be understood, interpreted or replaced so that the economic 
purpose pursued through it is achieved.

17. Export
The Customer will comply with the German and American export regulations 
when exporting the Software.


7. Copyright of integrated Software
===================================

The product contains, among other things, Open Source Software files developed
by third parties and licensed under an Open Source Software license.
You can find the license terms in the graphical user interface under 
Help > Licenses, in Appendix A.7 of the Reference Manual or in the licenses.html
file that is included in this package.
