Overview

This is the user guide for the custom image created for TonidoPlug. The functionality of this custom image is to provide out-of-the-box LAMP stack functionality. This image also has some Tonido applications to enable easier management of a website hosted through the LAMP stack.

 

Contents

Custom LAMP image has these softwares:

  •        Ubuntu Linux 9.04
  •         Apache 2
  •         MySQL 5.0.5
  •         PHP 5.2.6
  •         Webmin 1.490

 

Features

  •        Full featured LAMP stack for hosting websites.
  •        Runs on an ultra-low-power device. [Power cost of $9 (@15cents per kwh) to run a website 365 days]
  •        Easy access to website directories from Windows, Mac OS X, and Linux in the intranet.
  •        Easy access to website configuration files from Windows, Mac OS X, and Linux in the intranet.
  •        Webmin tool to manage web server and database.
  •        Remotely accessible web-based explorer UI to manage files on the website.
  •        Remotely accessible web-based file sharing utility (Webshare Pro) to download and upload files.
  •        Remotely accessible web-based file search UI to search website files.
  •        Remotely accessible HTML-based website reports.

 

Procedure

  •        Download the custom image (compressed tar ball) from the link provided to you in the support email.
  •        Format a USB stick or USB hard disk with an EXT3 file system.
# sudo mkfs.ext3 /dev/sda1

Note: If you have multiple partitions in your USB drive, you have to always use the first partition, because the TonidoPlug will boot only from the first partition of the external drive.

  •        Once the formatting is completed, mount the partition on a temporary directory
# sudo mount /dev/sda1 /media/exthd/
  •        Copy the downloaded .tar.gz file to the USB stick or USB hard disk.
  •        Untar the custom image to the USB stick.
# cd /media/exthd/ # sudo tar zxvf ./lamp_rootfs.tar.gz

Note: You should use only tar command to untar the downloaded file. Failure to do so might result in plug not booting from USB disk due to file permission issues.

  •        Wait until the untar process is complete. Now unmount the disk.
# sudo umount /dev/sda1
  •       Power off TonidoPlug.
  •       Leave the USB stick/harddisk attached to the plug.
  •       Power on the TonidoPlug.
  •       Wait for a couple of minutes for the image to load. Access the URL http://<Tonido_Plug_IP>/ from a web browser.

 

       Optional: Create a Tonido profile to get a default dynamic DNS name and useful utilities such web based explorer, search and uploader.

       Optional: Log in to Webmin (username: admin, password: nosoup4u) to manage the Apache webserver and MySQL. (Default Webmin URL: http://<Tonido_Plug_IP>:10000/)

 

FAQ

 

       How can I place my web pages on the web server when connecting from same subnet?

You can use Samba to copy/delete files to/from the webserver. From Windows, open Explorer, type "\\Plug_IP_Address\" in the location box and press ENTER. You should be seeing two directories, "WebDir" and "WebConf". The website contents are under "WebDir". You can navigate to that directory and copy/remove files to make your website.

 

       How can I place my web pages on the web server when connecting from the Internet?

You can use Tonido WebsharePro bundled in this image to do that.

 

       How can I edit my website configurations from same subnet?

You can use Samba to edit configuration files of the webserver. From Windows, open Explorer, type "\\Plug_IP_Address\" in the location box and press ENTER. You should be seeing two directories "WebDir" and "WebConf". The website configuration files are under "WebConf". You can navigate to that directory and edit the config files using any text editor.

 

       How can I view my website access report?

Website access reports are provided by Webalizer. By default, the reports are available at  http://Plug_IP_Address/webalizer/

 

       How often are webalizer reports generated?

Access reports are generated incrementally every 60 minutes. This generation is performed by a Linux cron job.

  • No labels