Difference between revisions of "LinuxMCE Admin Website"

From LinuxMCE
Jump to: navigation, search
(Files & Media)
 
(82 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<p>The LinuxMCE Admin web site is used to setup and configure your LinuxMCE system.  It also allows you to do a lot of other tasks, like checking your voice-mail, organizing your media and so on.  The web site runs on your own LinuxMCE Core, and you can access it from a Web Browser on the Core, or any other computer in your home connected to the same network.  By default, the LinuxMCE Admin web site is not accessible outside your home--everything is stored on the Core in your home, and you can only access the web site from the computers in your home.  This makes the system completely secure, however, it prevents you from accessing the web site outside the home via the internet.  You can turn on internet access, allowing you to access the web site anywhere, however, for your security, we recommend you first read about the [[Security & Privacy Issues]].</p>
+
[[Category: Documentation]]
  
<p>Normally, from within your house, you access the website by opening any web browser (Internet Explorer, Mozilla, etc.) on any computer and going to http://dcerouter/
+
[[Category: Programmer's Guide]]
    Note this assumes that the name of your core is dcerouter, which is the default name if you use a Kick-Start CDOtherwise, substitute the real IP address or name of your core instead of "dcerouter".</p>
+
{| align="right"
 +
  | __TOC__
 +
  |}
 +
''<center><small>If you were directed here from your Admin page, see the [[:Help:Contents|Help section]].</small></center>''
 +
The LinuxMCE Admin web site is used to setup and configure your LinuxMCE system.  It also allows you to do a lot of other tasks, such as to check your voice-mail, organize your media, etcThe web site runs on the LinuxMCE Core. You can access it from the Core web browser, or from any other computer connected to the network.
  
<p>LinuxMCE is a very modular platform with a wide variety of optional modules and devices to do just about anything.  Plus you can have lots of [[media director]] computers connected, all with their own mix of modules too.  Generally, each module will have one or more web pages to configure or use that module.  The LinuxMCE Admin web site has a pull-down menu that lets you quickly access any of those pages.  So, the menu options for your particular home will be unique to your own configuration.  If, for example, you have a LinuxMCE telephone system, then your LinuxMCE Admin will have menu options to setup your phones, check your voice-mail, and so on.  Someone else who does not have a LinuxMCE phone system will not have those options.  Note that there is only 1 LinuxMCE Admin web site for the whole house, and it is used to configure any device within the house.  If you have a media director in your den, for example, and there is a camera attached to it, you will control and view that camera using the same LinuxMCE Admin web site running on the core.  The [[Media Directors]] do not have their own sites--everything runs on the [[Core]].</p>
+
==Access to the LinuxMCE Admin Website==
 +
===From a Core or Media Director desktop===
 +
* Choose '''Advanced''' -> '''Computing''' -> '''Web Admin''' from the menu
  
<p>The 2 menu options that you will always see no matter what modules you have in your installation are "Wizard" and "Advanced".  The "Wizard" is the normal way to configure and setup your LinuxMCE system.  When you choose Wizard, you will see a series of steps.  What steps you see will depend on what devices you have in your home.  However, all the pages in the Wizard section are intended to be simple for the average user and allow you to start using LinuxMCE with minimal effort and no technical skills.  If you are a techie or want to do development, there are more low level options under the "Advanced" level.  But regardless, you should always complete the wizard first since it's the fastest way to get going.</p>
+
===From within your home===
 +
You can access the LinuxMCE Admin website from any web browser (Mozilla Firefox, IE, Safari):
  
<p>The rest of the menu options are all specific to your particular mix of modules: security cameras, phone systems, etc.</p>
+
*In the browser address bar, type the URL ''<nowiki>http://&lt;core_ip&gt;/pluto-admin</nowiki>''.
 +
* From within the "internal" LinuxMCE LAN, for example:
 +
**''<nowiki>http://192.168.80.1/pluto-admin</nowiki>''
 +
***(This assumes the IP address range set by default at installation.)
  
<p>For a general overview of how the "Wizard" works and what is involved in setting up your LinuxMCE system, [[Wizard Pages]]. If you have a question about any page or form on the website, just click the "Help" button in the upper right part of the screen.  It is context sensitive, so it will take you straight to a help page that explains whatever you currently see on the screen.</p>
+
*You can also use the network name of the Core in place of the IP address. For example, if the Core was named "dcerouter" during the default installation, you could use:
 +
**''<nowiki>http://dcerouter/pluto-admin</nowiki>''
  
==LinuxMCE Admin Website Sections==
+
*From the "external" home LAN, the core_ip would be the LAN IP address of the core. If, for example, the core is at 192.168.0.50 on the home LAN, use:
 +
**''<nowiki>http://192.168.0.50/pluto-admin</nowiki>''
 +
 
 +
===From the Internet===
 +
You could use the IP address:port for your home LAN, with port forwarding to the Core's LAN IP address (enabled by your home LAN router).
 +
*''This is an advanced topic and may not be secure in the current version.''.
 +
 
 +
By default, the LinuxMCE Admin web site is not accessible outside your home. This makes the system secure, but it prevents you from accessing the web site via the Internet while away from home.  You can [[Outside_Access|turn on Internet access]], allowing access to the admin website anywhere. For your own security, however, we recommend you first read about [[Security & Privacy Issues]].
 +
 
 +
===Login page===
 +
*The login page should be displayed. Input an existing user name and password, then click "Login".
 +
 
 +
=LinuxMCE Admin Website Sections=
 +
 
 +
==Admin page structure==
 +
LinuxMCE is a modular platform with a wide variety of optional modules and devices. Generally, each module will have one or more web pages to configure when using that module.  The LinuxMCE Admin web site has a pull-down menu that lets you quickly access any of those pages.  The menu options for each particular home will be unique, depending on the configuration.
 +
 
 +
Two menu options will always be displayed.
 +
 
 +
*The ''[[Wizard Pages|Wizard]]'' is the commonly used way to configure and setup your LinuxMCE system.  When you choose Wizard, you will see a series of steps that depends on what devices you have installed in your home. The pages in the Wizard section are intended to be simple for the average user. Context-sensitive help is provided through a "Help" button.
 +
 
 +
*There are more low level options under the ''Advanced'' option.
 +
 
 +
==Wizard==
 
*[[Wizard Pages]]
 
*[[Wizard Pages]]
**[[Basic Info]]
+
===[[Basic Info]]===
***[[Installation]]
+
*[[Installation]]
***[[Users]]
+
*[[Users]]
***[[Rooms]]
+
*[[Rooms]]
***[[Keyboard Layout]]
+
*[[Email]]
**[[Devices]]
+
*[[Keyboard Layout]]
***Core
+
 
***[[Interfaces]]
+
===[[Devices]]===
***[[AV Devices| A/V Equipment]]
+
*Core
***[[Media Directors]]
+
*[[Interfaces]]
***[[Orbiters]]
+
*[[AV Devices| A/V Equipment]]
***[[Lights]]
+
*[[Media Directors]]
***[[Climate]]
+
*[[Orbiters]]
***[[Irrigation Devices]]
+
*[[Lights]]
***[[Security]]
+
*[[Climate]]
***[[Surveillance Cameras]]
+
*[[Irrigation Devices]]
***[[Phone Extensions| Phones]]
+
*[[Devices Security | Security]]
***[[Phone Lines]]
+
*[[Surveillance Cameras]]
***[[Generic Serial Devices]]
+
*[[Phone Extensions| Phones]]
***[[Floorplans |Floorplan Wizard]]
+
*[[Phone Lines]]
**[[Scenarios]]
+
*[[Generic Serial Devices]]
***[[Lighting Scenarios]]
+
*[[Floorplans |Floorplan Wizard]]
***[[Media Scenarios]]
+
===[[Scenarios]]===
***[[Climate Scenarios]]
+
*[[Lighting Scenarios]]
***[[Irrigation Scenarios]]
+
*[[Media Scenarios]]
***[[Scenarios Security| Security Scenarios]]
+
*[[Climate Scenarios]]
***[[Telecom| Telecom Scenarios]]
+
*[[Irrigation Scenarios]]
***[[Mobile Orbiter Scenarios]]
+
*[[Security Scenarios]]
***[[Sleeping Scenarios]]
+
*[[Telecom Scenarios]]
**[[Events]]
+
*[[Mobile Orbiter Scenarios]]
***[[Respond to Events]]
+
*[[Sleeping Scenarios]]
***[[Timed Events]]
+
 
***[[Settings By Alert Type]]
+
===[[Events | Events Handler]]===
***[[Active sensors]]
+
*[[Respond to Events]]
***[[Security-Video Links]]
+
*[[Timed Events]]
***[[Notifications| Cellphone Notifications]]
+
===Security===
***[[Outside Access]]
+
*[[Settings By Alert Type]]
*[[Advanced Pages]]
+
*[[Active sensors]]
**[[Device Templates]]
+
*[[Security-Video Links]]
***[[List Page]]
+
*[[Notifications| Cellphone Notifications]]
***[[Edit Page]]
+
*[[Outside Access]]
***[[Design Objects]]
+
===[[Restart]]===
**[[Packages]]
+
 
**[[Advanced Pages Devices]]
+
==Advanced==
**[[Advanced Pages Scenarios]]
+
===Software===
**[[Boot Sequence]]
+
*[[Add Software]]
**[[Network Settings]]
+
*[[Software Versions]]
**[[Add Software]]
+
*[[Boot Sequence]]
**[[Privacy Settings]]
+
*[[Packages]]
**[[Advanced Pages Events]]
+
 
**[[DCE]]
+
===Network===
**[[Device Status]]
+
*[[Network Settings]]
**[[Execute Scenarios]]
+
*[[Firewall Rules]]
**[[Alert Logs]]
+
*[[WAP/GPRS Settings]]
**[[Mode Change Logs]]
+
*[[Dynamic DNS Settings]]
**[[Status]]
+
 
**[[View Cameras]]
+
===Configuration===
*[[Files&Media]]
+
* [[Advanced Pages Devices| Devices]]
**[[Cover Art]]
+
* Unknown Devices
 +
* [[Device Templates]]
 +
** [[Edit Device Template]]
 +
* Device Category Device Data
 +
* [[Advanced Pages Scenarios | Scenarios]]
 +
* [[Advanced Pages Events | Events]]
 +
* [[Phones Setup]]
 +
* [[Backup and Restore | Backups]]
 +
* [[Create_RAID_in_LMCE#Creating_RAID| RAID]]
 +
 
 +
===[[Privacy Settings]]===
 +
* [[Users#Users and Orbiters|Users-Orbiters]]
 +
* [[Users#Users and Rooms|Users-Rooms]]
 +
* [[Users#Restrict Access|Restrict Access]]
 +
 
 +
===sqlCVS===
 +
* Update
 +
* Checkin
 +
* Diff
 +
* View Batch
 +
 
 +
===[[DCE]]===
 +
* Device Data
 +
* Commands
 +
* Events
 +
 
 +
==Automation==
 +
*[[Device Status]]
 +
*[[Execute Scenarios]]
 +
==Security==
 +
*[[Alert Logs]]
 +
*[[Mode Change Logs]]
 +
*[[Status]]
 +
*[[View Cameras]]
 +
==Files & Media==
 +
* Media Browser
 +
* [[Media Files Sync]]
 +
* Playlist
 +
* Media Providers
 +
* Bookmarks
 +
* [[Cover Art]]
 +
* Ripping Status
 +
* [[Screen Saver]]
 +
 
 +
==Telecom==
 +
* My Voicemail
 +
* General Voicemail
 +
* Phone book
 +
* Call Routing
 +
* Priority Callers
 +
* Callers for me
 +
 
 +
The following is leftover from another page:
 +
 
 +
=Development=
 +
Doing development against the linuxMCE web administration requires acessing the files either locally with your editor of choice, or even remotely. Its also a good idea to install phpmyadmin, which will let you view the tables and such associated with the linuxMCE installation your working with. The web admin is located on your core in '''/var/www/lmce-admin''' and in the svn under 'web'.
 +
 
 +
It currently employs a large index file with case switching for the majority of pages, with those pages then leading to others relating to their specific function. The database also employs ADODB for most of the operations involving database transactions. Pages involve the use of template's with javascript objects writing data to the page. Please note, this is '''quite the basic''' overview.
 +
 
 +
==Network Share Method==
 +
 
 +
The most simple method of making '''/lmce-admin''' available for editing outside of the core on your local network involves modifying samba. Please note: samba fixes itself on reboot and  you will need to modify the config again to regain access to the files.
 +
 
 +
Edit '''/etc/samba/samba.conf''' and add this before the last line:
 +
 
 +
[www]
 +
comment = Web server files
 +
browseable = yes
 +
writable = yes
 +
create mask = 0770
 +
directory mask = 0770
 +
path = /var/www
 +
public = no
 +
guest ok = no
 +
force user = www-data
 +
force group = www-data
 +
 
 +
Then restart samba by typing into the console
 +
/etc/init.d/samba restart
 +
 
 +
And now the lmce-admin directory will appear as a share on the local network.
 +
 
 +
==Adding custom entries in LinuxMCE Admin menus==
 +
 
 +
Currently only option is to enter entries into Pluto_main database, table PageSetup. There you'll find other entries already, go to the end and add yours (but be careful not to break anything and also save your changes, cause they can probably lost in migration or updates - not sure)...
 +
 
 +
Anyway for simple test I've created two entries: "Tinia" as main menu entry (after Telecom) and then subentry for phpmyadmin that I frequently use. If I highlight only important fields, my entries look like this :
 +
 
 +
'''PK_PageSetup FK_..._Parent Website OrderNum FK_Package Description  pageURL                  showInTopMenu'''
 +
190      NULL          1  70  NULL  Tinia                                    1 
 +
191     190         1 0 NULL PHPMyAdmin  http://192.168.0.1/phpmyadmin/ 1
 +
 
 +
If FK_PageSetup_Parent is empty, then you'll have main entry on green main bar. If you want subentry, then you just specify PK_PageSetup of your parent in FK_PageSetup_Parent. You can also add URL

Latest revision as of 19:47, 3 December 2013

If you were directed here from your Admin page, see the Help section.

The LinuxMCE Admin web site is used to setup and configure your LinuxMCE system. It also allows you to do a lot of other tasks, such as to check your voice-mail, organize your media, etc. The web site runs on the LinuxMCE Core. You can access it from the Core web browser, or from any other computer connected to the network.

Access to the LinuxMCE Admin Website

From a Core or Media Director desktop

  • Choose Advanced -> Computing -> Web Admin from the menu

From within your home

You can access the LinuxMCE Admin website from any web browser (Mozilla Firefox, IE, Safari):

  • In the browser address bar, type the URL http://<core_ip>/pluto-admin.
  • From within the "internal" LinuxMCE LAN, for example:
    • http://192.168.80.1/pluto-admin
      • (This assumes the IP address range set by default at installation.)
  • You can also use the network name of the Core in place of the IP address. For example, if the Core was named "dcerouter" during the default installation, you could use:
    • http://dcerouter/pluto-admin
  • From the "external" home LAN, the core_ip would be the LAN IP address of the core. If, for example, the core is at 192.168.0.50 on the home LAN, use:
    • http://192.168.0.50/pluto-admin

From the Internet

You could use the IP address:port for your home LAN, with port forwarding to the Core's LAN IP address (enabled by your home LAN router).

  • This is an advanced topic and may not be secure in the current version..

By default, the LinuxMCE Admin web site is not accessible outside your home. This makes the system secure, but it prevents you from accessing the web site via the Internet while away from home. You can turn on Internet access, allowing access to the admin website anywhere. For your own security, however, we recommend you first read about Security & Privacy Issues.

Login page

  • The login page should be displayed. Input an existing user name and password, then click "Login".

LinuxMCE Admin Website Sections

Admin page structure

LinuxMCE is a modular platform with a wide variety of optional modules and devices. Generally, each module will have one or more web pages to configure when using that module. The LinuxMCE Admin web site has a pull-down menu that lets you quickly access any of those pages. The menu options for each particular home will be unique, depending on the configuration.

Two menu options will always be displayed.

  • The Wizard is the commonly used way to configure and setup your LinuxMCE system. When you choose Wizard, you will see a series of steps that depends on what devices you have installed in your home. The pages in the Wizard section are intended to be simple for the average user. Context-sensitive help is provided through a "Help" button.
  • There are more low level options under the Advanced option.

Wizard

Basic Info

Devices

Scenarios

Events Handler

Security

Restart

Advanced

Software

Network

Configuration

Privacy Settings

sqlCVS

  • Update
  • Checkin
  • Diff
  • View Batch

DCE

  • Device Data
  • Commands
  • Events

Automation

Security

Files & Media

Telecom

  • My Voicemail
  • General Voicemail
  • Phone book
  • Call Routing
  • Priority Callers
  • Callers for me

The following is leftover from another page:

Development

Doing development against the linuxMCE web administration requires acessing the files either locally with your editor of choice, or even remotely. Its also a good idea to install phpmyadmin, which will let you view the tables and such associated with the linuxMCE installation your working with. The web admin is located on your core in /var/www/lmce-admin and in the svn under 'web'.

It currently employs a large index file with case switching for the majority of pages, with those pages then leading to others relating to their specific function. The database also employs ADODB for most of the operations involving database transactions. Pages involve the use of template's with javascript objects writing data to the page. Please note, this is quite the basic overview.

Network Share Method

The most simple method of making /lmce-admin available for editing outside of the core on your local network involves modifying samba. Please note: samba fixes itself on reboot and you will need to modify the config again to regain access to the files.

Edit /etc/samba/samba.conf and add this before the last line:

[www]
comment = Web server files
browseable = yes
writable = yes
create mask = 0770
directory mask = 0770
path = /var/www
public = no
guest ok = no
force user = www-data
force group = www-data

Then restart samba by typing into the console

/etc/init.d/samba restart

And now the lmce-admin directory will appear as a share on the local network.

Adding custom entries in LinuxMCE Admin menus

Currently only option is to enter entries into Pluto_main database, table PageSetup. There you'll find other entries already, go to the end and add yours (but be careful not to break anything and also save your changes, cause they can probably lost in migration or updates - not sure)...

Anyway for simple test I've created two entries: "Tinia" as main menu entry (after Telecom) and then subentry for phpmyadmin that I frequently use. If I highlight only important fields, my entries look like this :

PK_PageSetup FK_..._Parent Website OrderNum FK_Package Description   pageURL                   showInTopMenu
190  	    NULL  	        1  	70  	NULL  	Tinia  	   	                                 1  	
191 	    190 	        1 	0 	NULL 	PHPMyAdmin   http://192.168.0.1/phpmyadmin/ 	1

If FK_PageSetup_Parent is empty, then you'll have main entry on green main bar. If you want subentry, then you just specify PK_PageSetup of your parent in FK_PageSetup_Parent. You can also add URL