                         UPGRADE to version 1.4.0


REMARKS
=======
      . The LES2800A version 1.3.3 or newer requires two Megabytes of memory
        per port (LES2800A-16 32M, LES2800A-32 64M). Use the command "free"
        to see if your LES2800A has the memory size required by this version.
        If your LES2800A has less than 2 Megabytes of memory per port, you can
        upgrade your LES2800A with the last version 1.1.x available only.

      . In this document we assume that the LES2800A is already running the new
        Linux Kernel Image (1.3.3) and that it will be the version used
        from now on.

      . For more information about new features, please read the up-to-date
        Release Notes and the BlackBox documentation.

      . For those who are new to Linux/Unix, we recommend reading appendix A
        in the BlackBox Manual.


UPGRADING OVERVIEW
==================

The LES2800A packages may be updated from one version to another. So, if the
user has a LES2800A running an earlier version, special care should be taken
regarding configuration.

The user can choose to start the configuration from scratch by simply doing:

    echo 0 > /proc/flash/script
    reboot

or, the user must perform all steps from all "Upgrading from <version> actions"
with version numbers equal to or greater than the original version of his
LES2800A.

To run a new configuration and save it into flash the user must execute
the following commands:

    signal_ras hup
    saveconf

The command "saveconf" is equivalent to the Linux command:

"tar -czf /proc/flash/script -T /etc/config_files"

so, double check that all files which have been changed have their names in the
file /etc/config_files.

If any of the files /etc/inittab, /etc/rc.sysinit, or any user's shell script
executed by /etc/rc.sysinit were changed, the LES2800A must be rebooted for
them to take effect.


Upgrading from 1.3.12 Actions
============================

- The permissions of the file must be changed. Execute the command:
  "chmod 600 /etc/websum.conf"

- The file /etc/snmpd.conf was renamed to /etc/snmpd.sh. If you had modified

- This version does not have support to Sentry's IPDU nor RPC's IPDU. 
  The files /etc/pm.sentry and /etc/pm.rpc22 were deleted.
  The file /etc/pmd.sh was changed. If there is one saved in flash it
  must be edit :
      old line - ConfigFiles="/etc/pm.cyclades /etc/pm.rpc22 /etc/pm.sentry"
      new line - ConfigFiles="/etc/pm.cyclades"

- The file /etc/group was changed, the "admin" group was inserted.
  If the file were not changed just replace it with the file /etc/group.save.
  Otherwise the administrator need to edit the file and insert the following
  line:
                admin::104:root<enter>

Upgrading from 1.3.11 Actions
============================

- The file /etc/snmpd.conf was renamed to /etc/snmpd.sh. If you had modified
  /etc/snmpd.conf, apply the same changes to /etc/snmpd.sh.

- The /etc/config_files contains a list of files that are saved to flash
  when you run "saveconf". If you had run "saveconf" with release 1.3.11,
  your /etc/config_files is loaded from the flash and you will not have
  the latest list. Please edit /etc/config_files, rename the file,
  /etc/snmpd.conf, to /etc/snmpd.sh and run "saveconf".


Upgrading from 1.3.10 Actions
============================

- No actions are required.

Upgrading from 1.3.9 Actions
============================

- The file /etc/TIMEZONE was changed. If there is one saved in flash
  it must be replaced/merged with /etc/TIMEZONE.save

- The sshd program was upgraded to version 3.7.1p2 and it needs a new
  configuration file.
  If the file /etc/ssh/sshd_config was not changed just replace it with
  the file /etc/ssh/sshd_config.save.  Otherwise the user should merge
  these files.

- The file /etc/rc.sysinit was changed. If there is one saved in flash 
  it must be replaced/merged with /etc/rc.sysinit.save.

- The file /etc/group was changed. It was included the group "pam" and 
  "pmusers". If the file was not changed just replace it with the 
  file /etc/group.save.
  Otherwise the user need to do the following commands : 
       #addgroup pam <enter>
       #addgroup pmusers <enter>
       #chgrp pmusers /bin/pm <enter>


Upgrading from 1.3.8 Actions
============================

- The file /etc/rc.sysinit was changed. It was removed the activation of
  inetd. If there is one saved in flash it must be replaced/merged with
  /etc/rc.sysinit.save.

- The file /etc/inittab was changed. The activation of the services snmpd,
  sshd, ntpclient, pmd, and syslog-ng were removed. Their activation are done
  by the shell script daemon.sh. If there is one saved in flash it must
  be replaced/merged with /etc/inittab.save.

- The file ntpclient.sh was removed. The ntpclient now is started by the shell
  script "daemon.sh", if it's enabled in the file /etc/ntpclient.conf 

- The file /etc/ntpclient.conf was changed. If there is one saved in flash
  it must be replaced/merged with /etc/ntpclient.save

Upgrading from 1.3.6 Actions
============================

- In LES2800A-1 the file /etc/inittab was changed. If there is
  one saved in flash it must be replaced/merged with /etc/inittab.save.

- The file /etc/inetd.conf was changed. If there is one saved in flash
  it must be replaced/merged with /etc/inetd.conf.save.

- The shell script /etc/rc.sysinit was changed. If there is one saved in flash
  it must be replaced/merged with /etc/rc.sysinit.save.

- The example about snmptrap in /etc/syslog-ng/syslog-ng.conf was changed.
  Please verify the change in /etc/syslog-ng/syslog-ng.save file.
 
- The file /etc/network/firewall has changed. If there is one saved in flash
  it must be replaced/merged with /etc/network/firewall.saves and the
  command "fwset restore" executed.

- The file /etc/portslave/pslave.conf has new parameters. If there is one
  saved in flash it must be replaced/merged with /etc/portslave/pslave.save.

- The file /etc/pam.conf has changed (ldapdownlocal/sshd). If there is one
  saved in flash it must be replaced/merged with /etc/pam.conf.save.

- The shell script /bin/handle_dhcp was changed. If there is one saved in flash
  it must be removed from flash.

- The shell script /etc/network/dhcpcd_cmd was changed. If there is one saved
  in flash, it must be merged with /etc/network/dhcpcd_cmd.save.
 
- The shell script /etc/network/st_routes was changed. The parameter "metric 3"
  was inserted in the route add of the default route.

- The file /etc/pm.cyclades was changed to be compatible with the AlterPath-PM
  version 1.0.8. If an older version of the AlterPath-PM is used, the user 
  should save the /etc/pm.cyclades from the 1.3.6 version before the 
  upgrade:
     >echo /etc/pm.cyclades>>/etc/config_files
     >saveconf

Upgrading from 1.3.5 Actions
============================

- The meaning of the parameter DTR_reset in pslave.conf file was changed.
  Please, read the documentation to set it to the proper value.

- The sshd program needs a new configuration file to fix a problem with sftp.
  If the file /etc/ssh/sshd_config was not changed just replace it with
  the file /etc/ssh/sshd_config.save.  Otherwise the user should merge
  these files.


Upgrading from 1.3.4 Actions
============================

- The web user management has changed, and, because of that, the file
  /etc/websum.conf has changed. In order for make the web server work, the
  user must do the following steps:
      From the prompt, type
          #cp /etc/websum.conf.save /etc/websum.conf
          #saveconf
          #reboot
      After the reboot, open a browser and point to the LES2800A IP address. Log
        in as root (password = tslinux).
      Go to the link Web User Management->Users, change the root password and
        create the users, classifying according to the privilege allowed to
        them (root, admin, monitor or user).
      Go to the link Web User Management->Load/Save Web Configuration and click
        the "Save Configuration" button.
      Go to the link Administration->Load/Save Configuration and click the
        "Save to Flash" button.

- The syslog-ng.conf file (syslog-ng configuration) was changed.
  This configuration allows syslog-ng to receive syslog messages from the
  Kernel. The user must copy /etc/syslog-ng/syslog-ng.save over
  /etc/syslog-ng/syslog-ng.conf and make his own changes again, if any.

- The configuration of the snmpd (/etc/snmp/snmpd.conf file) was changed.
  The upgrade has to be done in two steps:
  . First step.
    .. Save the file /etc/snmp/snmpd.conf, if it was changed.
    .. Edit the file /etc/config_files and remove the line related to snmp.
    .. Execute the command "saveconf" and reboot the LES2800A.
  . Second step.
    .. if the file /etc/snmp/snmpd.conf was changed the user should make his own
       changes again.
    .. Edit the file /etc/config_files and insert the line "/etc/snmp/snmpd.conf"
    .. Execute the command "saveconf".


Upgrading from 1.3.3 Actions
============================

- The new way to activate "ntpclient" requires a new "inittab" file. If
  /etc/config_files does not contain an entry for /etc/inittab, the user can
  skip this step, otherwise, he can use /etc/inittab.save to merge the new
  changes with the current /etc/inittab.

- Merge or copy /etc/config_files.save over /etc/config_files.

- The new feature, ldap, has been added as another authentication method.
  Users should merge or copy /etc/pam.conf.save over /etc/pam.conf.

- /etc/portslave/pslave.conf has two new parameters. They are: all.DB_mode and
  all.DTR_reset. For more infomation, please refer to the manual.
  Merge or copy /etc/portslave/pslave.save over /etc/portslave/pslave.conf.

- In clustering with sniff session, the parameter, all.admin_users, needs to be
  configured.

- /etc/network/dhcpcd_cmd has been changed. User must merge or copy
  /etc/network/dhcpcd_cmd.save over /etc/network/dhcpcd_cmd in order for
  dhcp to work properly.

