Categories
Knowledge Support Highlighted Support exacqVision Client exacqVision Server Categories Products

Exacq Cloud Drive Setup

Cloud drive is a subscription plan available from an Exacq dealer for offsite, cloud based archiving of recorded video.

Contact an authorized dealer to discussing pricing and plans.

Minimum Client/Server Versions:
Client: 22.03.1
Server: 22.03.0

The following instructions detail the steps to be performed in sequence. These steps are also detailed in our Video Library. Steps performed in Cloudvue Manager must be performed by a dealer with login access and a valid Partner Code. Steps within ExacqVision may be performed by a customer or integrator onsite with Client access.

Step 1 – Customer Account Creation (Cloudvue Manager)

If the customer does not already have an account created, you will need to create one.

  1. Click the plus/add icon in the top corner and select ‘Add Account’.
  2. Enter the account name and contact information.
  3. Enter an assigned partner name.
  4. Leave the Customer ID and Site ID fields empty, these are reserved for other uses.
  5. Save your changes.

Step 2 – User Account Creation (Cloudvue Manager)

One or more user accounts will need to be added to the customer’s account. User accounts are used to bind the server’s uploaded data to their Cloud Drive storage.

  1. Click the plus/add icon in the top corner and select ‘Add User’.
  2. Add the user’s email address and optionally a phone number for contact.
  3. Change the Role to Enterprise.
  4. If an integrator/dealer is performing the entire setup on behalf of the user, create a password to use.
  5. If an integrator/dealer is working with the customer, check the box below for ‘Reset Password and accept EULA/TOS’. This will remove the password field. The customer will receive an email at the address entered and will use it to validate their email address and set a custom password.
  6. Enter a partner name.
  7. Assign the user to an account, created earlier.
  8. Leave the device and timeout fields alone.
  9. Two-factor authentication should not be checked for use with Exacq Cloud Drive accounts at this time.
  10. Save your changes.

Step 3 – User Validation (Email and ExacqVision Client)

If ‘Reset Password and accept EULA/TOS’ were checked in Step 2. The user will need to click the link in the email received.

The page that opens will prompt the user to create a new, custom password.

NOTE: The user MUST click the links to open the EULA and TOS before the ‘Agree’ checkbox below can be checked.

  1. Open the ExacqVision Client and navigate to the Archiving page.
  2. Create a new archiving profile by clicking the ‘New’ button towards the bottom.
  3. Change the archiving Type from ‘SMB’ to ‘Cloud Drive’.
  4. Enter the email address and password.
    a. If the password was set by the integrator/dealer, enter this here.
    b. If the password was customized by the user via the validation email, the customer will enter this new password here.
  5. Enter the Partner Code provided by the dealer/integrator.
  6. Select the Instance Region as directed by the dealer/integrator.
  7. Click ‘Apply’.

The status message will change to read ‘Step 1 of 4: Add the user to the NVR’. The next steps will be taken by the dealer in the Cloudvue Manager.

Provide the dealer/integrator with the system’s MAC address. This may be found by clicking ‘Configure System’ on configuration tree to the left, and clicking the System tab. The MAC address is located in the top-right corner beneath the license key.

Step 4 – Add User to NVR (Cloudvue Manager)

  1. Click the search icon in the top corner, and select ‘Search Video Devices’.
  2. Use the filters on the left to search for the system’s MAC address, do not use colons or dashes.
  3. Once the system has been located, double-click it to open the device details.
  4. Towards the top of the device details page, click the ‘Add Existing User’ button.
  5. Select the user account created earlier.

Confirmation that this step has been completed will appear on the Archiving page in the ExacqVision Client when the status changes to read ‘Step 2 of 4: Apply subscriptions to cameras’.

Step 5 – Add Subscriptions to Cameras (Cloudvue Manager)

  1. On the device details in Cloudvue Manager, click Subscriptions to expand this section.
  2. The system’s cameras will be listed. A Service Plan MUST be selected for each camera in the list, even if archiving no data from it. If the camera will not be archiving, select ‘TCVMSEXQA – VMS Only Exacq Annual’.

    The plans are displayed dynamically based on the recording settings for the camera in the customer’s ExacqVision server. Therefore you cannot set a camera recording 4K video to a plan for 720p video.
  3. Select the Storage Retention and Quality settings.
  4. The price displayed will update as the settings are changed.

NOTE: If cameras are added/removed or recording settings are changed in the client, the Enable checkbox on the Archiving profile will need to be disabled, then re-enabled to send the changes to Cloudvue Manager. Re-load the page and the camera list and available plans will update accordingly.

Once the subscriptions have been saved. The status in the ExacqVision Client will update again, to read ‘Step 3 of 4: Create an archiving schedule’.

Step 6 – Set the Archive Task (ExacqVision Client)

The Archiving Target created tells the system WHERE to archive data. A Task Schedule must be created to the right, which tells the system WHEN to archive data.

  1. Click ‘New’ under the Task Schedule panel.
  2. Give the task a descriptive name. More than one task may be created if, for example, you wish to perform archiving on different hours for different days.
  3. Set the Start Time, when the system will begin this task.
  4. Set the End Time.
    – Continuous; will begin archiving when the start time is reached and check for new content every five minutes
    – Until Finished; will begin archiving when the start time is reached. When it finds no new data to archive the task stops until the next start time is reached and begins again.
    – User Defined; will begin archiving when the start time is reached and stop when the end time is reached. This may be useful for environments where network bandwidth or system resources are in higher demand during certain hours of the day. An example is an office where staff work from 9am to 6pm and during those hours network bandwidth is in high usage and servers are recording more data due to increased activity. After normal work hours there is less activity to record and lower bandwidth usage after most people have left for the day. In such cases an admin may choose to schedule archiving to take place during the off hours to use the systems and network more efficiently.
  5. Click ‘Apply’.

Step 7 – Set the Archive Schedule (ExacqVision Client)

After telling the system WHERE and WHEN to archive data in the previous steps, you must tell the system WHAT to archive.

  1. Click the Schedule tab at the top of the Archiving page.
  2. You should only see the cameras with Cloud Drive subscriptions applied available.
  3. Select the ‘Days’ tab to schedule one or many cameras by day, or select the ‘Sources’ tab to schedule one camera on one or many days. If using the Days tab, you may apply your settings to other days utilizing the Copy Current Configuration region below the schedule panel.
  4. Highlight the hours you wish to set a schedule for, then select from the Settings above.
    You may choose to archive All data, Motion data, Alarm data, or no data for each specific hour.
    Record settings and archive settings to not have to be configured for the same type of data. As an example, you could record free run video on a system at a certain time, but then choose to archive only the motion video recorded during the same period to the Cloud Drive.
Categories
Knowledge Support Support exacqVision Client exacqVision Server Categories

SCN-00000012 – Cloud Drive

SCN #SCN-00000012
Title of SCNCloud Drive
TRAC #
Effective Version9.8
Products AffectedServer, Client, Mobile
Reason for Change (Summary)New Feature

Change

The Cloud Drive feature was officially added in 9.8, however we expect its use to grow with the release of the G-Series Micro.  This document is intended to explain how the feature functions and what you’ll need to know to troubleshoot.

Upon upgrade or installation of 9.8 and above, a new directory is created in the Server’s installation folder called ‘cloud-drive’.  All executables, libraries and logs for Cloud Drive functioning are found here.  When the service starts, ‘exacqd.exe’ starts first, which then starts ‘core.exe’ and ‘evclouddrive.exe’.  You can verify that the integration loaded on the ‘System Information’ page:
NOTE: The version will not match the currently running Server version.

After the dealer/integrator purchases the service, the end-user will receive the following email from Exacq Orders:

After registering, the customer will then add an Archive target using the drop-down box to select ‘Cloud Drive’ with the credentials created.  Server credentials need to be Power User level, or a Custom User Group with the following Privileges:

  • Allow Live Viewing:
    • Available in Live Cameras
  • Allow Searching:
    • Available in Search Cameras
    • Export
  • Configuration:
    • Case Admin

No ‘Task’ is scheduled for Cloud Drive functioning as the integration runs in real-time and uploads video on the fly.  After clicking “Apply”, the credentials are verified, and the Status should show “Connected”.  (May show “Integration Not Connected” for up to 30 seconds on first connection.)  Users will then go to the ‘Schedule’ tab to select which streams will upload video (similar to setting up a regular Archive target).

Upon successful configuration, the following elements are added to the Archive XML:

<Archives ID="3735552" MaxTargets="16" CanSchedule="1" SupportContentAge="1" SupportArchiveBookmarks="1" AtMostExpiration="1" SupportsTargetSearch="1" MountSeconds="5" TestSeconds="5" TaskRetrySeconds="5" LinuxMountRoot="/mnt" GUID="3067098b-2461-9015-9175-03b4f5bb5ff2" NfsSupported="0" CloudVersion="2" IscsiSupported="1" IscsiDisconnectSeconds="30">
    <Defaults Type="4" Address="https://exacq-messaging.cloudvue.com" SearchAddress="https://exacq-gateway.cloudvue.com/v1/exacq" />
    <Archive ID="1" Enabled="1" SearchUsername="blah@email.com" SearchPassword="Custom_Password!" SearchEnabled="1" Address="https://exacq-messaging.cloudvue.com" Type="4" Username="blah@email.com" Password="Custom_Password!" SearchAddress="https://exacq-gateway.cloudvue.com/v1/exacq" CloudDriveUsername="admin" ArchiveBookmarks="0">
        <Devices ID="4718592">
            <Device Number="3">
                <Video>
                    <Input Number="0">
                        <Schedule>
                            <Entry FirstHour="0" LastHour="167" Archive="2" />
                        </Schedule>
                    </Input>
                </Video>
            </Device>
        </Devices>
    </Archive>
</Archives>

Currently, Cloud Drive runs as an executable along-side the Server service as if it were an integration.  This is because we are relying on a library from Smartvue that we don’t have control over (smv-cloud.dll or .so).  It is expected that Cloud Drive will eventually be a plug-in within the Server itself.  This library is used to upload video clips to Smartvue’s cloud service.  Aside from this library, Cloud Drive was written entirely in-house.  It’s important to remember, for the purposes of supporting this feature, that ‘Cloud Drive’ is an exacqVision feature, and not to be referred to as a ‘Smartvue’ or ‘Tyco Cloud’ product.

The Archive plug-in only logs that the Cloud Drive integration has launched, all functioning logs are separate from the Server’s logs and stored in …/cloud-drive/logs/ and will follow the Server’s model of a text file named YYYYMMDD.txt.  The Client is not yet able to access and search these logs, so they will need to be grabbed from the Server manually. Even if the Client shows “Connected” on the Archive page, this only verifies that the integration has successfully connected to the cloud.  The only reliable way to verify that the integration is functioning as expected is to check the log and look for the following line:

2019-02-22T23:59:02.000Z 14067365159 INFO     successfully uploaded clip for uuid /tmp/4719360_1550879897563.mp4:

Video clips are stored in the Server’s TMP directory (Windows: C:\Windows\Temp – Linux /tmp/).  Clips will be a maximum of 30s and are named as follows:  <CameraID>_<EpochTimeClipStarted>.mp4

Pending uploads are queued and will be sent to Smartvue’s Azure service limited by the customer’s ISP allowed bandwidth, as well as Azure’s bandwidth capabilities.  Once the clip is successfully uploaded, the clip is deleted from Temp.

A maximum of 3 clips per enabled device will be queued to avoid filling up Temp space.  If the queue is full, the integration will discard new video until the queue lowers. (This does not impact local video recording, only what is sent to the Cloud)

Clips sent to the Cloud are not ever deleted by the integration.  The customer’s subscription will define how many clips can be stored and will roll them off on a First-In-First-Out basis. 

When the exacqVision Server service starts, any previous clips that remain in the queue are deleted.

Once the exacqVision Client successfully connects to a Server with Cloud Drive enabled, that Client is able to search video seamlessly pulling from the Server, any Archive targets, or video uploaded to Cloud Drive utilizing the Client’s ‘Direct Search’ feature.  All video is “stitched” together in the Search timeline.  You can determine the location of the searched video by right-clicking the meta-data and checking the ‘Location’:

The Client uses its own Curl executable to download the .mp4 cloud video via HTTPS (port 443), then holds the frames for viewing and exporting to any of the regular supported formats.

Direct Search Enabled – Prefer System Video:
               Video will be pulled from the Server, then the Archive and Cloud will be searched to fill in any gaps.

Direct Search Disabled:

               Only video stored on the Server’s local and extended drives will be searched.

Direct Search Enabled – Prefer Archive Video:

               Video will be pulled from the Archive, then the Server and Cloud will be searched to fill in any gaps.

Direct Search Enabled – Prefer Cloud Video:

               Video will be pulled from the Cloud, then the Server and Archive will be searched to fill in any gaps.

Additional Documentation

KB 61359 – Configuring Cloud Drive

KB 46560– Troubleshooting Cloud Drive

https://trac.exacq.com/DVR/wiki/ServerCloudDrive

https://trac.exacq.com/DVR/wiki/MobileSmartVueIntegration

Other information

  • Supported with Start, Professional and Enterprise licenses.
  • Audio is not currently supported for upload to Cloud Drive.
  • Only H.264 cameras are supported.
  • “Pre-record” video is not uploaded, but “post-record” is.
  • Azure upload speeds can be tested with the following link:
    http://azurespeed.com/Azure/UploadLargeFile
    • The service should be stopped during test.
    • You can use one of the mp4 files in Temp for the test.
  • Bookmarked video sent to the Cloud is never deleted.
Categories
Documentation Data Sheets exacqVision Server Categories Products

ExacqVision Cloud Drive Data Sheet

exacqVision-Cloud-Drive.pdf

Categories
Knowledge Support Support exacqVision Client Categories exacqVision Webservice Products

Adding a new server to the exacqVision Integrator Services Portal Outbound Connections Tab

To add a new server to the Integrator Services Portal(ISP) instance you will need a thick client connection to the server.

Proceed to the server outbound connection tab:

  1. Click on Configure to enter your Portal credentials.

    Portal credentials are provided when your dealer ISP instance is created. If you don’t have a portal account submit your information at https://exacq.com/contacts/form/
  2. You can also reset your password for the portal using the Reset password link
  3. Enter your ISP credentials if you are not already logged in.
  4. The new server will show up as connected in your dealer ISP instance.

<br>