RSS

Meshlium Manager System 2.0 instalation

How to get Meshlium Manager System 2.0

Download source code
License

How to install Meshlium Manager System 2.0

Hardware dependencies.
Minimum requirements.
Decompress and instalation.
Tunning sytem to work with Meshlium Manager System 2.0

How to delete Meshlium Manager System 2.0 from a machine

Folder's to remove
Remove system modifications after instalation.

How to contribute to Meshlium Manager System project.

How to contribute with new plugins
How to contribute with code improvements
How to contribute with translations
How to contribute packaging Manager System

Developpers Guide - Index

Introduction

The following document describes how to download, install or delete Meshlium Manager System 2.0. Our aim is to provide a portable Open Source Manager System so we hope to complete this guide with information for installing on several architectures and distributions, but right now this document references to Meshlium architecture and Debian distribution, but as usual on linux distributions this instalation can be ported to any linux distribution without much work.

How to get Meshlium Manager System 2.0

Meshlium manager system can be dowloaded as a tar.gz file with all the contents needed.

Download source code

Click here to download Meshlium Manager System as a .tar.gz file.

License

Meshlium Manager System is the Open Source router web manager designed by Libelium .
This web application is optimized to get the most of the Meshlium router, although it can be used in other network hardware with Linux system.
This software is Open Source and the code is released under the terms of the GPL2 License .

How to install Meshlium Manager System 2.0

Hardware dependencies.

As told before, Meshlium Manager System 2.0 has been developed and tested on Meshlium architecture. Meshlium architecture is x86 based. So Meshlium Manager System should work on any x86 32bit Debian.

Some of the base plugins are developed to work with some of the Meshlium components and it's particularities, if your install on a non Mehslium machine some plugins may not work propertly. Fortunatly you can modify plugins to work with your hardware and contribute to community with plugins adapted to different hardware. The plugin structure of Meshlium Manager System make it easy to add, modify or study plugins.

Minimum requirements.

The instalation of Meshlium Manager system requires Apache and PHP5 mod installed and running. Probably Meshlium Manager System should works on other web servers that support PHP5 like Lighttpd.

Decompress and instalation.

Once the tar.gz file has been downloaded, those are the steps needed to install Meshlium Manager System:

Open a terminal and navigate to the path that contains the Meshlium Manager System 2.0 tar.gz file.
To decompress the file execute:

tar zxvf filename.tar.gz

Move the uncompressed data to a path that can be read by apache daemon. For example to /var/www

sudo mv path_to_the_folder /var/ww

Change ownership to www-data

sudo chown -R www-data:www-data /var/www/folder_name

Open firefox and point web browser to load the folder.

http://localhost/folder_name

Tunning sytem to work with Meshlium Manager System 2.0

Meshlium Manager System 2.0 usually has to change system files. To make it possible you can add www-data to sudoers and configure it for no password need. This can be a security hole. So be sure web application on server are secure before doing it.

Some Meshlium Manager System 2.0 plugins needs aditional binaries or scripts to work.
Those plugins holds a copy of that scripts or binaries (also source code of the binaries) on folder bin or data inside the plugin structure.

How to delete Meshlium Manager System 2.0 from a machine

To delete Meshlium Manager System 2.0 from the system the folder containing Meshlium Manager System 2.0 should be removed and any change made to system files should be reverted.

Folder's to remove

Remove folder containing Meshlium Manager System 2.0. If you have changed ownership to www-data you may need to remove folder as root. So the user that will remove the folder should be on sudoers list.

sudo rm -rf /var/www/folder_name

Remove system modifications after instalation.

Revert changes made to sudoers file if needed. (We recomend the use of visudo for this)

Remove following line:

%www-data ALL=NOPASSWD: /var/www/meshlium/bin/

How to contribute to Open Source Router Web Manager project.

Meshlium Manager System 2.0 has been configured and tested to work on Meshlium as main hardware, but project's aim is to make Manager System functional in as many architectures and systems as possible.
You can help Manager System project contributing with your own plugins or ports to other architectures.
You can send you contributions to:

How to contribute with ports to other architectures

Open Source Router Web Manager has been tested to work with Meshlium but can be ported to other architectures. Modifications needed to make Open Source Router Web Manager works on other systems can be submited and will be avaible for download with Meshlium Manager System.

How to contribute with new plugins

Router services management is usually hardware dependent. That makes that each router and distribution needs it's own plugins, or need to make modifications to plugins to work with different hardware vendors.

If you develop or modify a plugin you can submit it to share it with the community.

Plugins will be avaible in diferent stages (stable and testing) and will be sorted by architecture or distribution too.

How to contribute with code improvements

Open Source Router Web Manager code is avaible for download. Probably you will find code improvemnts or security patches. You can report/submit all the stuff you find to improveOpen Source Router Web Manager stability and performance.

How to contribute with translations

English is the defaul language for Open Source Router Web Manager. You can help community with tranlations to other languages.

How to contribute packaging Manager System

Manager System is released as a .tgz with source code, you can help project making a package of Manager System for any package system such as .rpm or .deb

(*)

I have read and I accept the privacy policy

In order to comply with the provisions in Spanish Data Protection Act (L.O. 15/1999 of 13th December) and its implementing Regulation (R.D. 1720/2007, of 21st December), LIBELIUM hereby informs its Customers and websites users that any personal data supplied through the forms contained in its websites shall be recorded in a file named “CUSTOMERS” for which LIBELIUM is responsible, located at LIBELIUM´s registered address and which has been registered with the Spanish General Registry for Data Protection (Registro General de Protección de Datos de la Agencia Española de Protección de Datos).

Except for those fields expressly requesting compulsory filling, answers to the questions contained in any form are voluntary and therefore, the lack of answer does not imply a reduction of the quantity or quality of LIBELIUM´s services. The aim of this data collection are to provide access to LIBELIUM´s online shop, to send information on LIBELIUM´s Product(s) and services as well as to collect Customer’s acceptance to the terms of use of the forums and other sections in LIBELIUM´s websites. By filling these forms Customers consent in receiving promotional offers concerning LIBELIUM´s Product(s) and services. You further consent further that LIBELIUM may make such data available to its services suppliers to the sole purpose of enabling service provision.

Any User providing personal data through any of the forms in LIBELIUM´s websites shall count on a 30 day period to inform LIBELIUM in writing of his/her refusal to the processing of his/her personal data. Unless this communication is made, it shall be deemed that the User consents the processing of his/her personal data according to the terms set forth in these T&C. All personal data collected shall be processed by using the security measures requested by Law to avoid their loss, damage or access by any unauthorised third party. User may nevertheless be aware of the fact that the existing security measures for computer systems on the Internet are not entirely trustworthy. Should you think that your email address has been disclosed to us without your consent, do not hesitate to inform us thereof. Users may at any time exercise their rights of access, rectification, update, cancellation and objection, as well as revoke the consent granted for all of any of the above-mentioned processings, by sending a written statement to LIBELIUM, either through the “Contact” section in our website http://www.libelium.com or by post to the following address: LIBELIUM COMUNICACIONES DISTRIBUIDAS, S.L., c/ María de Luna, 11, nave 5, CEEIARAGON. 50018 Zaragoza (Spain).

To exercise the above-mentioned rights you must indicate your name, ID/passport number, full address, date and signature, including any document supporting your request, in case it is needed; a copy of your ID card/passport must be enclosed, unless you use an electronic signature. User shall be liable for the veracity of data provided and only in case of holders of parental rights concerning children under fourteen and in connection with said children, shall LIBELIUM accept the disclosure of personal data concerning third parties. Users shall assume all liability for direct or consequential damages arising out of or in connection with the provision of false, inaccurate, incomplete or non updated data.

Furthermore, LIBELIUM reserves its right to exclude from any service for which prior registration is required, to any User having provided false data or failing to comply with these T&C, notwithstanding any other legal action to which LIBELIUM may be entitled. LIBELIUM reserves its right to modify its Privacy Policy or these T&C to adapt them to the regulations in force or for any other reason. Provided that the use of LIBELIUM´s websites by Users shall be deemed as User’s acceptance of LIBELIUM´s Privacy Policy and T&C, User is hereby requested to check these T&C and any further amendments from time to time.

Privacy Policy
Users may visit LIBELIUM´s websites without disclosing neither their identity nor any personal data. LIBELIUM´s servers may only collect domain names but not email addresses of their visitors. This kind of information is used to elaborate reports on visit statistics, the time spent in the websites, websites accessed, the general origin of visitors (through “Favourites”, search engines, links from other websites, etc.) to the sole purposes of getting information on how the websites are used and improving their contents and services.

Linked sites
LIBELIUM´s websites may provide links to other sites but LIBELIUM assumes no liability on the privacy policies adopted by the linked sites, directly or indirectly. Links to other sites are provided as a suggestion only and do not imply LIBELIUM´s warranty or liability concerning their quality, accuracy or contents of the information provided therein.

LIBELIUM does not warrant the veracity or accuracy of the information disclosed by its suppliers or third parties whose products or services are offered through LIBELIUM, their origin, ownership or the use or practical implementation made by Customers.

(*) Mandatory fields

| Terms of use