Difference between revisions of "PhpSysInfo"

From Amahi Wiki
Jump to: navigation, search
m (phpSysInfo was missing the cap "S" and "I" in the tar transaction. Changed "nano config.conf" for nano config.php.)
 
(48 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==PHP SysInfo==
+
[[Category:Apps]]
 +
== Getting More Info ==
 +
After the one click install of phpsysinfo in Amahi 6 or greater, you need to do some modifications to get all system information displayed.
  
PHP SysInfo is a php script that displays information about the host being accessed. Things like uptime and CPU memory are displayed using phpsysinfo. To run it from your hda:
+
==Install lm-sensors ==
 +
=== Fedora ===
 +
open a terminal session and login as root or if you have sudo configured use sudo in front of all commands.  
  
1. Navigate to the /var/hda/web-apps directory on your hda.
+
type
 +
su -
 +
at the prompt enter your root password
  
2. Search for a phpsysinfo tarball through a web browser. You can find one at
+
then type
http://phpsysinfo.sourceforge.net/
+
yum install lm_sensors
 +
sensors-detect
  
3. Download the tarball into the web-apps directory using wget or another method. For example:
+
::'''NOTE:'''  <code>yum</code> (deprecated) has been replaced with <code>dnf</code> as the package manager for Fedora 23 and greater.
  
'''wget http://downloads.sourceforge.net/phpsysinfo/phpSysInfo-3.0-RC6.tar.gz'''
+
=== Ubuntu ===
  
 +
sudo apt-get install lm-sensors
 +
sudo sensors-detect
  
4. Unpack the phpsysinfo tarball with the tar command:
 
  
'''tar -zxvf phpSysInfo-3.0-RC6.tar.gz''' 
+
Answer the questions. At the end of sensors-detect, Type "yes" to have sensors-detect insert modules into /etc/modules, or edit /etc/modules yourself  service module-init-tools start
  
This will create a phpsysinfo directory and unpack all the files.
+
See [https://help.ubuntu.com/community/SensorInstallHowto#Install_and_Configure_lm-sensors Install and configure lm-sensors] for additional help.
  
 +
== Configure Settings ==
 +
first make a backup of your original configuration file
  
5. Remove the tarball since it will no longer be needed
+
cd /var/hda/web-apps/phpsysinfo/html
 +
cp phpsysinfo.ini phpsysinfo.inibak
  
'''rm -rf phpSysInfo-3.0-RC6.tar.gz'''
+
if neccessary
  
 +
yum install nano
  
6. Enter the new phpsysinfo directory: '''cd phpsysinfo'''
+
::'''NOTE:''' <code>yum</code> (deprecated) has been replaced with <code>dnf</code> as the package manager for Fedora 23 and greater.
  
7. Next, copy the php new configuration file to config.php using the cp command:
+
modify the configuration file
 +
nano phpsysinfo.ini
  
'''cp config.php.new config.php'''
+
optional changes
  
 +
DEFAULT_LANG="en"
 +
LOAD_BAR=true
 +
USE_VHOST=true
 +
SENSOR_PROGRAM="LMSensors"
 +
HDD_TEMP="command"
 +
HIDE_FS_TYPES="tmpfs,devtmpfs"
  
8. Use nano or another editor to modify config.php as desired. 
 
  
'''nano config.php'''
+
For Ubuntu run also
 +
sudo dpkg-reconfigure hddtemp
 +
and set suid to YES
  
 +
after saving phpsysinfo.ini phpsysinfo will provide voltage, fan, temperature data and more
  
9. Save and close the config.php file. Go to your hda Web Apps tab in a browser (http://setup then select Web Apps). Click on New Web App.
+
=== Configure SMART information ===
 +
Ref:  [http://mewbies.com/how_to_install_phpsysinfo_nix_tutorial.html How to install phpSysInfo]
  
10. Enter "phpsysinfo" in the Name field. The Root Path field will automatically append the directory name onto the /var/hda/web-apps directory.
+
yum install smartmontools
  
11. Click Create. A URL will be created and displayed.
+
::'''NOTE:'''  <code>yum</code> (deprecated) has been replaced with <code>dnf</code> as the package manager for Fedora 23 and greater.
  
12. PHPSysInfo should now be succesfully installed and running. To verify, click on the URL. If you are presented with your system information, phpsysinfo has been successfully installed.
+
In phpsysinfo.ini (located in ''/var/hda/web-apps/phpsysinfo/html'')<br />
 +
:<code>ADD_PATHS="/usr/sbin,/sbin"</code>
 +
:<code>PLUGINS="SMART"</code>
 +
:<code>DEVICES="/dev/sda,/dev/sdb"</code>
 +
 
 +
You also need to change the plugin script and give apache permission to use smartctl with the sudo command:
 +
 
 +
Because the cmd 'smartctl' is only available to root; it will not work for your web server, we need to set some permissions on it and change the command it uses:
 +
First we make a copy of the original
 +
cp /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php.bak
 +
 
 +
Now edit the following file:
 +
nano /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php
 +
Search for (Ctrl+w) (line 60): --all
 +
It has this:
 +
 
 +
:<code>if ( trim($diskname != "") && (CommonFunctions::executeProgram('smartctl', '--all'.' '.$diskdev.' '.$diskname, $buffer, PSI_DEBUG))) {</code>
 +
 
 +
Change it to:
 +
 
 +
:<code>if ( trim($diskname != "") && (CommonFunctions::executeProgram('sudo', 'smartctl --all '.' '.$diskdev.' '.$diskname, $buffer, PSI_DEBUG))) {</code>
 +
 
 +
Just a note that all we changed was:<br />
 +
:<code>'smartctl', '--all'</code>
 +
To:<br />
 +
:<code>'sudo', 'smartctl --all '</code>
 +
 
 +
Change yours to be the same, including the space: all '
 +
Be sure that line isn't broken into multiple lines. If it is you'll see on your ''xml.php?plugin=SMART'' page errors containing ''\n''
 +
And be sure that <code>smartctl</code> is the correct path.
 +
 
 +
Next we need to add your web server group to ''sudo'' to be able to run <code>smartctl</code> cmds:
 +
sudo visudo
 +
Paste in this line under ''# User privilege specification'', changing your
 +
web server group (apache) to your own. For example I have pasted in:<br />
 +
:<code>apache ALL=NOPASSWD: /usr/sbin/smartctl</code>

Latest revision as of 03:52, 18 June 2017

Getting More Info

After the one click install of phpsysinfo in Amahi 6 or greater, you need to do some modifications to get all system information displayed.

Install lm-sensors

Fedora

open a terminal session and login as root or if you have sudo configured use sudo in front of all commands.

type

su -

at the prompt enter your root password

then type

yum install lm_sensors
sensors-detect
NOTE: yum (deprecated) has been replaced with dnf as the package manager for Fedora 23 and greater.

Ubuntu

sudo apt-get install lm-sensors
sudo sensors-detect


Answer the questions. At the end of sensors-detect, Type "yes" to have sensors-detect insert modules into /etc/modules, or edit /etc/modules yourself service module-init-tools start

See Install and configure lm-sensors for additional help.

Configure Settings

first make a backup of your original configuration file

cd /var/hda/web-apps/phpsysinfo/html
cp phpsysinfo.ini phpsysinfo.inibak

if neccessary

yum install nano
NOTE: yum (deprecated) has been replaced with dnf as the package manager for Fedora 23 and greater.

modify the configuration file

nano phpsysinfo.ini

optional changes

DEFAULT_LANG="en"
LOAD_BAR=true
USE_VHOST=true
SENSOR_PROGRAM="LMSensors"
HDD_TEMP="command"
HIDE_FS_TYPES="tmpfs,devtmpfs"


For Ubuntu run also

sudo dpkg-reconfigure hddtemp

and set suid to YES

after saving phpsysinfo.ini phpsysinfo will provide voltage, fan, temperature data and more

Configure SMART information

Ref: How to install phpSysInfo

yum install smartmontools
NOTE: yum (deprecated) has been replaced with dnf as the package manager for Fedora 23 and greater.

In phpsysinfo.ini (located in /var/hda/web-apps/phpsysinfo/html)

ADD_PATHS="/usr/sbin,/sbin"
PLUGINS="SMART"
DEVICES="/dev/sda,/dev/sdb"

You also need to change the plugin script and give apache permission to use smartctl with the sudo command:

Because the cmd 'smartctl' is only available to root; it will not work for your web server, we need to set some permissions on it and change the command it uses: First we make a copy of the original

cp /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php.bak

Now edit the following file:

nano /var/hda/web-apps/phpsysinfo/html/plugins/smart/class.smart.inc.php

Search for (Ctrl+w) (line 60): --all It has this:

if ( trim($diskname != "") && (CommonFunctions::executeProgram('smartctl', '--all'.' '.$diskdev.' '.$diskname, $buffer, PSI_DEBUG))) {

Change it to:

if ( trim($diskname != "") && (CommonFunctions::executeProgram('sudo', 'smartctl --all '.' '.$diskdev.' '.$diskname, $buffer, PSI_DEBUG))) {

Just a note that all we changed was:

'smartctl', '--all'

To:

'sudo', 'smartctl --all '

Change yours to be the same, including the space: all ' Be sure that line isn't broken into multiple lines. If it is you'll see on your xml.php?plugin=SMART page errors containing \n And be sure that smartctl is the correct path.

Next we need to add your web server group to sudo to be able to run smartctl cmds:

sudo visudo

Paste in this line under # User privilege specification, changing your web server group (apache) to your own. For example I have pasted in:

apache ALL=NOPASSWD: /usr/sbin/smartctl