Skip to main content

ابزار simotelhelper

simotelhelper ابزاری برای مدیریت و نگهداری سرویس‌های مرکز‌تماس می‌باشد.این ابزار نقش حیاتی در انجام فرایند خطایابی دارد به نحوی که از اولین‌ ابزارهای مورد استفاده در خطایابی سیستم می‌باشد.

اطلاعات

simotelhelper ابزاری تحت خط‌فرمان می‌باشد و برای استفاده از آن باید به shell لینکوس سرور دسترسی داشته باشید.

هشدار

پیشنهاد می‌شود تا زمانی که نسبت به نحوه عملکرد مرکزتماس و سرویس‌های اصلی آن دیدی پیدا نکرده‌اید از این ابزار استفاده نکنید.

در پایین دستورات مربوط به این ابزار بطور کامل مورد بررسی قرار می‌گیرند.

simotelhelper help

خروجی این‌ دستور راهنمایی از دستورات موجود می‌باشد.

** نمونه خروجی دستور**

root@simotel:~# simotelhelper help
Simotel Helper

Usage:
simotelhelper [flags]
simotelhelper [command]

Available Commands:
check check simotel tools and server
db do something on database
help Help about any command
initiate initiate simotel
iptables manage iptables
patch patch
reinstall doing update
scmid show scmid
serial show serial
serverstatus Server status
timezone change server timezone
update doing update
version show simotel helper version

Flags:
-h, --help help for simotelhelper
--host string Address of server (default "update.mysup.ir")
--port int Port of server (default 4994)

Use "simotelhelper [command] --help" for more information about a command.

simotelhelper check

یکی از وظایف این دستور بررسی وضعیت سرویس‌های حیاتی سرور و ارائه گزارش از آن‌ها می‌باشد.

** نمونه خروجی دستور**

root@simotel:~# simotelhelper check

Simotel version : 6.2.22
SimotelHelper version : 23

Simotel package p38: 1
Sound PR: 8
PBX configs version: 8


Simotel: NOT RUNNING
Simotelagi: RUNNING
Simotelhelper: RUNNING
Mongodb: RUNNING
Redis: RUNNING
PBX: RUNNING

همانظور که مشاهده می‌فرمایید در ابتدا توضیحاتی درمورد نسخه سیموتل نصب‌شده، نسخه simotelhelper، نسخه فایل‌های صوتی و ... ارائه شده و در نهایت نیز وضعیت سرویس‌های مرکزتماس مشخص شده است.

simotelhelper db

این دستور وظیفه انجام امور مربوط به پایگاه‌داده را برعهده دارد، آرگومان‌های مربوط به این دستور را در ادامه بررسی می‌کنیم.

simotelhelper db help

root@simotel:~# simotelhelper db help
do something on database

Usage:
simotelhelper db [command]

Available Commands:
backup backup datable by some strategies
connect connect to mongodb cli
repair repair database
restore restore backup files to database
start start database
status show database status
stop stop database

Flags:
-h, --help help for db

Global Flags:
--host string Address of server (default "update.mysup.ir")
--port int Port of server (default 4994)

Use "simotelhelper db [command] --help" for more information about a command.
subcommand is required


خروجی این دستور راهنمایی دستورات مربوط به مدیریت پایگاه‌داده می‌باشد.

Simotelhelper db backup

این دستور وظیفه تهیه فایل پشتیبان از پایگاه‌داده را برعهده دارد. برای مشاهده انواع استراتژی‌های بکاپ‌گیری دستور Simotelhelper db backup show را وارد کنید.

خروجی دستور Simotelhelper db backup show

root@simotel:~# simotelhelper db backup show

sterategies description
all backup full database (simotel and autodialer)
all-no-reports backup all simotel data expect reports
custom selective backup
dashboard backup dashboards
dialer backup autodialer without reports
dialer-report backup autodialer reports
dialer-sounds backup autodialer sounds (announcements)
pbx backup pbx entities, burst calls, voice mails and dial plan editor
reports backup cdr, cdr of queues, queue logs and poll
settings backup setting
sound backup simotel sounds (announcements)
voice-mail backup simotel voice mails with sounds (db format)
web-members backup web accounts and account types


در این قسمت انواع روش‌های بکاپ‌گیری نمایش داده می‌شوند که با نوشتن نام استراتژی در جلوی دستور، سیستم شروع به بکاپ‌گیری می‌کند.

خروجی دستور Simotelhelper db backup pbx

root@simotel:~# simotelhelper db backup pbx
DEBUG 2021-06-23T12:03:04.454+0430 writing Simotel.dialplan_editor_history to archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz.creating'
DEBUG 2021-06-23T12:03:04.461+0430 writing Simotel.music_on_hold to archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz.creating'
DEBUG 2021-06-23T12:03:10.847+0430 done dumping Simotel.dialplan_editor_orders (1 document)
DEBUG 2021-06-23T12:03:12.365+0430 writing Simotel.featurecode to archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz.creating'
DEBUG 2021-06-23T12:03:12.374+0430 done dumping Simotel.burstcall (0 documents)
DEBUG 2021-06-23T12:03:12.375+0430 writing Simotel.queue to archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz.creating'
DEBUG 2021-06-23T12:03:13.778+0430 done dumping Simotel.pbx_groups (0 documents)
DEBUG 2021-06-23T12:03:13.779+0430 Simotel.sound 0
DEBUG 2021-06-23T12:03:13.779+0430 Simotel.featurecode 0
DEBUG 2021-06-23T12:03:13.779+0430
DEBUG 2021-06-23T12:03:13.779+0430 Simotel.featurecode 9
DEBUG 2021-06-23T12:03:13.779+0430 done dumping Simotel.featurecode (9 documents)
DEBUG 2021-06-23T12:03:13.783+0430 Simotel.sound 10
DEBUG 2021-06-23T12:03:13.855+0430 done dumping Simotel.queue (2 documents)
DEBUG 2021-06-23T12:03:13.855+0430 done dumping Simotel.sound (10 documents)
DEBUG backup completed, successfully. /var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz

با واردکردن این دستور سیستم شروع به بکاپ‌گیری از محتویات بخش pbx می‌کند،در نهایت نیز مسیر فایل بکاپ نمایش داده می‌شود(در زمان restore کردن بکاپ کاربرد دارد).

simotelhelper db connect

با استفاده از این دستور می‌توان مستقیما به shell پایگاه‌داده MongoDB متصل شد.

خروجی دستور simotelhelper db connect

root@simotel:~# simotelhelper db connect
MongoDB shell version v4.4.0
connecting to: mongodb://127.0.0.1:27017/admin?compressors=disabled&gssapiServiceName=mongodb
Implicit session: session { "id" : UUID("c13b4753-59e4-41cc-83f8-9f42a23048e3") }
MongoDB server version: 4.4.0
Welcome to the MongoDB shell.
For interactive help, type "help".
For more comprehensive documentation, see
https://docs.mongodb.com/
Questions? Try the MongoDB Developer Community Forums
https://community.mongodb.com
---
The server generated these startup warnings when booting:
2021-06-23T09:51:28.056+04:30: Using the XFS filesystem is strongly recommended with the WiredTiger storage engine. See http://dochub.mongodb.org/core/prodnotes-filesystem
2021-06-23T09:51:32.054+04:30: You are running this process as the root user, which is not recommended
2021-06-23T09:51:32.054+04:30: /sys/kernel/mm/transparent_hugepage/enabled is 'always'. We suggest setting it to 'never'
2021-06-23T09:51:32.054+04:30: Soft rlimits too low
2021-06-23T09:51:32.054+04:30: currentValue: 1024
2021-06-23T09:51:32.054+04:30: recommendedMinimum: 64000
---
---
Enable MongoDB's free cloud-based monitoring service, which will then receive and display
metrics about your deployment (disk utilization, CPU, operation statistics, etc).

The monitoring data will be available on a MongoDB website with a unique URL accessible to you
and anyone you share the URL with. MongoDB may use this information to make product
improvements and to suggest MongoDB products and deployment options to you.

To enable free monitoring, run the following command: db.enableFreeMonitoring()
To permanently disable this reminder, run the following command: db.disableFreeMonitoring()
---
>

هشدار

در‌صورتی که نسبت به طراحی و کار با پایگاه داده mongodb اطلاعی ندارید، اکیدا استفاده از این دستور و تغییر در سطح پایگاه‌داده توصیه نمی‌شود.

simotelhelper db repair

درصورتی که در عملکرد پایگاه داده اختلالی ایجاد شود،با‌استفاده از این دستور می‌توان مشکل پیش‌آمده را برطرف نمود.

** خروجی دستور simotelhelper db repair**

root@simotel:~# simotelhelper db repair
---------------------------------
Successfully stop mongodb
---------------------------------
Do you want to make a copy of "db" before repairing to "/usr/src/mongodb/dbdata/db-back-repair/" ? [y/n]
y
Starting create copy of db to /usr/src/mongodb/dbdata/db-back-repair/
Finished copy of db to /usr/src/mongodb/dbdata/db-back-repair/
{"t":{"$date":"2021-06-23T12:22:52.925+04:30"},"s":"I", "c":"CONTROL", "id":23285, "ctx":"main","msg":"Automatically disabling TLS 1.0, to force-enable TLS 1.0 specify --sslDisabledProtocols 'none'"}
{"t":{"$date":"2021-06-23T12:22:53.546+04:30"},"s":"W", "c":"ASIO", "id":22601, "ctx":"main","msg":"No TransportLayer configured during NetworkInterface startup"}
{"t":{"$date":"2021-06-23T12:22:53.547+04:30"},"s":"I", "c":"NETWORK", "id":4648601, "ctx":"main","msg":"Implicit TCP FastOpen unavailable. If TCP FastOpen is required, set tcpFastOpenServer, tcpFastOpenClient, and tcpFastOpenQueueSize."}
{"t":{"$date":"2021-06-23T12:22:53.670+04:30"},"s":"I", "c":"STORAGE", "id":4615611, "ctx":"initandlisten","msg":"MongoDB starting","attr":{"pid":1173,"port":27017,"dbPath":"/usr/src/mongodb/dbdata/db","architecture":"64-bit","host":"simotel"}}
{"t":{"$date":"2021-06-23T12:22:53.670+04:30"},"s":"I", "c":"CONTROL", "id":23403, "ctx":"initandlisten","msg":"Build Info","attr":{"buildInfo":{"version":"4.4.0","gitVersion":"563487e100c4215e2dce98d0af2a6a5a2d67c5cf","openSSLVersion":"OpenSSL 1.1.1d 10 Sep 2019","modules":[],"allocator":"tcmalloc","environment":{"distmod":"debian10","distarch":"x86_64","target_arch":"x86_64"}}}}
{"t":{"$date":"2021-06-23T12:22:58.471+04:30"},"s":"I", "c":"CONTROL", "id":20565, "ctx":"initandlisten","msg":"Now exiting"}
{"t":{"$date":"2021-06-23T12:22:58.472+04:30"},"s":"I", "c":"CONTROL", "id":23138, "ctx":"initandlisten","msg":"Shutting down","attr":{"exitCode":0}}

simotelhelper db restore

این دستور وظیفه بازگردانی بکاپ‌های مرکزتماس را برعهده دارد،در نهایت به عنوان پارامتر ورودی مسیر فایل بکاپ تهیه شده نیز نیاز می‌باشد.

** خروجی دستور simotelhelper db restore BackupPath**

root@simotel:~# simotelhelper db restore /var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz

Drop collections of database before restore? [Y/n] ?
y
DEBUG 2021-06-23T12:29:44.190+0430 preparing collections to restore from
DEBUG 2021-06-23T12:29:44.258+0430 reading metadata for Simotel.user from archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz'
DEBUG 2021-06-23T12:29:44.269+0430 restoring Simotel.user from archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz'
DEBUG 2021-06-23T12:29:44.276+0430 restoring indexes for collection Simotel.user from metadata
DEBUG 2021-06-23T12:29:44.301+0430 finished restoring Simotel.user (34 documents, 0 failures)
DEBUG 2021-06-23T12:29:44.305+0430 reading metadata for Simotel.trunk from archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz'
DEBUG 2021-06-23T12:29:44.312+0430 restoring Simotel.trunk from archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz'
DEBUG 2021-06-23T12:29:44.320+0430 restoring indexes for collection Simotel.trunk from metadata
DEBUG 2021-06-23T12:29:44.335+0430 finished restoring Simotel.trunk (2 documents, 0 failures)
DEBUG 2021-06-23T12:29:44.342+0430 reading metadata for Simotel.dialplan_editor_history from archive '/var/spool/simotel/backup/cli/Simotel-pbx-20210623-1203.gz'
DEBUG 2021-06-23T12:29:44.682+0430 no indexes to restore
DEBUG 2021-06-23T12:29:44.684+0430 finished restoring Simotel.sound (10 documents, 0 failures)
DEBUG 2021-06-23T12:29:44.685+0430 112 document(s) restored successfully. 0 document(s) failed to restore.

simotelhelper db start

این دستور وظیفه شروع‌به‌کار پایگاه‌داده را برعهده دارد.

** خروجی دستور simotelhelper db start**

root@simotel:~# simotelhelper db start
---------------------------------
Successfully start mongodb
---------------------------------
about to fork child process, waiting until server is ready for connections.
forked process: 4322
child process started successfully, parent exiting

simotelhelper db status

این دستور وظیفه نمایش وضعیت پایگاه‌داده را برعهده دارد.

** خروجی دستور simotelhelper db status**

root@simotel:~# simotelhelper db status
---------------------------------
Mongodb status: Running
---------------------------------

simotelhelper db stop

این دستور وظیفه توقف‌ کار پایگاه‌داده را برعهده دارد.

** خروجی دستور simotelhelper db stop**

root@simotel:~# simotelhelper db stop
---------------------------------
Successfully stop mongodb
---------------------------------

simotelhelper iptables

این دستور وظیفه مدیریت موارد مربوط به iptables را برعهده دارد.

** خروجی دستور simotelhelper iptables --help**

root@simotel:~# simotelhelper iptables --help
manage iptables

Usage:
simotelhelper iptables [command]

Available Commands:
apply apply last iptables configuration
boot manage iptables booting
export export iptables
flush flush(stop) iptables
import import iptables
panel manage iptables panel view

Flags:
-h, --help help for iptables

Global Flags:
--host string Address of server (default "update.mysup.ir")
--port int Port of server (default 4994)

Use "simotelhelper iptables [command] --help" for more information about a command.

با استفاده از این دستور تمامی پارامتر‌های مربوط به دستور نمایش داده می‌شوند که در ادامه بصورت مختصر هرکدام را بررسی می‌کنیم.

۱. apply: پس از اینکه iptable مد نظر ما import شد،برای اعمال آن نیاز می‌باشد از این دستور استفاده کنیم.

۲. boot: فعال یا غیرفعال‌ شدن iptable در زمان شروع‌به‌کار ماشین را مشخص می‌کند.با دستور help می‌توان پارامترهای آن را مشاهده کرد.

۳. export: با استفاده از این دستور امکان خروجی گرفتن از iptable موجود برروی سیستم فراهم می‌شود.

۴. flush: این دستور iptable موجود برروی سیستم را غیرفعال می‌کند.

۵. import: امکان import فایل iptable سیستم‌ دیگری که با دستور export گرفته شده است را فراهم می‌آورد.

۶. panel: با استفاده از این دستور می‌توان بخش iptable وب را فعال یا غیر‌فعال کرد.با دستور help می‌توان پارامترهای آن را مشاهده کرد.

simotelhelper patch

وظیفه مدیریت وصله‌های ارائه ‌شده برای مرکزتماس را برعهده دارد.

خروجی دستور simotelhelper patch

root@simotel:~# simotelhelper patch
checking for new patches update
4 update availble for you.
available patches are:
---------------------------------------------------------------------------------------------
id | Name | Version | Description
---------------------------------------------------------------------------------------------
1 | Package.P38 | 2 |
2 | Update music on hold (moh) | 2 | Update music on hold
3 | set ulimit | 1 | Warning: Proceed With Caution. setting ulimit to asterisk. it hang up all current calls by restarting asterisk
4 | SoundPR | 10 | queue sound issue is fixed
---------------------------------------------------------------------------------------------
Choose patch id:

با وارد کردن id مربوط به هر ردیف می‌توان آخرین وصله ارائه شده برای سیستم را نصب کرد.

خروجی دستور simotelhelper patch more

root@simotel:~# simotelhelper patch more
available categories are:
---------------------------------------------------------------------------------------------
id | Category | Description
---------------------------------------------------------------------------------------------
1 | Sound-pr | Persian sound versions
2 | DB 4.4.0 | use to manipulate or restore some data template in database
3 | IPTable | Configure iptable by some pre-define strategies
4 | HDD Maintenance | Maintenance HDD
---------------------------------------------------------------------------------------------
Choose category id:

این دستور دسته‌بندی از وصله‌های ارائه شده برای ورژن مرکز تماس را ارائه می‌دهد،در صورتی که نیاز به بازگشت به ورژن قبلی وصله‌ای بود از طریق این دستور می‌توان اقدام کرد.

simotelhelper serial

خروجی این دستور شماره سریال اختصاص داده‌شده به مرکزتماس می‌باشد.

root@simotel:~# simotelhelper serial
5lWGi2aOHI7Kc9pOPFoLqh3MxhW8PkaMQK

simotelhelper serverstatus

با اجرای این دستور اطلاعاتی درمورد سرور و سرویس‌های نصب شده برروی آن بدست می‌آورید.

خروجی دستور simotelhelper serverstatus

root@simotel:~# simotelhelper serverstatus
{
"Host": {
"platform": "debian",
"platformVersion": "10.6",
"kernelVersion": "4.19.0-11-amd64",
"PBX": "13.37.0",
"PBXSBV": "s.2",
"LatestPython": "3.8.6",
"Pythons": [
"3.8.6"
]
},
"Version": {
"Simotel": "6.2.22",
"SimotelEdition": "gold",
"Helper": "23"
},
"Mongodb": {
"FCV": "4.4",
"Version": "4.4.0",
"dbName": "Simotel",
"dbSize": 4014080
},
"Patch": {
"CUpdate": "1",
"PBXConf": "8",
"Package-p38": "1",
"Sound-pr": "8",
"iso": "7"
},
"HDD": {
"Total": 18889785344,
"Used": 6140174336,
"Free": 11766468608,
"Backup": 1769746,
"Monitor": 129844,
"MonitorConverted": 161878,
"MonitorRemoved": 4096
}
}

simotelhelper timezone

مدیریت timezone سرور با استفاده از این دستور انجام می‌شود.

simotelhelper update

با استفاده از این دستور می‌توان آپدیت‌های جدید که برای سیستم ارائه شده‌اند را نصب کرد.

خروجی دستور simotelhelper serverstatus

root@simotel:~# simotelhelper update
doing update

Usage:
simotelhelper update [command]

Available Commands:
check check for new updates
dialer update simotel dialer
helper update simotel helper
simotel update simotel simotel

Flags:
-h, --help help for update

Global Flags:
--host string Address of server (default "update.mysup.ir")
--port int Port of server (default 4994)

Use "simotelhelper update [command] --help" for more information about a command.
subcommand is required

در این مرحله باید یکی از گزینه‌ها برای بررسی آپدیت انتخاب شود.

خروجی دستور simotelhelper update check

root@simotel:~# simotelhelper update check
simotel: up to date
helper: up to date

simotelhelper version

ورژن simotelhelper نصب شده برروی سرور را نشان می‌دهد.

خروجی دستور simotelhelper simotelhelper version

root@simotel:~# simotelhelper version
simotelhelper version is 23