|
|
| (16 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{Languages}} | + | {{Languages|Hardware_Info}} |
| | + | === Mainteneur === |
| | + | jpl (Contrib) |
| | | | |
| − | ===Maintainer===
| + | ===Version=== |
| − | [[User:VIP-ire|Daniel B.]]<br/>
| + | {{#smeversion: smeserver-hwinfo }} |
| − | [http://www.firewall-services.com Firewall Services]<br>
| |
| − | mailto:daniel@firewall-services.com
| |
| − | | |
| − | | |
| − | === Version === | |
| − | {{ #smeversion:smeserver-freepbx }} | |
| − | {{ #smeversion:freepbx-src }}
| |
| − | | |
| − | === Description ===
| |
| − | | |
| − | [http://freepbx.org FreePBX] is a full-featured PBX web application. If you’ve looked into Asterisk, you know that it doesn’t come with any "built in" programming. You can’t plug a phone into it and make it work without editing configuration files, writing dialplans, and various messing about.
| |
| − | | |
| − | FreePBX simplifies this by giving you pre-programmed functionality accessible by a user-friendly web interfaces that allows you to have a fully functional PBX pretty much straight away with no programming required. Some of the features that FreePBX supports out of the box are:
| |
| − | | |
| − | *Unlimited number of Voicemail boxes
| |
| − | *"Follow Me" functionality
| |
| − | *Ring Groups with calls confirmation (so if, eg, a cellphone is out of range and diverts to voicemail, all the other phones keep ringing)
| |
| − | *Unlimited number of Conferences (limited by available CPU power - about 300 simultaneous users in conferences on a P4 3ghz - 600 with a dual core!)
| |
| − | *Paging and Intercom functionality for man SIP phones that support it.
| |
| − | *Music on Hold (via MP3s, or streamed off the internet)
| |
| − | *Call Queues
| |
| − | *And many other features
| |
| − | | |
| − | | |
| − | === Requirements ===
| |
| − | *SME Server 7.X
| |
| − | *You may also want some hardware cards if you don't want your installation to be IP only. I've tested successfully the TDM400P, TDM410P and b410P (misdn) from Digium, but any card supported by DAHDI (should be anything working with zaptel) should work.
| |
| − | | |
| − | === Installation ===
| |
| − | | |
| − | {{Warning box|FreePBX will manage all asterisk configuration. If you have already configured asterisk by hands, you should backup everything. Of course, you'll latter be able to customize some parts of the diaplan, but in special files. Also, FreePBX is NOT compatible with SAIL (it's an alternative)}}
| |
| − | | |
| − | | |
| − | *Install the rpms
| |
| − | yum --enablerepo=smecontribs install smeserver-freepbx
| |
| − | | |
| − | You may also want to install dahdi drivers (it's the new name for zaptel) if you have an hardware card supported
| |
| − | yum --enablerepo=smecontribs install dahdi-tools dahdi-linux dahdi-linux-kmdl-$(uname -r)
| |
| − | | |
| − | | |
| − | *Finish the installation
| |
| − | | |
| − | To finish the installation, you should issue the command
| |
| − | signal-event freepbx-update
| |
| − | | |
| − | The first time this event runs, it'll install FreePBX. You'll find installation's log in /root/freepbx_install.log
| |
| − | | |
| − | You should now be able to start using FreePBX on https://server.domain.tld/freepbx/admin
| |
| − | | |
| − | === Components ===
| |
| − | | |
| − | FreePBX is composed of 4 main parts: the main FreePBX interface, Recordings, Asterisk-Stats and Flash Operator Panel
| |
| − | | |
| − | ==== FreePBX ====
| |
| − | This is the main web interface for asterisk configuration. This interface is available at https://server.domain.tld/freepbx/admin, or in the server-manager, under FreePBX menu.
| |
| − | You'll need to login as admin (password of your admin's SME account) to access this part.
| |
| − | You can grant the access to any user of the system using the userpanel contrib (just grant the user or the group the permission to access freepbx panel)
| |
| − | | |
| − | | |
| − | ==== Recordings ====
| |
| − | Recordings, is a web based portal for users. You may configure some features of your phone here (followme, call forward, call waiting etc...), check you call history, or download/listen to your voicemail. This interface is available at https://server.domain.tld/recordings.
| |
| − | The login here is your phone (extension) number and your voicemail password.
| |
| − | There's also a special admin account. The admin account can access all call logs and recordings. The login is admin, the password is randomly generated, you can find it in /opt/freepbx/recordings/includes/main.conf.php
| |
| − | | |
| − | | |
| − | ==== Asterisk Stats ====
| |
| − | | |
| − | [http://www.areski.net/asterisk-stat-v2/about.php Asterisk-Stats] is an interface to query CDR (Call Detail Reports) database. It's available on the main FreePBX interface at https://server/domain.tls/freepbx, on the "Reports" tab
| |
| − | | |
| − | | |
| − | ==== Flash Operator Panel ====
| |
| − | [http://asternic.org/ Flash Operator Panel] is a switchboard type application for the Asterisk PBX. It runs on a web browser with the flash plugin. It is able to display information about your PBX activity in real time. The layout is configurable (button sizes and colours, icons, etc). The FOP is available at https://server.domain.tld/panel or in the main interface in the "Panel" tab.
| |
| − | | |
| − | You can grant the access to any user of the system using the userpanel contrib (just grant the user or the group the permission to access fop panel)
| |
| − | | |
| − | === DB parameters ===
| |
| − | | |
| − | Here's the list of DB parameters:
| |
| − | | |
| − | This contrib add 3 entries in the configuration db: freepbx, dahdi and fop. Here's a description of available parameters for each entry
| |
| − | | |
| − | *'''freepbx'''
| |
| − | **'''CdrDbName''': the name of the database for CDR. The default is asteriskcdrdb. You should let this unless you know what you're doing
| |
| − | **'''DbName''': the name of the database for FreePBX. The default is freepbxdb. You should let this unless you know what you're doing
| |
| − | **'''DbPassword''': the password to access FreePBX database. A random value is generated at install time.
| |
| − | **'''DbUser''': the username to access both databases. Default is freepbxuser
| |
| − | **'''DeviceAndUser''': (enabled|disabled) You can enable the 'deviceanduser' display view of FreePBX. DeviceAndUser is enabled, Devices and Users will be administered separately, and Users will be able to "login" to (adhoc) devices. If disabled Devices and Users will me administered in a single screen.
| |
| − | **'''ManagerPassword''': This is the asterisk manager password used by FreePBX (the login is 'admin'). The default one is randomly generated at install time.
| |
| − | **'''UDPPorts''': Lists of ports used by asterisk. This settings is only useful if you want to open asterisk on the public interface (you can also restrict it with AllowHost parameter)
| |
| − | **'''access''': (private|public). if you want to open asterisk on the public interface, you can set this to public.
| |
| − | **'''status''': (enabled|disabled). Should asterisk (with FreePBX provided helper script) should be started automatically.
| |
| − | | |
| − | *'''fop'''
| |
| − | **'''status''': (enabled|disabled) Should we start the FOP server with FreePBX ?
| |
| − | **'''Password''': This is the additional password for FOP. There's a first password needed to access FOP (by default, only admin is allowed). This first password is your SME account password. The second password (the one on this db parameter) allow users to use drag/drop on the different items (transfer call, initiate a call, hangup etc...). The default password is a random generated one at install time.
| |
| − | **'''TCPPort''': This is the TCP port used for the communication between the flash applet and FOP daemon. The default is 4445
| |
| − | **'''access''': The default is to allow only connections from the local network. You can allow external IP if you configure '''public''' here (and if you do so, you should limit this access to a list of IP using the AllowHost key)
| |
| − | | |
| − | *'''dahdi'''
| |
| − | **'''status''': (enabled|disabled) You should let this to enabled, even if you don't have any hardware card because some functions (like meetme) requires the dahdi_dummy driver to be loaded.
| |
| − | | |
| − | ===Related pages===
| |
| − | You may be interested in the following how-to:
| |
| − | *How-to configure your card using [[FreePBX/DAHDI|DAHDI]]
| |
| − | *How-to configure your card using [[FreePBX/mISDN|mISDN]]
| |
| − | | |
| − | === Uninstall ===
| |
| − | yum remove smeserver-freepbx freepbx-src
| |
| − | | |
| − | If you want to cleanup everything (MySQL databases, DB, etc...), you can use this script:
| |
| − | | |
| − | | |
| − | | |
| − | #!/bin/bash
| |
| − |
| |
| − | clear
| |
| − | echo "----------------------------"
| |
| − | echo "!!!!! WARNING !!!!!"
| |
| − | echo "----------------------------"
| |
| − | echo ""
| |
| − | echo "This script will remove from your server:"
| |
| − | echo " - freepbx and asterisk cdr MySQL databases"
| |
| − | echo " - freepbx MySQL User"
| |
| − | echo " - freepbx DB entries (freepbx, httpd-fpbx and dahdi)"
| |
| − | echo " - /opt/freepbx"
| |
| − | echo ""
| |
| − | echo -n "Are you sure you want to remove FreePBX permanently ? (y/n) [n] "
| |
| − | read confirm
| |
| − | if [ "$confirm" = "y" -o "$confirm" = "Y" ]; then
| |
| − | echo "Droping MySQL databases..."
| |
| − | DBNAME=$(/sbin/e-smith/db configuration getprop freepbx DbName)
| |
| − | CDRDBNAME=$(/sbin/e-smith/db configuration getprop freepbx CdrDbName)
| |
| − | mysql -e "DROP DATABASE $DBNAME"
| |
| − | mysql -e "DROP DATABASE $CDRDBNAME"
| |
| − | echo "Deleting MySQL User..."
| |
| − | DBUSER=$(/sbin/e-smith/db configuration getprop freepbx DbUser)
| |
| − | mysql -u root -e "REVOKE ALL PRIVILEGES ON *.* FROM '$DBUSER'@'localhost';"
| |
| − | mysql -u root -e "DROP USER '$DBUSER'@'localhost';" > /dev/null 2>&1
| |
| − | echo "Removing SME DB entries..."
| |
| − | /sbin/e-smith/db configuration delete freepbx
| |
| − | /sbin/e-smith/db configuration delete httpd-fpbx
| |
| − | /sbin/e-smith/db configuration delete dahdi
| |
| − | echo "Removing /opt/freepbx ..."
| |
| − | rm -rf /opt/freepbx
| |
| − | echo "Done!"
| |
| − | fi
| |
| − | | |
| − | | |
| − | | |
| − | | |
| − | === Bugs ===
| |
| − | Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
| |
| − | and select the smeserver-freepbx component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-freepbx|title=this link}}
| |
| − | | |
| − | ----
| |
| − | [[Category:Contrib]]
| |
| − | {{Languages}}
| |
| − | | |
| − | ===Maintainer===
| |
| − | [[User:VIP-ire|Daniel B.]]<br/>
| |
| − | [http://www.firewall-services.com Firewall Services]<br>
| |
| − | mailto:daniel@firewall-services.com
| |
| − | | |
| − | | |
| − | === Version ===
| |
| − | {{ #smeversion:smeserver-freepbx }}
| |
| − | {{ #smeversion:freepbx-src }}
| |
| | | | |
| | === Description === | | === Description === |
| − | | + | Cette contribution ajoute un nouveau panneau d'information du matériel dans le gestionnaire du serveur pour lancer et afficher un rapport détaillé du matériel de votre serveur en utilisant lshw (http://ezix.org/project/wiki/HardwareLiSter), sur SME Server. |
| − | [http://freepbx.org FreePBX] is a full-featured PBX web application. If you’ve looked into Asterisk, you know that it doesn’t come with any "built in" programming. You can’t plug a phone into it and make it work without editing configuration files, writing dialplans, and various messing about.
| |
| − | | |
| − | FreePBX simplifies this by giving you pre-programmed functionality accessible by a user-friendly web interfaces that allows you to have a fully functional PBX pretty much straight away with no programming required. Some of the features that FreePBX supports out of the box are:
| |
| − | | |
| − | *Unlimited number of Voicemail boxes
| |
| − | *"Follow Me" functionality
| |
| − | *Ring Groups with calls confirmation (so if, eg, a cellphone is out of range and diverts to voicemail, all the other phones keep ringing)
| |
| − | *Unlimited number of Conferences (limited by available CPU power - about 300 simultaneous users in conferences on a P4 3ghz - 600 with a dual core!)
| |
| − | *Paging and Intercom functionality for man SIP phones that support it.
| |
| − | *Music on Hold (via MP3s, or streamed off the internet)
| |
| − | *Call Queues
| |
| − | *And many other features
| |
| − | | |
| − | | |
| − | === Requirements ===
| |
| − | *SME Server 7.X
| |
| − | *You may also want some hardware cards if you don't want your installation to be IP only. I've tested successfully the TDM400P, TDM410P and b410P (misdn) from Digium, but any card supported by DAHDI (should be anything working with zaptel) should work.
| |
| | | | |
| | === Installation === | | === Installation === |
| | | | |
| − | {{Warning box|FreePBX will manage all asterisk configuration. If you have already configured asterisk by hands, you should backup everything. Of course, you'll latter be able to customize some parts of the diaplan, but in special files. Also, FreePBX is NOT compatible with SAIL (it's an alternative)}}
| + | Installation de la contribution : |
| − | | |
| − | | |
| − | *Install the rpms
| |
| − | yum --enablerepo=smecontribs install smeserver-freepbx
| |
| − | | |
| − | You may also want to install dahdi drivers (it's the new name for zaptel) if you have an hardware card supported
| |
| − | yum --enablerepo=smecontribs install dahdi-tools dahdi-linux dahdi-linux-kmdl-$(uname -r)
| |
| − | | |
| − | | |
| − | *Finish the installation
| |
| − | | |
| − | To finish the installation, you should issue the command
| |
| − | signal-event freepbx-update
| |
| − | | |
| − | The first time this event runs, it'll install FreePBX. You'll find installation's log in /root/freepbx_install.log
| |
| − | | |
| − | You should now be able to start using FreePBX on https://server.domain.tld/freepbx/admin
| |
| − | | |
| − | === Components ===
| |
| − | | |
| − | FreePBX is composed of 4 main parts: the main FreePBX interface, Recordings, Asterisk-Stats and Flash Operator Panel
| |
| − | | |
| − | ==== FreePBX ====
| |
| − | This is the main web interface for asterisk configuration. This interface is available at https://server.domain.tld/freepbx/admin, or in the server-manager, under FreePBX menu.
| |
| − | You'll need to login as admin (password of your admin's SME account) to access this part.
| |
| − | You can grant the access to any user of the system using the userpanel contrib (just grant the user or the group the permission to access freepbx panel)
| |
| − | | |
| − | | |
| − | ==== Recordings ====
| |
| − | Recordings, is a web based portal for users. You may configure some features of your phone here (followme, call forward, call waiting etc...), check you call history, or download/listen to your voicemail. This interface is available at https://server.domain.tld/recordings.
| |
| − | The login here is your phone (extension) number and your voicemail password.
| |
| − | There's also a special admin account. The admin account can access all call logs and recordings. The login is admin, the password is randomly generated, you can find it in /opt/freepbx/recordings/includes/main.conf.php
| |
| − | | |
| − | | |
| − | ==== Asterisk Stats ====
| |
| − | | |
| − | [http://www.areski.net/asterisk-stat-v2/about.php Asterisk-Stats] is an interface to query CDR (Call Detail Reports) database. It's available on the main FreePBX interface at https://server/domain.tls/freepbx, on the "Reports" tab
| |
| − | | |
| − | | |
| − | ==== Flash Operator Panel ====
| |
| − | [http://asternic.org/ Flash Operator Panel] is a switchboard type application for the Asterisk PBX. It runs on a web browser with the flash plugin. It is able to display information about your PBX activity in real time. The layout is configurable (button sizes and colours, icons, etc). The FOP is available at https://server.domain.tld/panel or in the main interface in the "Panel" tab.
| |
| − | | |
| − | You can grant the access to any user of the system using the userpanel contrib (just grant the user or the group the permission to access fop panel)
| |
| − | | |
| − | === DB parameters ===
| |
| − | | |
| − | Here's the list of DB parameters:
| |
| − | | |
| − | This contrib add 3 entries in the configuration db: freepbx, dahdi and fop. Here's a description of available parameters for each entry
| |
| − | | |
| − | *'''freepbx'''
| |
| − | **'''CdrDbName''': the name of the database for CDR. The default is asteriskcdrdb. You should let this unless you know what you're doing
| |
| − | **'''DbName''': the name of the database for FreePBX. The default is freepbxdb. You should let this unless you know what you're doing
| |
| − | **'''DbPassword''': the password to access FreePBX database. A random value is generated at install time.
| |
| − | **'''DbUser''': the username to access both databases. Default is freepbxuser
| |
| − | **'''DeviceAndUser''': (enabled|disabled) You can enable the 'deviceanduser' display view of FreePBX. DeviceAndUser is enabled, Devices and Users will be administered separately, and Users will be able to "login" to (adhoc) devices. If disabled Devices and Users will me administered in a single screen.
| |
| − | **'''ManagerPassword''': This is the asterisk manager password used by FreePBX (the login is 'admin'). The default one is randomly generated at install time.
| |
| − | **'''UDPPorts''': Lists of ports used by asterisk. This settings is only useful if you want to open asterisk on the public interface (you can also restrict it with AllowHost parameter)
| |
| − | **'''access''': (private|public). if you want to open asterisk on the public interface, you can set this to public.
| |
| − | **'''status''': (enabled|disabled). Should asterisk (with FreePBX provided helper script) should be started automatically.
| |
| − | | |
| − | *'''fop'''
| |
| − | **'''status''': (enabled|disabled) Should we start the FOP server with FreePBX ?
| |
| − | **'''Password''': This is the additional password for FOP. There's a first password needed to access FOP (by default, only admin is allowed). This first password is your SME account password. The second password (the one on this db parameter) allow users to use drag/drop on the different items (transfer call, initiate a call, hangup etc...). The default password is a random generated one at install time.
| |
| − | **'''TCPPort''': This is the TCP port used for the communication between the flash applet and FOP daemon. The default is 4445
| |
| − | **'''access''': The default is to allow only connections from the local network. You can allow external IP if you configure '''public''' here (and if you do so, you should limit this access to a list of IP using the AllowHost key)
| |
| − | | |
| − | *'''dahdi'''
| |
| − | **'''status''': (enabled|disabled) You should let this to enabled, even if you don't have any hardware card because some functions (like meetme) requires the dahdi_dummy driver to be loaded.
| |
| | | | |
| − | ===Related pages=== | + | <tabs container> |
| − | You may be interested in the following how-to:
| + | <tab name="Pour SME10"> |
| − | *How-to configure your card using [[FreePBX/DAHDI|DAHDI]]
| |
| − | *How-to configure your card using [[FreePBX/mISDN|mISDN]]
| |
| | | | |
| − | === Uninstall ===
| + | yum --enablerepo=smecontribs install smeserver-hwinfo |
| − | yum remove smeserver-freepbx freepbx-src | |
| | | | |
| − | If you want to cleanup everything (MySQL databases, DB, etc...), you can use this script:
| + | </tab> |
| | + | <tab name="Pour SME9"> |
| | | | |
| | + | yum install smeserver-hwinfo --enablerepo=smecontribs |
| | + | config set UnsavedChanges no |
| | + | </tab> |
| | + | <tab name="Pour SME8"> |
| | + | yum install --enablerepo=smecontribs smeserver-hwinfo |
| | + | config set UnsavedChanges no |
| | + | </tab> |
| | + | </tabs> |
| | + | ==== Vérifiez la version installée ==== |
| | + | yum info installed lshw smeserver-hwinfo |
| | | | |
| | + | ==== Désinstallation ==== |
| | + | yum remove lshw |
| | + | Cela va également supprimer smeserver-hwinfo |
| | | | |
| − | #!/bin/bash
| + | === Utilisation === |
| − |
| + | Connectez-vous au gestionnaire du serveur, trouvez une nouvelle ligne dans la rubrique "Configuration". |
| − | clear
| + | Il peut également être utilisé à partir de la console (en root) : |
| − | echo "----------------------------"
| + | lshw |
| − | echo "!!!!! WARNING !!!!!"
| |
| − | echo "----------------------------"
| |
| − | echo ""
| |
| − | echo "This script will remove from your server:"
| |
| − | echo " - freepbx and asterisk cdr MySQL databases"
| |
| − | echo " - freepbx MySQL User"
| |
| − | echo " - freepbx DB entries (freepbx, httpd-fpbx and dahdi)"
| |
| − | echo " - /opt/freepbx"
| |
| − | echo ""
| |
| − | echo -n "Are you sure you want to remove FreePBX permanently ? (y/n) [n] "
| |
| − | read confirm
| |
| − | if [ "$confirm" = "y" -o "$confirm" = "Y" ]; then
| |
| − | echo "Droping MySQL databases..."
| |
| − | DBNAME=$(/sbin/e-smith/db configuration getprop freepbx DbName)
| |
| − | CDRDBNAME=$(/sbin/e-smith/db configuration getprop freepbx CdrDbName)
| |
| − | mysql -e "DROP DATABASE $DBNAME"
| |
| − | mysql -e "DROP DATABASE $CDRDBNAME"
| |
| − | echo "Deleting MySQL User..."
| |
| − | DBUSER=$(/sbin/e-smith/db configuration getprop freepbx DbUser)
| |
| − | mysql -u root -e "REVOKE ALL PRIVILEGES ON *.* FROM '$DBUSER'@'localhost';"
| |
| − | mysql -u root -e "DROP USER '$DBUSER'@'localhost';" > /dev/null 2>&1
| |
| − | echo "Removing SME DB entries..."
| |
| − | /sbin/e-smith/db configuration delete freepbx
| |
| − | /sbin/e-smith/db configuration delete httpd-fpbx
| |
| − | /sbin/e-smith/db configuration delete dahdi
| |
| − | echo "Removing /opt/freepbx ..."
| |
| − | rm -rf /opt/freepbx
| |
| − | echo "Done!"
| |
| − | fi | |
| | | | |
| | + | === Information supplémentaire === |
| | + | [http://forums.contribs.org/index.php?topic=38352.0 Voir l'annonce de smeserver-hwinfo sur le forum de Koozali.] |
| | | | |
| | + | ==== Problèmes connus ==== |
| | + | Pour SMEserver avant la version 7.2 avec les mises à jour 'as per 2007-12-25', on pourrait (devrait?) utiliser plutôt lshw-2.11.1-1.el4.rf.i386.rpm. |
| | + | Pour voir le rapport de bogue [http://bugs.contribs.org/show_bug.cgi?id=3670 3670]. |
| | | | |
| | + | === Bogues === |
| | + | Merci de faire parvenir les problèmes à SME-Contribs sur{{BugzillaFileBug|product=SME%20Contribs|component=|title=bugzilla}}ou en utilisant{{BugzillaFileBug|product=SME%20Contribs|component=smeserver-hwinfo|title=ce lien}}. |
| | + | {{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-hwinfo |noresultsmessage="No open bugs found."}} |
| | | | |
| − | === Bugs === | + | ===Journal des modifications=== |
| − | Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
| + | Seules les versions publiées dans smecontrib sont listées ici. |
| − | and select the smeserver-freepbx component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-freepbx|title=this link}}
| |
| | | | |
| | + | {{#smechangelog: smeserver-hwinfo}} |
| | ---- | | ---- |
| − | [[Category:Contrib]] | + | [[Category: Contrib/fr]] |
| | + | [[Category: Administration/fr]] |
