Content Distribution and Delivery
Revised: May 13, 2015
OL-15762-03
|
|
We prepared this material with specific expectations of you. |
Note This material pertains to multiple releases of Cisco DMS.
Concepts
- Overview
- Understand DMP Support for the CIFS Protocol
- Choose a Content Delivery System to Use with DMPs
- DMS-CD Concepts
- Guidelines
- Restrictions
- Example Scenario
Overview
Commonly, the bandwidth capacity required to deliver an HD video stream ranges from 10 Mbps to 15 Mbps. In contrast, an average SD video stream uses approximately one-third as much capacity. However, these parameters are highly configurable and will vary from one WAN to another.
Content distribution technologies can make perfect copies of important files from your origin server and store the duplicates on multiple nodes in your network. Later, anyone who needs one or more of these cached files can obtain them quickly from a node that is closer to them than the origin server and less heavily loaded. Such methods improve network scalability and user experience.
Topics in this chapter explain how to use content distribution technologies with Cisco Digital Media Player (DMP) endpoints. Your understanding these important concepts will help you to use content distribution successfully.
Understand DMP Support for the CIFS Protocol
Common Internet File System (CIFS) is a network protocol for sharing files and for obtaining remote access to those files.
A CIFS share is a mount point on a network attached storage device that supports the CIFS protocol. When you choose WAAS as your content distribution method, Cisco Digital Signs instructs DMPs to use the CIFS protocol and mount a network share, such as a Windows shared folder, that uses CIFS.
Choose a Content Delivery System to Use with DMPs
In media networks, it is sometimes necessary to distribute large files where bandwidth capacity is moderately or severely constrained. The challenge of doing this successfully is that delivering HD or SD video streams and deploying large assets often requires an average data transfer rate of greater than 6 million bits per second (Mbps, or megabits). Media networks can compound your need for bandwidth.
There is a practical maximum limit in any WAN for how much bandwidth each of its remote sites can use, and a content delivery solution can help you to manage multicast file distribution efficiently to the DMPs that operate at your remote sites. In this way, content delivery solutions can enhance the scalability of your existing network infrastructure and adapt it for media deployments.
DMS-CD Concepts
DMS-CD Overview
Anyone who has purchased a valid license to use this release of Cisco Digital Signs also has a perpetual license to use its built-in implementation of DMS-CD. No additional software is required and there is no recurring cost.
Cisco DMS Content Distribution (DMS-CD) is a file delivery and management mechanism. It conserves network bandwidth and optimizes playback performance by provisioning creative assets directly to your DMPs. You can use FTP or SFTP to transfer multiple playlists and presentations to DMP local storage.
Retry Timeout
- The factory default Retry Count value is 5.
- The factory default Retry Timeout duration is 300 seconds.
Given these values, you can expect that DMS-CD — when it uses default values — takes as long as 1,500 seconds (25 minutes) to detect assets or determine that a DMP is unreachable and give up. In cases when this duration is too long, you might try changing the Retry Timeout value from 300 to 30.
Concurrent Deployments
Most DMS-CD deployment preference settings that you define take effect during the next scheduled DMS-CD deployment. However, any time that you change the “Number of concurrent deployments” value, you must restart your DMM appliance and run a scheduled DMS-CD deployment before the changed setting takes effect on your DMPs.
DMS-CD Performance Factors
Differential Download Intelligence
Differential download intelligence in DMS-CD prevents the needless provisioning of any asset more than once to any DMP that uses it and already has downloaded it, even if you have used the asset repeatedly in multiple playlists or presentations. Your DMPs retain their valid assets and download only what is new or has changed.
Bandwidth Consumption
A systemwide threshold that you define limits in your WAN how much bandwidth is used per session when DMS-CD provisions assets to one of your DMPs.
For example, a limit of 1.2 mbits means that file transfer speeds for DMS-CD deployments cannot exceed the maximum threshold of 1.2 mbits per DMP.
Thus, if your deployment provisions assets to 20 DMPs, the maximum WAN bandwidth that DMS-CD uses is 24 mbits, because 20 x 1.2 = 24.
Resumption of Interrupted and Paused File Transfers
File transfer resumption in DMS-CD helps to compensate for bandwidth throttling and other constraints that might limit how many assets you can provision at a time. Such constraints commonly include a limited number of nighttime hours when deployments are certain not to disrupt the digital signage messages or Cisco Cast programs that your organization shows to its targeted audiences.
Values that you define at Deployment Manager > Deployment Preferences determine in part how DMS-CD responds to any incomplete file transfers, but its response also considers the size of individual files within a deployment package. Finally, a DMP might generate a queue for itself if it is the target of multiple deployments, because a DMP can receive data from only one deployment package at a time.
When the scheduled delivery of a deployment package is interrupted — by a power failure or a network outage, for example — while you are provisioning assets, the file transfer process might resume automatically at a later time.
- When sufficient time remains during the same deployment window that was interrupted, your file transfer resumes after your retry interval has elapsed.
Tip You set this interval in the “Deployment retry time (in seconds)” field.
- When the interruption extends past the end of the scheduled deployment window and the deployment is scheduled to recur, file transfer resumes automatically the next time that the deployment is scheduled to run.
- When the interruption extends past the end of the scheduled deployment window but you did not schedule the deployment to recur, file transfer stops without success and does not recur.
Likewise, the maximum number of times that DMS-CD tries to provision assets for an interrupted deployment package is constrained by the “Deployment retry count” value.
When your deployment is scheduled to recur, DMS-CD will either pause or stop the transfer of assets whose transfer did not finish during the deployment window. DMS-CD uses file size to determine whether an incomplete file is paused or stopped:
- Transfer is stopped for any partially transferred file whose size is less than 6 MB, no matter how much of it was transferred. Transfer of a 100 KB file, for example, must start over again from the first byte when the deployment recurs.
- Transfer is paused for any partially transferred file whose size is greater than 6 MB, no matter how little of it was transferred. A file whose size is 1.6 GB, for example, is paused when none of your DMPs can download more than 200 MB per day.
Tip • Calculations of this kind can help you to estimate how far in advance you should schedule the first instance of a recurring deployment. When you know already, for example, that one-fifth of the data within a deployment package can transfer to DMP local storage during the deployment window that you reserved, then you know also that the deployment must recur on at least 5 separate days or your DMPs will not receive their assets in time.
- We recommend that your deployments recur once each day.
- When a deployment is scheduled to recur at any other interval than once per day — such as once per week — then this is the interval after which any paused transfer will resume.
Each DMP considers its group memberships when it starts to receive provisioned data from DMS-CD.
- DMPs that are assigned to only one DMP group apiece accept provisioned data to the best of their capacity.
- DMPs that belong to multiple groups, which are scheduled to receive differing deployments simultaneously, can receive only one of these deployments at a time. When they are the target of simultaneous deployments, DMPs generate a queue for themselves and receive the various deployment packages one at a time. Depending on the size and relative importance of one package over another, such DMPs might sometimes lack assets that you planned for them to have.
- You can use the Play Now feature to deploy an empty playlist to any DMPs whose local storage has kept copies of obsoleted assets. This method clears local storage quickly.
- Alternatively, when local storage contains a combination of assets — some needed, others not — you can create and deploy a playlist that includes only the useful assets. The DMPs that receive this deployment will keep what they need and delete everything else.
Understand Shared Scheduling Features for Deployments
Because DMS-CD uses the same scheduling features that are built into Cisco Digital Signs, you can schedule assets to be provisioned late at night or at other convenient, planned times. Furthermore, reporting features in Cisco Digital Signs show you which DMS-CD deployments have succeeded or failed and show you which files were deployed to each DMP.
Understand DMS-CD Alert Reports
Monitoring Modes
The Alert Reports feature supports modes that you can use when checking for DMS-CD deployment errors.
Error Conditions
DMS-CD logging captures, detects, and reports these error conditions.
Alert Types
Successes or failures, exclusively
These options from the Type list cause a filtered report to describe only the DMS-CD deployments that failed or succeeded.
These options from the Type list cause the filtered report to describe only the events that DMPs reported. Therefore, some of them might pertain to disrupted or failed deployments with DMS-CD.
When you choose the All Internal Events option from the Type list, these event types also pertain to DMS-CD deployments.
Guidelines
Note You must restart your DMP after you switch it from ACNS mode to ECDS mode. Although we recommend generally that you restart your DMP after you switch its mode from any content distribution method to another, it is mandatory only when you switch from ACNS to ECDS. (CSCto35473)
DMS-CD Guidelines
Gather the Essential Data to Develop a Deployment Strategy
DMS-CD deployments and deployment packages are all unique in their own ways. However, a repeatable process supports your development of the strategy for any such deployment. After you gather and record the numeric values that describe key factors, simple arithmetic leads you to a deployment strategy that we expect should be effective in your network.
The worksheet in this section explains and records these numeric values and guides you through the simple equations to plan a successful deployment.
Note This worksheet assumes that all targeted DMPs in a deployment have identical network bandwidth capacity available to them.
|
|
||
---|---|---|---|
Either the maximum transfer rate that you defined for DMS-CD or the result of factors that further constrain this rate.
Q. The lower of these values is exactly what? |
|
||
The product of two values that you multiply. Q. What is the product (in gigabytes) when you multiply B1 by B2? |
|
||
Q. What value is in effect for the Number of concurrent deployments preference setting? |
|
||
The product of two values that you multiply.
Q. What is the product (counted in hours) when you multiply D1 by D2? |
|
||
Q. Compare the values of E1 and E4. The lower value is exactly what? |
|
||
The quotient when you divide one value by another.
Q. What is the quotient (counted in hours) when you divide F1 by F2? |
|
Limit DMS-CD Disruptions to DMP Performance
Improper scheduling practices and improper WAN bandwidth parameters in your media network might cause DMS-CD to disrupt playback performance temporarily on DMPs. The disruption affects multicast video streams, HD videos, Shockwave Flash animations, and image assets that these DMPs show on their attached presentation systems while simultaneously downloading newly provisioned, large assets. When this disruption occurs:
- Videos might become fragmented (contain artifacts), drop frames, or cut out during playback.
- SWF animations might play slowly.
- Images might redraw slowly.
- DMPs might restart unexpectedly, in rare instances.
You can configure bandwidth restrictions in your WAN that should help to alleviate these symptoms or eliminate them completely, depending on the system load of each DMP.
We recommend that you apply these DMS-CD best practices in your network whenever possible.
- Create and maintain only one deployment package for any DMP group whose constituent DMPs should play assets from local storage. Simply configure its deployment to recur nightly (or whatever other time has the least possible impact on your audience). Then, modify it as necessary, to:
– Include all new or changed assets that member DMPs should obtain or keep for playback.
– Remove obsolete assets that member DMPs should autoclean from local storage.
DMS-CD syncs DMP storage with the current version of the deployment package and applies all changes automatically.
Note This method is simpler and more scalable than developing and maintaining a new package and scheduling a new deployment each time that your needs change. Also, it increases the likelihood that large deployments will resume and be completed successfully on a slow connection. Furthermore, it prevents deployments from becoming too numerous to manage.
- Even if you have not imposed any bandwidth restrictions upon DMS-CD, avoid scheduling deployments and playback to run in parallel on DMPs. Otherwise, deployments can take longer to finish than you anticipate. (This delay occurs because the load is doubled on DMPs.) For best results, schedule DMS-CD deployments to run when no playback is scheduled. During such times, there is little or no load on DMPs.
- When playback and deployments must overlap, configure an upper threshold for DMS-CD bandwidth consumption. The value that you enter should be less than your network’s maximum transfer rate. Adjust and test values as necessary, until you determine exactly how much bandwidth DMS-CD can use in your WAN without affecting DMP performance.
Tip Use the “Enable maximum transfer rate” field (at Digital Media Players > Deployment Manager > Deployment Preferences) to limit DMS-CD bandwidth consumption.
Note In our tests, we found that using 5 Mbps as the upper threshold provided adequate bandwidth restriction in most cases. However, this is not necessarily a value that you should use. Results will vary depending on network capacity and the load placed on a DMP.
Restrictions
DMS-CD Restrictions
|
|
---|---|
|
|
|
3 DMPs3 |
|
300 MB4 |
|
- We do not support use of the “Cast” plugin for Digital Media Designer with any content distribution system or network. ( CSCto35473)
- Even though Microsoft Internet Information Server (IIS) is not case-sensitive, any use of IIS can trigger case-sensitive behaviors in DMS-CD. This occurs because DMS-CD uses all lowercase letters during its creation of a local folder whose name matches the FQDN of the external IIS host. When any asset URL includes even one uppercase letter in reference to the IIS host FQDN, DMS-CD cannot find any local folder by that name and, so, cannot find its local copy of assets to render. The error message in this case is “Size = Not Available is not available with the File Access Service. The status is FAILED.” ( CSCtn07580)
- This DMS-CD release does not support live video. It provisions assets that already exist.
- This DMS-CD release provisions assets to DMPs exclusively. You cannot target any other device type.
- This DMS-CD release does not delete files from any DMP that belongs to multiple DMP groups. For autocleaning to occur on a DMP, it can belong to one DMP group only. Alternatively, you can use Play Now to deploy a job to DMPs.
- You can attach only one external USB flash drive or external USB hard drive to a DMP.
- We do not support USB hubs or any other method that you might use to attach multiple drives (or other device types) to a DMP.
- DMS-CD does not prevent you from using the Actions list or the Play Now feature to start transferring a DMS-CD deployment package immediately. However, using either of these methods defeats many of the most important benefits of using DMS-CD. We recommend instead that you use the Play in Future feature to schedule all of your DMS-CD deployment packages.
- You cannot use the Deployment Status feature (at Digital Media Players > Deployment Manager > Deployment Status) to check the progress or status of immediate deployments.
CIFS Restrictions
- We do not support use of the “Cast” plugin for Digital Media Designer with any content distribution system or network. ( CSCto35473)
- When the password for a CIFS volume contains even one “ % ” symbol, a DMP 4310G cannot mount CIFS. This behavior is by design.
- Playback is choppy for HD video that a DMP 4310G renders from a mounted CIFS volume. However, a DMP 4400G can render the identical file without difficulty. ( CSCtj00686)
- There can be only one CIFS mount point, which all DMPs use in common. You cannot set DMPs or DMP groups to mount any CIFS share except this one.
- Either your DMPs all use CIFS, or none of them do.
ACNS Restrictions
- We do not support use of the “Cast” plugin for Digital Media Designer with any content distribution system or network. ( CSCto35473)
Note You must restart your DMP after you switch it from ACNS mode to ECDS mode. Although we recommend generally that you restart your DMP after you switch its mode from any content distribution method to another, it is mandatory only when you switch from ACNS to ECDS. (CSCto35473)
ECDS Restrictions
- We do not support use of the “Cast” plugin for Digital Media Designer with any content distribution system or network. ( CSCto35473)
- Intra-playlist transitions take longer (by 1 or 2 seconds apiece) during playback in ECDS mode than they take in any other mode. Also, a gray screen is visible briefly between videos. ( CSCtl143456)
Note You must restart your DMP after you switch it from ACNS mode to ECDS mode. Although we recommend generally that you restart your DMP after you switch its mode from any content distribution method to another, it is mandatory only when you switch from ACNS to ECDS. (CSCto35473)
Example Scenario
Acme might be almost any kind of organization that uses digital signs. In this scenario, Acme uses digital signs at five of its sites. The scenario describes how Acme organizes its DMPs across these sites, and then optimizes its schedule and settings for efficient delivery of strategic assets to DMPs.
Because the standard floorplan at Acme allows for five signs per site, the Acme signage network combines 25 DMPs with 25 digital signs. As there are five weeknights per week and coincidentally, five DMP groups at Acme, its technical staff use a streamlined deployment strategy.
They create and save just five deployment packages in total — merely one per DMP group. They update the assets in each package according to a schedule for planned changes. They configure each package deployment to recur once per week, on a weeknight. Then, as needed, they can use the Play Now feature to deploy urgent or mission-critical changes in real time, if the standard timeslot is not appropriate.
Organizational Logic at Acme
Deployment Scheduling Logic at Acme
Table 19-4 explains how Acme organizes its scheduled deployments.
|
|
|
|
|
|
|||
|
|
|||||||
Regularly scheduled deployment for Group 1 recurs overnight each Monday, from 10:00 p.m. to 6:00 a.m. 7 |
||||||||
|
||||||||
Regularly scheduled deployment for Group 2 recurs overnight each Tuesday, from 10:00 p.m. to 6:00 a.m. 2 |
||||||||
|
||||||||
Regularly scheduled deployment for Group 3 recurs overnight each Wednesday, from 10:00 p.m. to 6:00 a.m. 2 |
||||||||
|
||||||||
Regularly scheduled deployment for Group 4 recurs overnight each Thursday, from 10:00 p.m. to 6:00 a.m. 2 |
||||||||
|
||||||||
Regularly scheduled deployment for Group 5 recurs overnight each Friday, from 10:00 p.m. to 6:00 a.m. 2 |
||||||||
|
||||||||
Procedures
Configure ACNS or WAAS
Tip See our integration white paper on Cisco.com: Cisco Digital Media Suite Deployments for Digital Signage with Cisco ACNS Software.
Step 1 Choose Settings > Media Delivery, and then choose the options that meet your requirements.
Step 3 Stop. You have completed this procedure.
Configure DMS-CD
Configure Deployment Threshold Preferences
Step 1 Choose Digital Media Players > Deployment Manager > Preferences.
Step 2 Define the DMS-CD thresholds that should be applied by default in the future, when you transfer deployment packages.
Changes to the maximum transfer rate will have no effect on deployments that are running already. They are applied to deployments that start after you save your changes.
Step 3 Click Update to save your work and put it into effect.
OR
Click Cancel to discard your work and restore the previous entries.
Step 4 Stop. You have completed this procedure.
Check Disk Space Capacity for Deployments
Step 1 Choose Digital Media Players > DMP Manager.
Step 2 Click in the DMP Groups object selector the name of the DMP group that contains the target DMP.
The DMP List table is repopulated with the corresponding group membership list.
Step 3 (Optional) Would you like to limit how many DMPs the DMP List table describes?
Use filtering options above the table.
Step 4 Add together the values that you see in the Internal Storage MB. (Total/Free) column and the Internal Storage MB. (Total/Free) column.
The combination of these values is the total free capacity.
Step 5 Compare the total free capacity to the expected size of your deployment package.
– Reduce the size of the deployment package.
– Delete unused or unimportant assets from the DMP.
– Attach one external USB drive to the DMP if you have not attached one already.
– Replace the external USB drive with one that has greater capacity.
Step 6 Stop. You have completed this procedure.
Create a Deployment Package
- Configure download threshold preferences for DMS-CD.
- Check the free disk space on your DMPs for storing provisioned assets.
Step 1 Choose Digital Media Players > Advanced Tasks.
Step 2 Choose Deployment Package from the Application Types list.
Step 3 Click Add New Application.
Step 4 Enter a name and description for this deployment package.
Step 5 Choose the mount point for this deployment. You can choose only one:
Tip To learn which external USB drives we support and have tested, see Cisco DMS compatibility information on Cisco.com. http://www.cisco.com/en/US/products/ps6681/products_device_support_tables_list.html.
Step 6 Does this job consist of assets for an emergency notification?
Step 7 Populate and save the deployment package.
Step 8 Click the name of a category in the Applications list.
Step 9 Choose at least one option from the Available Applications list, and then click Select Applications.
Step 11 Use the Play in Future feature to schedule deployment of this package to your DMPs that should receive it, and then wait for the file transfer to finish.
Bandwidth capacity in your WAN determines how long you must wait. After the deployment is finished, Cisco Digital Signs autogenerates the (Go To) URL action for this deployment package.
Step 12 Choose Digital Signage > Digital Medial Players > Advanced Task > (Go to) URL.
Step 13 Check that a (Go to) URL action was autogenerated, which adds the prefix LOCAL to the name that you entered in Step 4.
Step 14 Deploy this autogenerated (Go to) URL action.
When you use Play in Future, the scheduled start and stop times are derived from the clock in your DMM appliance.
Step 15 Stop. You have completed this procedure.
Edit a Deployment Package
- Configure download threshold preferences for DMS-CD.
- Check the free disk space on your DMPs for storing provisioned assets.
- Create at least one DMS-CD deployment package.
Step 1 Choose Digital Media Players > Advanced Tasks.
Step 2 Choose Deployment Package from the Application Types list.
Step 3 Click the name of the deployment package to be edited.
Step 4 Click Edit Application.
Step 5 As needed, edit the name or description for this deployment package.
Step 6 Choose the mount point for this deployment. You can choose only one.
Tip To learn which external USB drives we support and have tested, see Cisco DMS compatibility information on Cisco.com. http://www.cisco.com/en/US/products/ps6681/products_device_support_tables_list.html.
Step 7 Does this job consist of assets for an emergency notification?
Step 8 (Optional) Would you like to repopulate this deployment package?
Step 9 Click the name of a category in the Applications list.
Step 10 Choose at least one option from the Available Applications list, and then click Select Applications.
Step 12 Use the Play in Future feature to schedule deployment of this package to your DMPs that should receive it, and then wait for the file transfer to finish.
DMS-CD does not prevent you from using the Actions list or the Play Now feature to start transferring a DMS-CD deployment package immediately. However, using either of these methods defeats many of the most important benefits of using DMS-CD. We recommend instead that you use the Play in Future feature to schedule all of your DMS-CD deployment packages.
Bandwidth capacity in your WAN determines how long you must wait. After the deployment is finished, Cisco Digital Signs autogenerates the (Go To) URL action for this deployment package.
Step 13 Choose Digital Signage > Digital Medial Players > Advanced Task > (Go to) URL.
Step 14 Check that a (Go to) URL action was autogenerated, which adds the prefix LOCAL to the name that you entered or edited in Step 5.
Step 15 Deploy this autogenerated (Go to) URL action.
When you use Play in Future, the scheduled start and stop times are derived from the clock in your DMM appliance.
Step 16 Stop. You have completed this procedure.
Delete a Deployment Package
- You must have saved at least one DMS-CD deployment package.
- Use the Reports feature (at Schedules > Reports) to search your schedule for any instances of the deployment package that you will delete. Remove each scheduled instances of it from your schedule.
Step 1 Choose Digital Media Players > Advanced Tasks.
Step 2 Choose Deployment Package from the Application Types list.
a. Click the name of the action to be deleted.
Step 3 Choose (Go to) URL from the Application Types list.
a. Click the name of the action to be deleted.
Step 4 Stop. You have completed this procedure.
Reference
Software UI and Field Label Reference Tables
Elements to Define Deployment Thresholds
Digital Media Players > Deployment Manager > Preferences
|
|
|
The maximum allowed number of FTP or SFTP threads, or sessions, that can run concurrently when DMS-CD provisions assets to DMPs.8 Therefore, the maximum number of DMS-CD deployments that might possibly run concurrently in your WAN, if each such deployment targets only one DMP. Otherwise, when any deployments target multiple DMPs, this constraint limits how many DMPs can possibly receive deployments concurrently in your WAN.9 The permitted value is any whole number in the range from 1 to 1000. The factory-default value is 100 threads. We recommend that you avoid using any value greater than 100. Each incrementally higher value authorizes more concurrent DMS-CD deployments to DMPs and an increased load on your DMM appliance. You might try reducing this value if you notice that the CPU load is high on your DMM appliance during DMS-CD deployments. Note Any time that you change this value, you must restart your DMM appliance before the changed setting takes effect on your DMPs. |
||
The count of how many minutes will be allowed to elapse after a DMS-CD deployment package begins to provision any file. Upon reaching this threshold, the file moves to the back of the queue and its transfer is deferred. The next file advances to the front of the queue and the deployment continues. DMS-CD applies this threshold to a deployment package as many times as necessary until it has cycled through all of its files, and then the transfer is resumed for a deferred file after it returns to the front of the queue. This threshold might cause the transfer of any especially large file to be distributed across days. Bottlenecks are prevented and as many assets are provisioned as can be provisioned. When you derive this value from the maximum transfer rate, large files in DMS-CD deployment packages are more likely to transfer quickly. The permitted value is any whole number in the range from 1 to 10080, where 10,080 minutes is the same as 168 hours or 7 days.The factory-default value is 1440 minutes, which is exactly 24 hours. |
||
The count of how many times DMS-CD should try again to restart a failed deployment, until DMS-CD stops trying. In combination with the deployment retry time, this setting has significant impact on how long it takes DMS-CD to detect failed deployments. For example, 5 retries x 300 seconds = 1,500 seconds (25 minutes), while 5 retries x 30 seconds = 150 seconds (2.5 minutes). The permitted value is any whole number in the range from 1 to 100. The default value is 5 retries. We recommend that you do not change this value. |
||
Enforces or ignores a maximum transfer rate that you specify. This rate is the upper threshold allowed for bandwidth consumption by DMS-CD during its deployments to any one DMP in your WAN. We measure this rate in kilobits per second (Kbps). The value that you enter should be less than the maximum transfer rate of your network. In combination with the Number of concurrent deployments value and the number of DMPs in a group that you target, this threshold limits how much bandwidth DMS-CD can consume during a deployment. For example, assume for a moment that QoS policies in your network limit DMS-CD bandwidth utilization to a maximum of 64 Kbps, and you have enabled the maximum transfer rate setting with a value of:
The permitted value is any whole number in the range from 28 to 102400, where 102400 Kbps is the same as 100 Mbps. The factory-default setting ignores this threshold. If you prefer to enforce it, check the check box. |
||
FTP or SFTP, according to your security requirements. When you choose SFTP, connections are encrypted between your DMM server and your DMPs. Otherwise, these sessions use clear text. Even though the factory-default setting is FTP, we recommend that you use SFTP. |
||
The maximum number of megabytes — per file — that DMS-CD will transport inside a multifile deployment package to your DMPs, before the file that reached this threshold is moved to the back of the queue and its transfer is deferred. The next file advances to the front of the queue and the deployment continues. DMS-CD applies this threshold to a deployment package as many times as necessary until it has cycled through all of its files, and then the transfer is resumed for the deferred file after it returns to the front of the queue. This threshold might cause the transfer of any especially large file to be distributed across days. Bottlenecks are prevented and as many assets are provisioned as can be provisioned. The permitted value is any whole number in the range from 10 to 1024000, where 1,024,000 MB is the same as 1 TB. The factory-default maximum size is 600 MB. Note Although it is technically feasible to enter a file size as great as 1024000 MB, playback fails for any file that is larger than 1.9 GB, regardless of the DMP model type. This size is constrained by the limits of streaming. |
||
The count of how many seconds must elapse before DMS-CD tries again to transfer a deployment package to a DMP on which the transfer failed or was interrupted. DMS-CD will never try to resume an interrupted or failed transfer until at least this many seconds have elapsed. When you edit this value, you change how quickly DMS-CD works around a failed or disrupted deployment. The permitted value is any whole number in the range from 5 to 10800, where 10800 is equal to 3 hours. The factory-default value is 300 seconds. |
||
Enables or disables the option to resume a DMS-CD file transfer that was interrupted. The factory-default behavior is to resume interrupted transfers. This behavior supports incremental transfer of large files through slow or unreliable networks over days. However, DMPs in this release do not have any ability to compare file modification time stamp values remotely. Our default behavior assumes that any static filename that persists at a static URI identifies a file that has never changed. So long as we retain a copy of the complete file as it existed while we transferred it, we will not check its URI again. This design does not consider that some assets might be dynamic, not static. You should deselect this check box and disable this feature when your assets are dynamic. After you disable this feature, DMS-CD will overwrite its copy of every asset whose file size has changed. |
Elements to Define a DMS-CD Deployment Package
Digital Media Players > Advanced Tasks
FAQs and Troubleshooting
Troubleshoot DMS-CD
Check Deployment Status Details
- The moment when you clicked Publish All to provision the described deployment package.
- When the described deployment succeeded.
- When the described deployment failed.
Step 1 Choose Digital Signage > Digital Media Players > Deployment Manager > Deployment Status.
Step 2 (Optional) Would you like to limit how many deployment packages the table describes? If so, use filtering options above the table.
Step 3 Examine the Status column for any use of the word “Failed.”
a. Whenever you see that a deployment package has failed, click its icon in the far right column.
b. Examine the Deployment Details popup window for any error message that might help you to troubleshoot the failure.
Figure 19-1 Deployment Details
For example, an error message in Figure 19-1 states that DMP login credentials were incorrect.
Step 4 Stop. You have completed this procedure.
Check Appliance System Logs for Deployment Errors
Step 1 Log in to AAI on your DMM appliance.
Step 2 Choose DMM_CONTROL > DMM_LOG_LEVEL > DEBUG, and ensure that the logs are verbose.
Step 3 Choose APPLIANCE_CONTROL > GET_SYSLOG,.
Step 4 Choose a method to receive the logfiles.
Step 5 Search through the DMS-CD.log and catalina.out logfiles for messages about:
Step 6 Stop. You have completed this procedure.
Use Snapshot Mode or Live Monitor Mode to Check for Deployment Errors
Step 1 Choose Administration > Alerts > Alert Reports.
Step 2 Do one of the following.
|
|
---|---|
|
Step 4 Stop. You have completed this procedure.
FAQs for ACNS
Q. Soon after I send copies of assets to my Content Engines, what prevents their playback on DMPs?
Your network topology and available bandwidth affect how long it takes for content replication to finish. Before your DMPs can play assets from a Content Engine, these assets must reach the Content Engine. Delay the playback of replicated assets from your content distribution network, until you know that ACNS replication is finished.
Tip Remember to click Publish on the Schedules page. Otherwise, playback cannot occur.
Q. How can I verify when content replication is finished in CDNFS?
You can telnet to a Content Engine to verify this. To learn how, see your Content Engine product documentation.
FAQs for WAAS
Q. In Cisco DMS 5.2.2, why would a DMP 4310G in WAAS mode stop playing a video after 1 or 2seconds?
A combination of factors might trigger this behavior. To recover from it one time, restart your DMP. Or, to prevent this from happening, turn failover Off, set the recovery failover timeout to 1 millisecond, and the number of retries to 1. ( CSCtj85446)
https:// :7777/set_param?ciscocraft.mv_failover_timeout=1&ciscocraft.mv_failover_retries=1&mib.save=1&mng.reboot=1
Troubleshoot ACNS
Troubleshoot Choppy Playback of Videos from Your ACNS Network
- Is the HTTP bit rate (bandwidth) setting too low on your Content Engine?
- Are too many DMPs using your Content Engine?
- Are HTTP requests from DMPs redirected correctly to your Content Engine?
- Is the HTTP proxy setting wrong in DMPDM to use a Content Engine as the proxy?
Note Ensure that your proxy server is powerful enough to handle its full load of HTTP sessions.
Troubleshoot Unlisted or Missing ACNS Channels in Digital Signs
- Do time setting differ between Digital Signs and your ACNS server?
- Did you enter the wrong CDM port number, username, or password in Digital Signs?
- Did you use a recycled or duplicate ACNS channel name?
|
|
When time settings are not synchronized between your DMM appliance and your ACNS server, the differences might cause Digital Signs to reject the digital certificate from your ACNS server. We recommend that you configure your ACNS server, your DMM appliance, and each of your Content Engines to synchronize their time settings to an NTP server. 10 Log in to Content Distribution Manager.
Log in to AAI on your DMM appliance. |
|
|
|
Be sure in Digital Signs to enter correct CDM values at Settings > ACNS Settings. These are the factory-default values for CDM. |
|
|
|
You cannot duplicate or recycle channel names. See "Why do I see an HTTP 500 error when I use ACNS?" |
10.Changing the time settings after you add content to the schedule might affect the availability of that content. |
Troubleshoot ACNS Assets That Your DMPs Do Not Play
- Is the ACNS channel origin server misconfigured?
- Is the ACNS channel quota misconfigured?
- Is the ACNS channel fully configured to use an external manifest file?
- Have you checked if any other content acquisition problems affect the external manifest file?
- Did anyone change the Time setting for your DMM appliance, but not restart it?