Differences

This shows you the differences between two versions of the page.

--- installation_guide:voximal [2017/06/23 11:49] – [Change the running user] borja
+++ installation_guide:voximal [2021/01/28 23:26] (current) – javier
@@ Line 1: / Line 1: @@
-===== Voximal : Voximal Module Installation  =====
+===== Voximal : Voximal Module Installation (and Upgrade)  =====
-{{:installation_guide:installation:speech_bubble_0.png?110|}}
 The Voximal module package install :
@@ Line 17: / Line 15: @@
 Dependencies
-  * Asterisk 1.6 ... 14.beta
+  * Asterisk 11 to 16
   * FreePBX 12-13 for the GUI/Web configuration interface)
-  * Xivo (tests)
+  * Isaabel (tests)
-  * Elsatix (tests)
 Note : You need to disable linuxSE (if you already installed Asterisk it should already done).
@@ Line 31: / Line 28: @@
   - Enter in the directory voximal* created.
   - Execute the install.sh script and follow the instructions (generaly answer 'y' for each questions).
-  - Restart your Asterisk,.
+  - Check if the script already restarted your Asterisk, if not start your Asterisk,.
-  - When done, you see a new application (CLI> voximal show version).
+  - When done, you see a new application, or and updated version (CLI> voximal show version).
   - If you use FreePBX you will see a new items in the web interface to manage the Voximal Application.
@@ Line 49: / Line 46: @@
 Restarting asterisk...............................................
 --- Voximal V14.0 installation has finished ---
+</code>
+==== Extended features of the install script ====
+<code>
+# ./install.sh -h
+Usage: ./install.sh [-d DIR ] [-u|-g] [-U user]
+  -d : install directory default is root /
+  -g : do not install gui modules
+  -u : do not generate uid.txt
+  -U : user for files permissions
+  -h : this help
 </code>
 ==== Change the user and group for Asterisk ====
-If you want to run Asterisk without using the standard asterisk user follow thos steps.
+The best option is to use the option -U in the installation script :
 <code>
+#./install.sh -U user:group
+</code>
+If you want to run Asterisk without using the standard asterisk user, and doing that yourself, follow those steps.
+<code>
+[root]# chown -R user:group /etc/asterisk/
 [root]# chown -R user:group /var/spool/asterisk/
 [root]# chown -R user:group /var/lib/asterisk/
 [root]# chown -R user:group /var/log/asterisk/
 </code>
+<code>
+[root]# chown -R user:group /var/log/voximal/
+[root]# chown -R user:group /var/cache/voximal/
+[root]# chown -R user:group /var/lib/voximal/vxml  #(for local VoiceXML pages)
+[root]# chown -R user:group /usr/share/voximal/
+</code>
+Check the deamon script and charge the reference to asterisk:asterisk to the chosen user:group.
+Example (with Centos 7 script) :
+<code>
+[Unit]
+Description=Asterisk PBX and telephony daemon
+Wants=network.target
+After=network.target
+[Service]
+Type=simple
+User=user  # instead of asterisk
+Group=group  # instead of asterisk
+Environment=HOME=/var/lib/asterisk
+WorkingDirectory=/var/lib/asterisk
+ExecStart=/usr/sbin/asterisk -f -C /etc/asterisk/asterisk.conf
+ExecStop=/usr/sbin/asterisk -rx 'core stop now'
+ExecReload=/usr/sbin/asterisk -rx 'core reload'
+# safe_asterisk emulation
+Restart=always
+RestartSec=10
+[Install]
+WantedBy=multi-user.target
+</code>
 ==== Configure Voximal from the Web interface ====