VOCAL (Vovida Open Communication Application Library)的安装

VOCAL (Vovida Open Communication Application Library)的安装軟體名稱 : VOCAL (Vovida Open Communication Application Library)

軟體版本 : 1.5.0

軟體網頁 : http://vovida.org

軟體下載 : http://www.vovida.org/applications/downloads/vocal/

要安裝VOCAL 1.5.0之前有些注意事項要知道

必須要有X window系統,gcc編譯器

所以在安裝RedHat 7.3/8.0/9.0 時需注意將X window系統及gcc編譯器裝上.

主機名稱及ip位址必須設定,不可以為127.0.0.1.

請先檢查 /etc/hosts 設定檔,如果只有127.0.0.1這一欄,請自行加入本機ip與主機名稱,例 :

127.0.0.1 localhost.localdomain localhost

xxx.xxx.xxx.xxx your_hostname

xxx.xxx.xxx.xxx請填主機所使用的ip位址,your_hostname 請填這台主機所要使用的主機名稱.

vocal server 必須要有 java 環境

java可由以下網址下載:

http://192.168.0.251/guest/files/j2re-1_4_2_03-linux-i586-rpm.bin

下載完畢之後執行

chmod +x j2re-1_4_2_03-linux-i586-rpm.bin

這樣使j2re-1_4_2_03-linux-i586-rpm.bin具有可執行屬性,然後執行:

j2re-1_4_2_03-linux-i586-rpm.bin

完畢之後會解出 j2re-1_4_2_03-linux-i586-rpm 的 rpm 檔案

執行下列程序安裝

rpm -ivh j2re-1_4_2_03-linux-i586-rpm

等程式執行完畢之後便會將java環境建立好.

PS : 如需節省系統硬碟空間,可將j2re-1_4_2_03-linux-i586-rpm.bin及j2re-1_4_2_03-linux-i586-rpm 這兩個檔案於安裝後刪除.

[/b]web server[/b]

如果希望能用web browser來作系統控制的話,就必須在vocal system上具備web server功能,所以在安裝RedHat linux時請記得選取web server並設定web server為啟動.

VOCAL 軟體安裝

軟體名稱 : VOCAL (Vovida Open Communication Application Library)

軟體版本 : 1.5.0

軟體網頁 : http://vovida.org

軟體下載 : http://www.vovida.org/applications/downloads/vocal/

安裝步驟 :

source code tar bell :

適用OS : RedHat 7.3

首先下載VOCAL 1.5.0的原始碼軟體

http://www.vovida.org/downloads/vocal/1.5.0/vocal-1.5.0.tar.gz

然後執行解壓縮

tar zxvf vocal-1.5.0.tar.gz

進入 vocal子目錄

cd vocal

./configure

make

make install

如果編譯過程正確,結果會看見 Congratulations:you have successfully installed VOCAL!

到此完成由source code tarball的安裝.

RPM 安裝 :

先下載適當的rpm檔案,依作業系統區分:

適用OS : RedHat 7.3

先下載以下rpm檔案

http://www.vovida.org/downloads/vocal/1.5.0/rh73/vocalbin-1.5.0-20.i386.rpm

http://www.vovida.org/downloads/vocal/1.5.0/rh73/vocalbin-tools-1.5.0-20.i386.rpm

http://www.vovida.org/downloads/vocal/1.5.0/rh73/AtaAuto-1.5.0-20.i386.rpm

http://www.vovida.org/downloads/vocal/1.5.0/rh73/sipset-1.5.0-20.i386.rpm

http://www.vovida.org/downloads/vocal/1.5.0/rh73/b2bua-1.5.0-20.i386.rpm

安裝rpm檔案 :

rpm -ivh vocalbin-1.5.0-20.i386.rpm

rpm -ivh vocalbin-tools-1.5.0-20.i386.rpm

rpm -ivh AtaAuto-1.5.0-20.i386.rpm

rpm -ivh sipset-1.5.0-20.i386.rpm

rpm -ivh b2bua-1.5.0-20.i386.rpm

照上述安裝完畢所有RPM檔案之後便完成RedHat 7.3軟體安裝.

適用OS : RedHat 8.0

先下載以下rpm檔案

http://ftp.wl0.org/vocal/rh8/AtaAuto-1.5.0-20.rh8.i386.rpm

http://ftp.wl0.org/vocal/rh8/b2bua-1.5.0-20.rh8.i386.rpm

http://ftp.wl0.org/vocal/rh8/sipset-1.5.0-20.rh8.i386.rpm

http://ftp.wl0.org/vocal/rh8/vocalbin-1.5.0-20.rh8.i386.rpm

http://ftp.wl0.org/vocal/rh8/vocalbin-tools-1.5.0-20.rh8.i386.rpm

安裝rpm檔案 :

rpm -ivh vocalbin-1.5.0-20.rh8.i386.rpm

rpm -ivh vocalbin-tools-1.5.0-20.rh8.i386.rpm

rpm -ivh AtaAuto-1.5.0-20.rh8.i386.rpm

rpm -ivh sipset-1.5.0-20.rh8.i386.rpm

rpm -ivh b2bua-1.5.0-20.rh8.i386.rpm

照上述安裝完畢所有RPM檔案之後便完成RedHat 8.0軟體安裝.

適用OS : RedHat 9.0

先下載以下rpm檔案

http://ftp.wl0.org/vocal/rh9/AtaAuto-1.5.0-21.rh9.i386.rpm

http://ftp.wl0.org/vocal/rh9/b2bua-1.5.0-21.rh9.i386.rpm

http://ftp.wl0.org/vocal/rh9/sipset-1.5.0-21.rh9.i386.rpm

http://ftp.wl0.org/vocal/rh9/vocalbin-1.5.0-21.rh9.i386.rpm

http://ftp.wl0.org/vocal/rh9/vocalbin-tools-1.5.0-21.rh9.i386.rpm

安裝rpm檔案 :

rpm -ivh vocalbin-1.5.0-21.rh9.i386.rpm

rpm -ivh vocalbin-tools-1.5.0-21.rh9.i386.rpm

rpm -ivh AtaAuto-1.5.0-21.rh9.i386.rpm

rpm -ivh sipset-1.5.0-21.rh9.i386.rpm

rpm -ivh b2bua-1.5.0-21.rh9.i386.rpm

照上述安裝完畢所有RPM檔案之後便完成RedHat 9.0軟體安裝.

三] VOCAL 系統設定

軟體名稱 : VOCAL (Vovida Open Communication Application Library)

軟體版本 : 1.5.0

軟體網頁 : http://vovida.org

軟體下載 : http://www.vovida.org/applications/downloads/vocal/

當vocal軟體安裝完畢之後需要做好設定vocal才可以執行,vocal本身具有彈性,可以將各種不同的service分別在不同的主機上執行,或者是都於同一台主機上執行,也就是具有scaling能力.

在建立一個普通的測試用系統上可以將所有的service都執行在同一台主機上,執行以下程式:

/usr/local/vocal/bin/allinoneconfigure/allinoneconfigure

會出現以下畫面 :

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

The following will destroy any VOCAL configuration that you

currently have on your system. If you would like to exit, press

Control-C now.

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

Please press Enter to continue, or q to quit []:

請按enter鍵繼續

I am using files from /usr/local/vocal/bin/allinoneconfigure. Is this OK? [y]:

請按y繼續

Welcome to the VOCAL all-in-one configuration system. This program is

intended to configure a small example system which has all of the

servers running on one box, known as an "all-in-one" system.

This all-in-one system is NOT intended as a production system, but as

a simple example to get users started using VOCAL.

This configuration WILL destroy any currently configured system on

this machine. If this is not acceptable, please quit by pressing

Control-C now.

Host IP Address [xxx.xxx.xxx.xxx]:

請輸入主機所在的ip位址

Remote Contact hostname or address (this should NOT be loopback or 127.0.0.1) [xxx.xxx.xxx.xxx]]:

請輸入主機所在的ip位址或是主機名稱,但輸入ip位址的話不可以為127.0.0.1

Multicast Heartbeat IP Address [224.0.0.100]:

直接按enter即可

Multicast Heartbeat Port (0 to deactivate heartbeat) [0]:

直接按enter即可

Log Level [LOG_NOTICE]:

直接按enter即可

User to run as [nobody]:

直接按enter即可

HTML directory to install .jar and .html files into

[/usr/local/vocal/html]:

直接按enter即可

CGI-BIN directory to install web-based provisioning cgi files into

[/usr/local/vocal/cgi-bin]:

直接按enter即可

Provisioning your VOCAL system requires the ability to view the

contents of /usr/local/vocal/html from the web. There are two ways to

do this -- review both options before answering the next prompt.

Option 1:

Step 1: Answer y to the next prompt. This will let this script

attempt to add the following to your Apache httpd.conf

file:

Alias /vocal "/usr/local/vocal/html"

AllowOverride None

Options ExecCGI

Order allow,deny

Allow from all

</Directory>

Adding this script creates an alias from the following URL:

http://vserver2/vocal/

which points to /usr/local/vocal/html .

Step 2: After this script has completed running, restart your copy

of Apache (httpd) for the change to take effect.

Option 2: Answer n to the next prompt. Then, manually copy the

directory /usr/local/vocal/html to HTML directory for your web server.

You should not need to restart your copy of Apache

after the script has completed running.

********

Add * HTML * directory alias

********

Would you like this script to attempt Option 1, Step 1 (y),

or would you like to perform Option 2 manually (n)? (If y,

you must restart Apache after this script has completed

running.) [y]:

請按y繼續

Directory where Apache's httpd.conf is located [/etc/httpd/conf]:

直接按enter即可

Would you like to enable the web-based configuration of VOCAL?

There are two ways to do this -- review both options before answering

the next prompt.

*******************************************************************

Warning Warning Warning Warning Warning Warning Warning Warning

*******************************************************************

Both of these options change your web server to run additional

code. Please make sure that you take a look at the code and are

comfortable running it on your web server.

Option 1:

Step 1: Answer y to the next prompt. This will let this script

attempt to add the following to your Apache httpd.conf

file:

ScriptAlias /vocalconf/ "/usr/local/vocal/cgi-bin"

AllowOverride None

Options ExecCGI

Order allow,deny

Allow from all

</Directory>

Adding this script creates an alias from the following URL:

http://vserver2/vocalconf/

which points to /usr/local/vocal/cgi-bin .

Step 2: After this script has completed running, restart your copy

of Apache (httpd) for the change to take effect.

Option 2: Answer n to the next prompt. Then, manually copy the

directory /usr/local/vocal/html to HTML directory for your web server.

You should not need to restart your copy of Apache

after the script has completed running.

-----------

Add - CGI-BIN - alias

-----------

Would you like this script to attempt Option 1, Step 1 (y),

or would you like to perform Option 2 manually (n)? (If y,

you must restart Apache after this script has completed

running.) [y]:

直接按enter即可

The apache web server runs CGI scripts as this user [apache]:

直接按enter即可

Would you like me to automatically generate a password

(enter y to generate a password, or n to choose your own) [n]:

這裡為設定系統密碼,作為日後進入系統的密碼憑證.密碼產生的方法有兩種,一種是由系統隨機產生的亂數,一種為使用者自行指定.想要由系統自動產生的話選y,要由使用者自訂的話選n.

一搬來說建議由使用者指定自己常用的密碼會比較好記,所以我選n[/n]

選n的話會出現

Enter Password:

Retype Password:

[b]輸入你要設定的密碼內容兩次以確保密碼正確性

選y的話螢幕上會出現一組亂數產生的密碼,請用紙筆將此密碼記下.

Path to openssl program, or none to not configure SSL support [/usr/bin/openssl]:

直接按enter即可

******************************

Configuration:

Host IP Address: 192.168.0.252

Remote Contact Address: 192.168.0.252

Multicast Heartbeat IP Address: 224.0.0.100

Multicast Heartbeat Port: 0

Log Level: LOG_NOTICE

User to run as: nobody

HTML directory: /usr/local/vocal/html

CGI directory: /usr/local/vocal/cgi-bin

Apache will run as: apache

Openssl: /usr/bin/openssl

Add alias to: /etc/httpd/conf/httpd.conf

Add CGI to: /etc/httpd/conf/httpd.conf

******************************

Continue []:

當出現以上文字時即表示設定已經完成,請檢查以上所有設定, 如果正確無誤請按y再按enter,如果不正確請按n再按enter放棄設定.

沒問題的話請按y再按enter繼續.

**********************************************************************

Beginning the VOCAL configuration process. This may take a few

seconds.

Generating RSA private key, 512 bit long modulus

......++++++++++++

..........++++++++++++

e is 65537 (0x10001)

Using configuration from /tmp/mkreq.txt.14716

Using configuration from /usr/share/ssl/openssl.cnf

Done.

******************************

IMPORTANT INFORMATION

******************************

Your VOCAL system is just about ready to run. Please be aware of

the following information:

* To configure your system, go to

http://vserver2/vocal/

And select one of the links there. Here is your information to

log into the Web Based Provisioning system:

User Name: vocal

Password: <entered by user>

* If you lose this information, you can reset the password using

allinoneconfigure -r

當看到上述文字出現時,表示軟體的設定已經完成.

當設定完成後,可以使用web browser (IE,mozilla,firefox,opera...)來開啟管理頁面,不過必須先將web server重新啟動以載入新的設定值,執行 :

/etc/rc.d/init.d/httpd restart

重新啟動web server之後可以藉由在瀏覽器上輸入

http://<主機名稱或是ip位址>/vocal/

即可見到登入畫面,以vocal為登入名稱及剛才你所輸入的密碼或是由系統亂數產生的密碼便可以登入了.

當完成allinoneconfigure程序之後,最好先檢查一下vocal程式是否已經啟動執行,可藉由以下指令查詢 :

/usr/local/vocal/bin/vocalctl status

如果見到

fs 5080 14857

fs 5085 14858

fs 5090 14859

fs 5095 14860

fs 5100 14861

fs 5105 14862

fsvm 5110 14889

ms 5060 14864

ms 5065 14865

ps 14890

rs 5070 14867

vmserver 14868

即表示vocal程式已經正確執行中.

PS : 若要重新更改系統密碼可以執行 :

/usr/local/vocal/bin/allinoneconfigure/allinoneconfigure -r

便可以重新產生密碼.

[四] VOCAL 系統執行及測試

軟體名稱 : VOCAL (Vovida Open Communication Application Library)

軟體版本 : 1.5.0

軟體網頁 : http://vovida.org

軟體下載 : http://www.vovida.org/applications/downloads/vocal/

系統測試

當系統完成allinoneconfigure設定之後會自動執行程式,可以藉由verifysip工具程式來驗證系統是否正確無誤,verifysip測試程式會經由 -a 參數自動產生兩個測試用使用者帳號 test1000及test1001這兩個帳號,並且會從test1000建立一個sip呼叫到test1001.當測試完畢之後這兩個測試帳號也將會被一起移除掉.

請執行

/usr/local/vocal/bin/verifysip -a

系統會出現

Enter VOCAL administrator password:

請輸入你剛才設定或是由系統亂數產生的密碼.

verifysip version 1.070202

Use -h to see more options

Running test against vocal system at vserver2...

VOCAL basic call test passed

如果見到VOCAL basic call test passed即表示系統設定及執行都正確無誤.

如果有任何錯誤,請重新檢查系統設定是否有誤.

系統執行及停止

雖然完成allinoneconfigure設定之後會自動啟動vocal,但是當系統重新開機或是關機重開之後,vocal程式便會停止執行.

要手動啟動vocal系統請執行 :

/usr/local/vocal/bin/vocalctl start

樣讓系統開機後自動執行vocal可將上述指令加入

/etc/rc.d/rc.local

相關指令及參數

vocalctl stop

vocalctl shutdown

以上兩個參數皆可關閉vocal程式.

vocalctl reload

當修改過vocal設定檔的話可以重新載入設定檔

其餘參數的語法及用途可執行vocalctl ?得知

VOCAL 軟體反安裝

發表於: 星期五六月 11, 2004 9:28 am

軟體名稱 : VOCAL (Vovida Open Communication Application Library)

軟體版本 : 1.5.0

軟體網頁 : http://vovida.org

軟體下載 : http://www.vovida.org/applications/downloads/vocal/

軟體解除安裝

當使用者不再需要VOCAL軟體,或者是想要先解除安裝再重新安裝的話,可以先將VOCAL軟體反安裝掉.

RedHat 7.3 以RPM檔案安裝時的反安裝

rpm -e vocalbin-1.5.0-20.i386.rpm

rpm -e vocalbin-tools-1.5.0-20.i386.rpm

rpm -e AtaAuto-1.5.0-20.i386.rpm

rpm -e sipset-1.5.0-20.i386.rpm

rpm -e b2bua-1.5.0-20.i386.rpm

照上述反安裝完畢所有RPM檔案之後便完成RedHat 7.3軟體的解除安裝.

RedHat 8.0 以RPM檔案安裝時的反安裝

rpm -e vocalbin-1.5.0-20.rh8.i386.rpm

rpm -e vocalbin-tools-1.5.0-20.rh8.i386.rpm

rpm -e AtaAuto-1.5.0-20.rh8.i386.rpm

rpm -e sipset-1.5.0-20.rh8.i386.rpm

rpm -e b2bua-1.5.0-20.rh8.i386.rpm

照上述反安裝完畢所有RPM檔案之後便完成RedHat 8.0軟體的解除安裝.

RedHat 9.0 以RPM檔案安裝時的反安裝

rpm -e vocalbin-1.5.0-20.rh9.i386.rpm

rpm -e vocalbin-tools-1.5.0-20.rh9.i386.rpm

rpm -e AtaAuto-1.5.0-20.rh9.i386.rpm

rpm -e sipset-1.5.0-20.rh9.i386.rpm

rpm -e b2bua-1.5.0-20.rh9.i386.rpm

照上述反安裝完畢所有RPM檔案之後便完成RedHat 9.0軟體的解除安裝.

注意

以上反安裝過程祇會移除當時所安裝的程式而已,provisioning_data 這個目錄仍然會保存著.

如果你不想保留任何資料要完整移除的話,請執行:

rm -Rf /usr/local/vocal

以原始碼安裝時的反安裝

如果是用原始碼編譯的方式安裝VOCAL軟體的話,執行以下程序即可解除軟體安裝.

PS : 必須要有 root 權限才可以進行

rm -Rf /usr/local/vocal