Welcome to TP-LINK Tech Support Forum
+ Reply to Thread
Page 1 of 2 1 2 LastLast
Results 1 to 15 of 17
  1. #1

    Proper upgrade procedure from EAP Controller 2.4.8 to 2.5.3 on Linux

    Model : EAP245

    Hardware Version :

    Firmware Version :

    ISP : [/COLOR]

    Hi. I've been successfully running EAP controller software 2.4.8 for a few months now on (k)ubuntu 14.04. I'm considering upgrading to to 2.5.3, which would be my first upgrade. I have 2 APs (EAP225 and EAP245) in my environment. A couple questions about the upgrade.
    1. Do I need to uninstall 2.4.8 first (and create a backup config) or can I just run the installation for 2.5.3?
    2. Will I have to reconfigure anything other than the portal?
    3. Anything else I should know before upgrading?
    I'm mostly an if it ain't broke kind of person with important software. It looks like from the notes I wouldn't get a lot out of this upgrade (I use portal, but I wouldn't use the new features in this release). But if there are security fixes, or this makes it potentially easier to upgrade to other releases then I want to stay current, but I don't want to mess up my currently very stable config. Has this release been stable for folks? Any new features/bugs not in the notes you may guys have discovered?

    Thanks!

  2. #2
    1. Upgrading to 2.5.3 doesn't require the uninstallation of an old version.
    2. Portal config will be lost because 2.5.3 has a much different take on the portal. So you have to reconfigure portal other than anything else after the upgrade.
    3. In general, a new release would be securer because some bug fixes and optimization. You may consider to upgrade if you need more portal features and a more stable system.

    Notes from the TP-Link website
    1. Please upgrade your EAP to the latest firmware with a note "If you want to use new features of EAP Controller 2.5.3 or above, please upgrade your EAP to this Firmware".
    2. Once upgraded to this version of EAP Controller, you will NOT able to downgrade to an earlier version.
    3. Portal configuration will be lost after upgraded to Controller 2.5.X from 2.4.X or earlier version.
    4. Supporting 64-bit Linux operating system, including Ubuntu 14.04/16.04/17.04, CentOS 6.x/7.x and Fedora 20 or above.
    5. Require JRE 1.7 Java environment.

  3. #3
    Members R1D2 is on a distinguished road
    Join Date
    Dec 2015
    Posts
    1,643
    Quote Originally Posted by newlinux View Post
    1. Do I need to uninstall 2.4.8 first (and create a backup config) or can I just run the installation for 2.5.3?
    Yes. The install.sh will terminate with an error message "EAP Controller is already installed. Please uninstall it first." if an older version is installed already.

    You could also manually save the old software by just renaming the top-level directory (EAPC home dir). Then remove /etc/init.d/tpeap and /usr/bin/tpeap (both are just symlinks). This will let you install the new version.

    1. Anything else I should know before upgrading?
    Make a backup before installing the new version.

    But if there are security fixes, or this makes it potentially easier to upgrade to other releases then I want to stay current, but I don't want to mess up my currently very stable config. Has this release been stable for folks?
    Next version will fix some known problems of v2.5.3. Are you running the Controller in a private LAN or over the Internet?
    Last edited by R1D2; 01-05-2018 at 02:46.

  4. #4
    Quote Originally Posted by R1D2 View Post
    Next version will fix some known problems of v2.5.3. Are you running the Controller in a private LAN or over the Internet?
    Thanks for you help. I'm running this in a private LAN. Just trying to decide if it is worth it to upgrade. Sounds like it should be pretty straight forward. I have a lot of other things I maintain in my free time, so when something is stable I try to pick the right time to upgrade. But if it is low risk and easy and not expected to take much time then I'll do it to stay current.

  5. #5
    Well, I went ahead and upgraded. Was a little worried because I had to start the controller three times before it was fully successful. First time (automatic after install) failed. Second time said it was successful, but I couldn't connect to the management interface. Third time was the charm. Reconfiguring portal was easy. Miss my terms of service, which I assume was an oversight and will be back in a future release (And I have to go find what I had there - forgot to save that! - I'm sure it's in a document somewhere Or I'll re-write.


    I thought I already posted this - but to answer your question, R1D2, this controller is run on a private LAN.
    Last edited by newlinux; 01-05-2018 at 18:13.

  6. #6
    One other strange thing... My maps are gone. And not just the maps. The whole tabbed interface is blank - so I have no way to add a map. I click on the map tab and I get a nothing but the settings control underneath the main nav. Everything in between is blank...

  7. #7
    Members R1D2 is on a distinguished road
    Join Date
    Dec 2015
    Posts
    1,643
    Strange. Did you clear the browser cache? Maps work fine here. Map images can be found under /opt/tplink/EAPController/data/map/ (that's one reason why saving the old installation is better than just uninstalling/installing cycle).

    Did you make a backup? Does the directory /opt/tplink/eap_db_backup exist? if so look for the TAR archives eap.db.tar.gz and eap.map.tar.gz in this directory. Importing a backup can be done manually by untaring those archives into the new EAPController/data directory.

  8. #8
    I didn't clear the browser cache, but I did try different browsers that I hadn't used to access it before - same issue.

    I created a backup in the uninstall process. I have a eap.db.tar.gz, but not an eap.map.tar.gz file in that directory. no images in the .../data/map/directory
    The map functionality simply doesn't seem to exist. I'm tempted to reinstall. The tab just gives me a blank page - no controls or anything - on all browsers I tried. i wouldn't mind re adding the maps, but I have no way to do so via the interface...

    What is normally in the map tar ball? Maybe I can recreate it manually and see if I can get the functionality back...

  9. #9
    Members R1D2 is on a distinguished road
    Join Date
    Dec 2015
    Posts
    1,643
    The map TAR archive just contains the map files from directory EAPC_HOME/data/map, see the code in uninstall.sh:

    Code:
        #backup map,solve Bug 189651
        tar zcvf $MAP_FILE_NAME map
        cp -f $MAP_FILE_NAME $BACKUP_FOLDER/
    But as I wrote: it's much better to just rename the old installation instead of overwriting the files, that's as easy as manually executing a single mv command and it will become a non-destructive update. I always save old versions of the complete EAPController directory when installing new versions.

    I would suggest to re-install the EAP Controller and test it before installing the DB backup. Do the missing tabs appear then?
    Last edited by R1D2; 01-06-2018 at 14:21.

  10. #10
    Quote Originally Posted by R1D2 View Post
    The map TAR archive just contains the map files from directory EAPC_HOME/data/map, see the code in uninstall.sh:

    Code:
        #backup map,solve Bug 189651
        tar zcvf $MAP_FILE_NAME map
        cp -f $MAP_FILE_NAME $BACKUP_FOLDER/
    But as I wrote: it's much better to just rename the old installation instead of overwriting the files, that's as easy as manually executing a single mv command and it will become a non-destructive update. I always save old versions of the complete EAPController directory when installing new versions.

    I would suggest to re-install the EAP Controller and test it before installing the DB backup. Do the missing tabs appear then?
    Yeah, I was curious what exactly the map files are in tar ball - beyond the user supplied images. If it is a config file or files I could possibly reconstruct. Binary files, not so much.
    Since I have backups of the configurations and recreating the maps is easy, I didn't see the need to back up the entire directory. However, I shouldn't need to have a backup to just to maintain the functionality of recreating the maps. I plan on reinstalling when I have another good window to reinstall. It is only the Map tab that isn't present that displays a blank page. The other tabs have all the previous functionality. The maps I had in there were just a nice to have, so not really a priority for me. I might just wait until another version comes out.

    Does a new installation normally have anything in the EAPC_HOME/data/map folder? Looking at the controller tar ball and the install.sh file I don't think so. If a new installation typically is blank, as mine is, there was problably a problem somewhere else in the install.

  11. #11
    Members R1D2 is on a distinguished road
    Join Date
    Dec 2015
    Posts
    1,643
    The map directory just contains the images uploaded as maps. Coordinates of APs on the maps etc. are probably saved in the database or elsewhere. The latter is only a guess, since unfortunately there is no documentation available for the scheme used by EAP Controller.
    Last edited by R1D2; 01-06-2018 at 17:09.

  12. #12
    Does having a accurate map make a difference in regards to performance or is it just used for visual identification of APs?

    Also I haven't found a way to upload multiple maps ie different floors.

  13. #13
    Members R1D2 is on a distinguished road
    Join Date
    Dec 2015
    Posts
    1,643
    Quote Originally Posted by johnsnow View Post
    Does having a accurate map make a difference in regards to performance or is it just used for visual identification of APs?
    Maps are just eye candy, not related to performance of the APs.

    Also I haven't found a way to upload multiple maps ie different floors.
    Just add more maps and name them appropriately (e.g. 1st floor, 2nd floor etc.)

  14. #14
    Did an uninstall and reinstall. Same problem. Next thought is to uninstall, blow away the directory structure, install, and manually import the configuration from a backup .bin. For some other day...

  15. #15
    For whatever it is worth I solved the map problem. I decided to dig a bit more into the code using standard chromium inspection tools. After following the code a bit I found the jave exception being thrown when the map page comes up. getMapFile was throwing a java.io.FileNotFoundException for all 3 of my map files, even though I had copied them into the /opt/tplink/EAPController/data/map/ directory. But for some reason, the code was looking for the filenames of the map files I uploaded prepended with a Unix epoch timestamp (e.g. 1513197133220_MainFloor.jpg -- I had named the file MainFloor.jpg). I traced to find the name it was looking for each of my map files and then changed the names and all is working again. Not sure where the name change came in. I didn't name them that way in the old installation, but perhaps the names were changed after upload? But it didn't backup the files in a tarball either so who knows what happened.

    Anybody know when Omada 2.6.0 for Linux is coming out?


 

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts

Copyright 1996-2018 TP-LINK Technologies Co., Ltd. All rights reserved.