Valt Administrator Guide 5.0

From IVS Wiki
Revision as of 10:57, 29 January 2018 by IVSWikiBlue (talk | contribs)
Jump to: navigation, search

General

The general section under Admin provides a snapshot of the software along with some management links as shown below.

Gen1.jpg

  1. ) Admin: If a user has administrative rights they will be able to click on the admin section.
  2. ) General Link: The default section that will load once a user clicks on admin is “General” assuming they have access to this admin section. The general system provides some basic application and system information.
  3. ) Software Information: This displays the software version, license type, number of licenses and a link to a database management tool (phpmyadmin).
  4. ) Media Server(s): This displays all the media servers associated with the software instance, the amount of storage used / remaining on each, and a management link for the video engine on each media server. Note if a media server is online it will have a green name, if it is offline the name will appear in red as shown above.

Templates

Templates are used to capture information and associate them with recordings. There are two types of templates: information and marker. The admin template section is used to create, delete, and edit templates in the system. Templates are assigned to a user group so different user groups can leverage different template types. Tem1.jpg

  1. ) Clicking on the templates link under Admin will take you to the section displayed above.
  2. ) The existing templates will be displayed in a list, to view or edit a template click on the name.

Tem2.jpg

  1. ) Add Template: To create a new template click on the Add Template button.
  2. ) Template Name: This name is used as an identifier only when assigning the template to a user group.
  3. ) Template Type: There are two template types information and marker. Information ties data to the overall recording while markers are designed to tie data to specific points within the recording.
  4. ) Container: This specifies the container the template will use. Users are only able to see objects that are in the same container or a sub container.
  5. ) Add Field: This button will add another field to the template, there is no limit to the number of fields within a template.
  6. ) On: This checkbox enables the corresponding field. If this is unchecked the field will not be used.
  7. ) Field Name: This is a label for the field.
  8. ) Required Checkbox: If this is checked it will force a user to enter data into the corresponding field before they can continue.
  9. ) Field Type: This changes the type of field. We currently support Text, Drop Down, Audio, Note, Multi-Select, Quick Mark / Quick Record.
  10. ) Data: This can be left blank or can be used to pre-populate data into to the field depending on what field type is used.

Tem3.jpg

  1. ) If a Drop Down or Multi-Select field type is used the options must be defined in a format as shown above. It is important that data is separated only by a comma and spaces are not used.

Rooms

Rooms act as containers for a camera or group of cameras. Rooms can be recorded using a contact closure / card reader, schedule, or on demand through the user interface. Rooms are also assignable from a user permission perspective.

Roo1.jpg

  1. ) Clicking on the Rooms link under Admin will take you to the section displayed above.
  2. ) Clicking on a room name will allow a user to edit the room name / settings.
  3. ) Expanding a room will reveal the camera(s) associated with a room, clicking on a camera will allow a user to edit the camera name / settings.

Clicking on a room name or clicking Add Room will pull up the room settings as shown below.

Roo2.jpg

  1. ) Room Name: A room name can be entered here, this name is the identifier that will be used throughout the rest of the system.
  2. ) Container: This specifies the container the template will use. Users are only able to see objects that are in the same container or a sub container.
  3. ) Cameras: This is used to associate cameras to a room.
  4. ) View Type: This can be used to define a view type default for the room, if no option is selected the system will automatically use the assumed best fit view type for the number of cameras.
  5. ) Use I/O: This checkbox should be checked if you are using a push button to start / stop recordings. When this is checked a sub menu with options will appear.
  6. ) Save / Delete: Once a room is configured pressing save will save the changes.

Clicking on a camera name or clicking Add Camera will pull up the camera settings shown below.

Roo3.jpg

  1. ) Add Camera: To add a new camera click the Add Camera button, if the system has available device licenses available a menu will pop up as shown above.
  2. ) Camera Name: This is a label that can be assigned to the camera, this name will be used throughout the rest of the system.
  3. ) IP: The DNS name or IP address of the camera should be entered here.
  4. ) HTTP Port: This is the port that will be used to authenticate to the camera (note: the default should be 80 unless changed within the camera).
  5. ) RTSP Port: This is the port that will be used to stream video between the camera and server (note: the default should be 554 unless changed within the camera).
  6. ) Username / Password: Enter a admin username and password for the camera.
  7. ) Rooms: This can be used to assign the camera to room(s).
  8. ) Camera Control Color: The control color can be changed using this color picker. Controls are overlaid on top of the video when enabled and include digital zoom and PTZ.
  9. ) Media Server: This option is used to define what server the camera is connected to.
  10. ) Brand: This drop down specifies what camera type is being used.
  11. ) Model: This drop down specifies what model camera is being used.
  12. ) Save: Once the camera settings are set pressing Save will commit the settings / changes.

Clicking on a camera name or clicking Add Device will pull up the device settings shown below.

Roo4.jpg

  1. ) Add Device: To add a new device click the Add Device button, if the system has available device licenses available a menu will pop up as shown above.
  2. ) Device UID: If an iPhone / iPad is being added the device UID will need to be entered on the client side as documented here: http://ipivs.com/wiki/Installing_Mobile_Devices
  3. ) Rooms: This is used to add the device to room(s).
  4. ) Device Name: This is a label that can be assigned to the device, this name will be used throughout the rest of the system.
  5. ) Device Type: This is used to define the type of device.
  6. ) Save / Delete: Make sure to click Save after settings are changed to commit the changes.

Containers

Containers are used to segment objects. A user is only able to see objects (rooms, templates, user groups) in their container or a sub container. Containers are typically implement when multiple departments with administrator(s) of each department are sharing a single software instance.

Cont1.jpg

  1. ) Clicking on the Containers link under Admin will take you to the section displayed above.
  2. ) Add Container: Clicking on Add Container brings up the menu shown on the right above.
  3. ) Container Name: This is the container identifier for the container throughout the rest of the system.
  4. ) Parent Container: Users have access to sub containers but not parent containers. To place a container under another use the Parent Container drop down.
  5. ) Save / Delete: Once a container is configured click Save to commit the changes.

Media Server

Media servers are used to stream video / connect to cameras and store video.

Meds1.jpg

  1. ) Clicking on the Media Server link under Admin will take you to the section displayed above.
  2. ) Add Media Server: Clicking on Add Container brings up the menu shown on the right above.
  3. ) This lists all the existing media servers configured for the software instance.
  4. ) Media Server Name: This is an identifier used throughout the system.
  5. ) Address: The IP address or DNS name of the server.
  6. ) SSL Port: If encrypted video is desired this designates the default port used (note: 444 is the default unless otherwise specified within configuration files and server firewall).
  7. ) SSL: This checkbox enables video encryption.
  8. ) Storage Folder: This designates the folder name that the video will be stored in (note: default is valt_recordings unless otherwise specified).

Users & Groups

The user and groups section is where all the user management is done and where all the permissions are set up.

Ug1.jpg

  1. ) Clicking on the Users & Groups link under Admin will take you to the section displayed above.
  2. ) Clicking on a group name will pull up the groups settings, clicking on the + next to a group will expand the group and reveal all the users associated with that group.
  3. ) Clicking on a user name will pull up the user settings.
  4. ) The search box can be used to quickly find a user or group

Group Management

Ug2.jpg

  1. ) Clicking on Add Group pulls up the group section on the right shown above.
  2. ) Group Name: This is used as an identifier for the group.
  3. ) Container: This specifies the container the user group will use. Users are only able to see objects that are in the same container or a sub container.
  4. ) Additional Containers: This is used to specify additional containers, any users within a group that has multiple containers would be able to see objects within both.
  5. ) Marker Template: This specifies the default marker template users within this group will use.
  6. ) Additional Marker Templates: This is used to specify additional marker templates, the additional templates will show up in a drop down that can be selected when a user clicks the mark button.
  7. ) Information Template: This specifies the default information template users within this group will use.
  8. ) Additional Information Templates: This is used to specify additional information templates, the additional templates will show up in a drop down that can be selected when a user clicks the record / schedule button.
  9. ) Rights: This section is used to designate what a user can do within the software, clicking the + next to any of the sections will reveal all the sub-rights.
  10. ) Rooms: This is used to assign access to rooms for users within the group. This access applies to both live and recorded video

Ug3.jpg

  1. ) Video Access: This section defines what videos users within this group have access to based on who authored the recordings. This applies to both live observation and review.
  2. ) Show Advanced Settings: Clicking this link will expose additional user group settings.

Ug4.jpg

  1. ) Retention Rule: This is used to define how long recordings are kept on the system before they are automatically deleted. Changing this setting will retroactively affect existing recordings.
  2. ) I/O Record Name: If a user within this user group is configured to author a recordings started or stopped using a button this setting will create the default recording name for those recordings.
  3. ) Max Record Duration: This setting defines the maximum record length before a recording is automatically stopped.
  4. ) Default Views: For sections that offer different view layouts (list vs. thumbnail) the default preference for users within this group can be set here.
  5. ) Search Results Display: This is used to set the columns / information that is displayed at the top level when looking at the search results within the review section.
  6. ) Filters: Filters are user specific by default but a filter (advanced search query) can be shared across a user group using this setting.
  7. ) Views: Views are user specific by default but a view (custom camera layout) can be shared across a user group using this setting.
  8. ) Reports: Reports are user specific by default but a report can be shared across a user group using this setting.
  9. ) Announcement: Anything entered in this field will show up in the home screen under announcements for the users within the user group.

Ug5.jpg

  1. ) Allow Access: This section can be used to restrict users to only be able to use the system during certain days or even certain times within certain days.
  2. ) Expiration Date: This can be used to remove access to the system for all users within the group on a certain date.
  3. ) Review list Default: This is the default number of days that are pulled up in the search query when a user within the group clicks the review button. The user can go back further to find older videos by adjusting the date range.

Ug6.jpg

  1. ) Clicking on Add User pulls up the user section on the right shown above.
  2. ) User Name: To create a local user account enter a user name.
  3. ) Password / Confirm: Assign the user a password.
  4. ) Group: This specified the user group the user will be a part of.
  5. ) Additional Groups: This is used if the user will be a part of more than a single group. From a rights and video access perspective the settings within both groups will be merged.
  6. ) Show Advanced Settings: Clicking this link will reveal additional user settings.

Ug7.jpg

  1. ) SAML IDP: This auto populates when an SSO / SAML user is imported and defines the IDP to be used to authenticate this user against.
  2. ) Mobile Pin: This is used in conjunction with our BEAM application and provides a pin code that is associated with the user account for use with BEAM.
  3. ) Control Type: This is used to change the PTZ control type for a user.
  4. ) Card Number: This is used in conjunction with card reader(s) so the system knows what card number should be associated with a user.
  5. ) Rooms: You can use this section to grant access to rooms, these would be in addition to what the user already has access to based on their user group.
  6. ) Display Name: This can be used so a different identifier is used throughout the system other than the actual account name.
  7. ) Video Access: This section is used to grant access to live / recorded video based on who authored it for the user, this is in addition to what they already have access to based on their user group.
  8. ) Allow Access: This section is used to grant / restrict access to the system during certain times / days. This setting would be in addition to what is set on the group level.

LDAP Management

Ug8.jpg

  1. ) Clicking on LDAP pulls up the user section on the right shown above.
  2. ) LDAP User Account: This can be used to import a single LDAP user, you will need to enter the full DN of the user account excluding the DC information. Example: CN=dstern,OU=Users
  3. ) Group to Add: This drop down is used to specify the group the LDAP user will be imported into.
  4. ) Import Button: Clicking this will query LDAP and import the specified user.

Ug9.jpg

  1. ) Server: Used to point to LDAP server / cluster using either the IP address or DNS name.
  2. ) LDAP Bind User: This is the account that will be used to bind / query LDAP.
  3. ) LDAP Bind Password: Once the server, bind user, and password are entered pressing Save should result in a connected message.
  4. ) LDAP Sync Schedules: Clicking on an existing sync schedule will pull the settings up on the right as shown. If no sync schedule is selected the settings will be blank.
  5. ) Name: This is an identifier for the sync schedule.
  6. ) Container: This drop down is used to specify a container for the sync schedule (this does not affect the imported users but just the sync schedule object).
  7. ) Bind Script: This is can be pointed to an OU or security group, the sync schedule will pull in all the matching user accounts. Example: CN=IVS_Admins,OU=User_Groups
  8. ) Group to Add: The users that match the bind script will be placed into this group automatically.
  9. ) Additional Groups: Users that match the bind script will be placed into these groups as well.
  10. ) Sync Type: The sync can be set to automatic or manual. The automatic interval can be adjusted to any duration but is set to 24 hours by default.
  11. ) Import: This button is used to execute the sync and bring in the matching LDAP user accounts.

SSO Configuration

Ug10.jpg

  1. ) Clicking on SSO (SAML) pulls up the section on the right shown above.
  2. ) Config Name: This is used as the IDP identifier
  3. ) Identity Provider: This is the IP address / identity provider url.
  4. ) Remote Sign-In URL: The remote sign-in URL of your IDP. Example: https://<adfs-server>/adfs/ls/
  5. ) Remote Sign-Out URL: The remote sign-in URL of your IDP. Example: https://<adfs-server>/adfs/ls/?wa=wsignout1.0
  6. ) Certificate: Used to upload created certificate.

Import Users

Ug11.jpg

  1. ) Clicking Import Users pulls up the section on the right shown above
  2. ) Group to Add: This drop down defines the user group the imported users will be associated with.
  3. ) Chose File: This button allows a user to browse to the file that contains the user data to be imported.
  4. ) Update: This button executes the import.

User Rights

The Valt system has a detailed user rights management system. Almost every feature / function can be enabled or disabled based on requirements. Below is a list of the rights and an explanation on how each translates to the application.

General

This includes general settings most of which apply to the application overall. General Rights:

Ug12.jpg

1) Home (1): this grants access to the home section of the application. The home section provides a dashboard of sections / objects that a user has access to. These include rooms (2), recent recordings (3), schedules (4) and reports (5) as shown below. If this right is unchecked this entire section is hidden from the UI, what parts of the home screen display depend on the other rights the user has.

Ug13.jpg

2) Alerts (1): If the alerts right is checked anytime an alert occurs the alert ribbon will pop up in the UI as shown below. Alerts will continue to display until someone acknowledges (2) them. Alerts include camera offline / online, media server offline / online, low disk space and other application health related items.

Ug14.jpg

3) Edit Profile: This right allows a user to edit the Display Name (3) and Email (4) associated with their user account. Clicking on the user icon (1) then navigating to User Settings (2) reveals these options as shown below.

Ug15.jpg

Change Password: This right allows a user to the password associated with the account by entering the current password (3) and new password (4). Clicking on the user icon (1) then navigating to User Settings (2) reveals these options as shown below.

Ug16.jpg

4) Password Rules: If this is enabled it will enforce password standards for local user accounts within the group. Those standards include: 10 failures = 3 min lockout, password complexity (3 of 4 uppercase, lowercase, number symbol), password history = cannot use last 3 passwords and password expiration = 180 days.

Upload

This right allows users to upload supported video formats to the Valt system. The uploaded videos can be tagged with information and markers just like video created using Valt. If the upload right is checked the upload button will show up on the main navigation pane as shown below.

Urup1.jpg

Upload Rights:

Urup2.jpg

1) Sharing: When a user clicks the upload button if they have the sharing right the sharing button (1) will appear as shown below. Users can use this to share the uploaded video with users that normally would not have access to it.

Urup3.jpg

2) Author: When a user clicks the upload button if they have the author right the author button (1) will appear as shown below. Users can use this to change the author of the uploaded video this can be important as access to the video is based on who authored it.

Urup4.jpg

3) Retention: When a user clicks the upload button if they have the retention right the retention button (1) will appear as shown below. Users can use this to change the length of time the video will be stored on the system for before it is automatically deleted.

Urup5.jpg

Observe

If the observe right is checked the observe button (1) will show up in the main navigation pane as shown below. The observe section is where live observation and camera control can be done within the application.

Urob1.jpg

Observe Rights:

Urob2.jpg

1) Views: Will be available in 5.1

  a. Create Views: Will be available in 5.1
  b. Delete Views: Will be available in 5.1

2) Search: The search right enables a search dialog box (1) that can be used to filter the rooms / cameras displayed within observe.

Urob3.jpg

3) Multi-Record: The Multi-Record feature (1) allows a user to start or stop recording on multiple rooms at the same time. If this right is enabled the user will see a checkbox to the left of each room name, clicking on the checkbox will select the room and a record all button will appear as shown below.

Urob4.jpg

4) Talkback: Clicking on a camera under observe will reveal the camera toolbar. If a user has the talkback right the microphone icon (1) will appear on the toolbar. Clicking the microphone will allow the user to talk back into the room through the camera output using a standard headset / computer microphone.

Urob5.jpg

5) PTZ: This right allows users to control a PTZ capable camera.

  a. Control: Clicking on a camera under observe will reveal the camera toolbar. If a user has the 
     control right and the camera is PTZ capable the PTZ icon (1) will appear on the toolbar. 
     Clicking the PTZ icon convert the mouse to a target (2) or display a directional arrow pad 
     (depending on user settings).  This can be used to move the camera around or zoom in / out.
  b. All Authors: This right allows a user to control PTZ cameras for other users recordings (only 

if the user has access to them).

  c. Presets: If the presets right is checked the preset dropdown (3) will appear as shown below.  A user can select from any of the existing presets to reposition the camera.
  i. Add / Delete: This right allows users to create new and delete existing presets.