- Infoshare
-
Signed in: Administrator
- Change Password
- Signoff
- Online Documentation
- Adutante ver. 5.0.1.0
PAGE TITLE
Date Last ModifiedPAGE TITLE
Date Last ModifiedHow to use CLI Tool - refer to CLI Tool Overview
Attention!!: most of the corresponding configuration functionality is also available within Versadial VSLogger Monitor graphical interface. Select setup View Setup View and the corresponding section (General, Storage, Channels, etc..).
VSLogger supports multiple storage destinations and can create multiple copies of the recording for reasons of retention and backup.
Configure MAIN diskset
|
Configure FTP storage
|
Configure NET diskset
|
Configure HTTP storage (replication to target recorder)
exit - exit current configuration mode enable [y|n] - enable/disable hw chlist - show channels list chset [1,n|1-n] [y|n] - set/unset channels to store id [...] - satellite id hashtype [sha1|sha256] - hash type salt [...] - security phrase for hash generation url [http(s):\\server] - http server url mediatype [0-2] - save only files with media type (0- audio, 1- audio and video/image, 2- video/image) schedule [cont|daily] - uploading schedule
|
Configure Archives
|
Command format | Description | Disk sets | Extra Notes |
enable [y|n] |
enable/disable |
All |
Enable or Disable specific type of storage. MAIN storage set is always enabled. |
chlist |
show channels list |
All |
Show list of channels(1-256) with selected/not selected status. Recordings for not selected channels, won't be stored, even if the recording was stored in the MAIN disk set. If the channel is not selected in the MAIN disk set, the recording will not be stored at all, while users still can monitor the call in real time. |
chset [1,n|1-n] [y|n] |
set/unset channels to store |
All | used to change channel storage status in chlist (see above command) |
drivelist |
show drives list |
MAIN, NET, archives | Shows list of all drives available for this type of storage. Drives selected to the current disk set, indicated by set status (y/n). driveset command (see below) used to add/remove drives to/from the current disk set. |
driveset [D,E,...,Z] [y|n] |
set/unset storage drives |
MAIN, NET | Used to add/remove drives to/from the current disk set. |
current [D-Z] |
current drive |
MAIN, NET, archives |
This parameter selects:
For example, a disk set might have disks D,E F, and one of them is current. The recorder will record on the current drive until it is full. When the current drive is full, the recorder will select next empty drive as current. When all drives are full: NET and MAIN disk sets behave according to delete parameter (see below). Archive drives: automatically closed and alerts users to replace media. |
diskspace [MB] |
min diskspace [MB] |
MAIN, NET, archives | Minimum free disk space, when disk considered full and recorder attempts to change current drive. Enough disk space should be allocated to finish recordings in progress (to avoid recording split on drive change) |
drivemap [D:\\net] [y|n] |
MAIN, NET, archives |
With this command, network shares can be added to drivelist. Format is: Drive letter + ":" delimiter + netshare name as \\sharedsrc\sharename Drive letter used in this command is fictitious (has nothing to do with mapped drive letters on your PC). Drive letter used only to differentiate between physical drives and net shares in VSLogger drivelist configuration. |
|
searchdriveset [D,E,..][y|n] |
set/unset search drives |
NET, archives |
Drives used when searching for actual recordings. Recording database includes the path to the recordings, but not drives. When recording requested for play or download, recorder looks for recordings in drives from the searchdriveset. Drives may be already removed from driveset (list of drives selected for recording) to avoid accidental overwrite or other reason, but still in searchdriveset because it still holds recordings |
delete [none|full|after [days]] |
- autodelete (none|when full| after n days |
MAIN, NET |
Auto delete options to enable continuous operation. If delete is none, and disk set is full (all drives are full) recorder will stop recording and issue alarm. All calls from this point won't be recorded until the user clears one of the drives. |
aswave [y|n] - |
save as wave |
NET, FTP, archives |
Save recordings in WAV/WAVE format on selected storage. Note: embedded CRC information will be lost |
uncompress [y|n] |
- save uncompressed |
NET, FTP, archives |
Applied only to recordings saved in WAVE format. Recordings uncompressed to PCM format |
driveset [D,E,...,Z] [y|n] |
set/unset storage drives |
archives |
Archive destination drives. Usually removable USB or DVD+RW drives. This parameter added |
schedule [cont|daily|demand] |
archiving schedule |
archives, FTP, HTTP |
cont- continuous archiving, when active and ready archive drives are available. VSLogger Monitor Setup Tab allows to re-enabled drives when archived media replaced daily [0-23] - do daily archiving at the specific time(0-23, 24-hour format). VSLogger Monitor Setup Tab allows to re-enabled drives when archived media replaced demand - on-demand archiving. VSLogger Monitor Setup Tab allows to schedule archiving and re-enabled drives when archived media is replaced. |
server [ftp server] |
ftp server URL |
FTP | |
user [ftp user] |
ftp server id |
FTP | |
password [ftp password] |
ftp server password |
FTP | |
mediatype [0-2] |
save only files with selected media type |
NET, archives, FTP, HTTP |
0- audio only |
encryption [y|n] |
turn on/off encryption. |
MAIN |
Available starting ver 4.8.0.0 |
Specific to FTP storage |
|||
server [ftp server] |
ftp server URL |
FTP | |
user [ftp user] |
ftp user id |
FTP | |
password [ftp password] |
ftp password |
FTP | |
Specific to HTTP storage | |||
id [...] |
satellite id |
HTTP | Sender recorder id , as configured on recipient recorder (Virtual channels trunk allocated on target recorder to receive recordings from this recorder) |
hashtype [sha1|sha256] |
hash type |
HTTP | Security hash type, to be generated based on salt and upload parameters . Known to sender and recipient |
salt [...] |
security phrase for hash generation |
HTTP | Set security phrase for protection . Known to sender recorder and recipient recorder |
url [http(s)://server] |
http server url |
HTTP | Target(recipient) recorder URL e.g. http://recorder1:22443/api/satellite. Note: /api/satellite path defines end point allocated for replication feature interface on target(destination recorder) |
1. Click on "Live Monitoring" at the top of the page 2. Click on "Setup" from the dropdown menu |
|
3. Click on "Storage" on the left-hand side of the VSLogger Setup menu 4. Click the "Edit" button for MAIN storage |
|
5. Configure MAIN storage settings
|
|
7. Click the "Save" button at the top right of the page 8. Click "Save and reload" 9. Click "OK" |
|
This completes the configuration. |
Open CLI from programs, go to File and connect, click ‘OK’.
Remember: The “?” command lists the available commands.
login>
->u admin p admin
Total number of hw channels 0
Today is: Thu Apr 4 23:01:34 UTC 2019
VSLogger version 4.9.0.568
Recording Service (vslogger.exe)
CPU usage: 0% Memory usage: 27.2 Mb
Started at: Thu Apr 4 22:48:22 UTC 2019
Uptime: 0 days 00:13:11
Total number of virtual channels 0
----------------------------------------
VSLogger license info
----------------------------------------
License: XXXX-XXXXX-XXXX
Activated: y
Expiration Date: 2019-12-31 08:00:00
Support Contract id: 11856
Support Expiration Date: 2019-03-10 08:00:00
TDM Licenses Available: 100
VOIP Licenses Available: 100
Screen Licenses Available: 30
Voice Analytics License: y
Encryption License: y
cli>
->config storage main
cli>(config-storage_main)
->drivelist
drive |set |map
----------------------------------------
C n
D ncli>(config-storage_main)
->driveset d
*settings were modified, type 'save' command to save current settings.
cli>(config-storage_main)
->delete full
*NOTE - this setting means when the drive reaches capacity, the oldest recordings will be over-written by the newest.
cli>(config-storage_main)
->save
Saving...
server is busy, wait...
Saving logger settings...
Logger settings were saved.
Saving channel settings ...
Channel settings were saved
Type "reload" command, to take effect.
cli>(config-storage_main)->exit
cli>(config)
->reload
Reloading...
server is busy, wait...
This completes the configuration.
1. Click on "Live Monitoring" at the top of the page 2. Click on "Setup" from the dropdown menu |
|
3. Click on "Storage" on the left-hand side of the VSLogger Setup menu 4. Click on "Map network drive" underneath the "Save" button |
|
5. Select the drive letter of the network drive 6. Type in the drive path, format: \\server\share 7. Click on the check box to map the drive. You should now see the network drive added. Click "Submit" to save these changes |
|
8. Click the "Edit" button for NET storage | |
9. Configure NET storage settings
|
|
11. Click the "Save" button at the top right of the page 12. Click "Save and reload" 13. Click "OK" |
|
This completes the configuration. |
Please read:
***Important notes about using network shared drives for archiving and storage***
Below...
Open CLI from programs, go to File and connect, click ‘OK’.
Remember: The “?” lists the available commands.
->u admin p admin
Today is: (Current Date / Time displayed UTC)
VSLogger version 4.7.1.0
Cli version 4.7.1.0
Total number of channels 112
----------------------------------------
VSLogger license info
----------------------------------------
License: XXXX-XXXXX-XXXX
Activated: y
Expiration Date: 2016-03-16 07:00:00
Support Contract id: 11856
Support Expiration Date: 2016-02-29 08:00:00
TDM Licenses Available: 96
VOIP Licenses Available: 32
Screen Licenses Available: 32
G.729 Licenses Available: 16
cli>
->config storage net cli>
(config-storage_net)
->drivemap z:\\server\share
cli>(config-storage_net)
->enable y
cli>(config-storage_net)
->searchdrives z
cli>(config-storage_net)
->delete full y
cli>(config-storage_net)
->save
Saving...
cli>(config-storage_net)
->exit
cli>(config)
->reload
Reloading...
server is busy, wait...
This completes the configuration.
Your mapped drive will now be available in the drivelist in main storage.
1. Click on "Live Monitoring" at the top of the page 2. Click on "Setup" from the dropdown menu |
|
3. Click on "Storage" on the left-hand side of the VSLogger Setup menu 4. Click the "Edit" button for FTP storage |
|
5. Configure FTP storage settings
|
|
7. Click the "Save" button at the top right of the page 8. Click "Save and reload" 9. Click "OK" |
|
This completes the configuration. Your recordings will now be duplicated to the FTP site. |
Open CLI from programs, go to File and connect, click ‘OK’.
Remember: The “?” lists the available commands.
login>
->u admin p admin
Today is: (Current Date / Time displayed UTC)
VSLogger version 4.7.1.0
Cli version 4.7.1.0
Total number of channels 112
----------------------------------------
VSLogger license info
----------------------------------------
License: XXXX-XXXXX-XXXX
Activated: y
Expiration Date: 2016-03-16 07:00:00
Support Contract id: 11856
Support Expiration Date: 2016-02-29 08:00:00
TDM Licenses Available: 96
VOIP Licenses Available: 32
Screen Licenses Available: 32
G.729 Licenses Available: 16
cli>
->config storage ftp
cli>(config-storage_ftp)
->enable y
cli>(config-storage_ftp)
->server ftp.mysite.not
cli>(config-storage_ftp)
->user admin
cli>(config-storage_ftp)
->password Welcome1!
cli>(config-storage_ftp)
->save
Saving...
cli>(config-storage_ftp)
->exit
cli>(config)
->reload
Reloading...
server is busy, wait...
This completes the configuration.
Your recordings will now be duplicated to the FTP site.
1. Click on "Live Monitoring" at the top of the page 2. Click on "Setup" from the dropdown menu |
|
3. Click on "Storage" on the left-hand side of the VSLogger Setup menu 4. Click the "Edit" button for HTTP storage |
|
5. Configure HTTP storage settings
|
|
7. Click the "Save" button at the top right of the page 8. Click "Save and reload" 9. Click "OK" |
|
This completes the configuration. |
Open CLI from programs, go to File and connect, click ‘OK’.
Remember: The “?” lists the available commands.
login>
->u admin p admin
Today is: (Current Date / Time displayed UTC)
VSLogger version 4.7.1.0
Cli version 4.7.1.0
Total number of channels 112
----------------------------------------
VSLogger license info
----------------------------------------
License: XXXX-XXXXX-XXXX
Activated: y
Expiration Date: 2016-03-16 07:00:00
Support Contract id: 11856
Support Expiration Date: 2016-02-29 08:00:00
TDM Licenses Available: 96
VOIP Licenses Available: 32
Screen Licenses Available: 32
G.729 Licenses Available: 16
cli>
->config storage http
cli>(config-storage_http)
->enable y
cli>(config-storage_http)
->id recorder1
cli>(config-storage_http)
->url http://recorder2:22443/api/satellite
cli>(config-storage_http)
->hashtype sha256
cli>(config-storage_http)
->salt 1232wed23r3245342trrewrtyyw
cli>(config-storage_http)
->mediatype 1
cli>(config-storage_http)->save
Saving...
cli>(config-storage_http)
->exit
cli>(config)
->reload
Reloading...
server is busy, wait...
This completes the configuration.
Your audio, video and image recordings will now be duplicated to the recorder recorder2
Note:to successfully accept recordings from this recorder, destination recorder (http://recorder2:22443) configuration have to include virtual channels trunk corresponding to this recorder and with matching parameters: id, hashtype and salt
1. Click on "Live Monitoring" at the top of the page 2. Click on "Setup" from the dropdown menu |
|
3. Click on "Storage" on the left-hand side of the VSLogger Setup menu 4. Click the "Edit" button for ARCHIVE storage |
|
5. Configure ARCHIVE storage settings
|
|
7. Click the "Save" button at the top right of the page 8. Click "Save and reload" 9. Click "OK" |
|
This completes the configuration. |
Note: In the example, we’ll use a network mapped drive (Z). To use a local drive for archiving , omit the mapdrive command.
Open CLI from programs, go to File and connect, click ‘OK’.
Remember: The “?” lists the available commands.
login>
->u admin p admin
Today is: (Current Date / Time displayed UTC)
VSLogger version 4.7.1.0
Cli version 4.7.1.0
Total number of channels 112
----------------------------------------
VSLogger license info
----------------------------------------
License: XXXX-XXXXX-XXXX
Activated: y
Expiration Date: 2016-03-16 07:00:00
Support Contract id: 11856
Support Expiration Date: 2016-02-29 08:00:00
TDM Licenses Available: 96
VOIP Licenses Available: 32
Screen Licenses Available: 32
G.729 Licenses Available: 16
cli>
->config archive
cli>(config-archives)
->enable y
***This only needed if using a network shared drive***
cli>(config-archives)
->drivemap Z:\\server\sharecli>(config-archives)
Select archiving storage drive.
->driveset Z
cli>(config-archives)
->save
Saving...
server is busy, wait...
Saving logger settings...
Logger settings were saved.
Saving channel settings ...
Channel settings were saved
Type "reload" command, to take effect.
cli>(config-archives)
->exit
cli>(config)
->reload
Reloading...
server is busy, wait...
Program access to network shares and list of the mapped network drives are specific to user account context this program runs under.
CLI tool is a desktop application which runs under signed-in user account context.
VSLogger recording service is a Windows Service which runs under account context configured in Windows Control Panel Services applet, usually, it is Local System Account.
As a result, CLI tool and VSLogger Recording service can have completely different access rights to network shared drives. CLI tool might even run on different PC from the managed VSLogger Recording service.
This situation creates some perception difficulties to Administrator, when network shared drive is accessible to her from the Windows Explorer, while not visible and accessible to VSLogger Recording service.
To resolve this issue, when configuring VSLogger recorder with network shared drives, the following steps should be taken:
To test net share availability, administrator can do the following:
If the account can access desired net shares, apply this account information to following services:
The main idea of archiving is to put a copy of the recordings to removable media and store it off-line (maybe even off-site) for security. This feature allows you to retain a significant amount of recordings without an investment in large capacity online storage.
Archive media content
sample Labels.XML
<archive>
<id>1435884344562</id>
<file>arch_1435884344562.db</file>
<created>2015-07-03 00:45:44</created>
</archive>
Note: if more than 5 archive DB files copied to C:\ProgramData\Adutante\vslogger\data\db\archives folder, only five most recent archives are available for search.
One important purpose of the archiving is the ability to restore recorder database lost for whatever reason (recorder damage, fire etc.).