This document describes the SIP Video app which enables an IP camera to transmit and receive Video to and from an external SIP client device like Cisco Unified Communications Manage.
Cisco Recommends that you have knowledge of these topics:
VSM 7.6 and later, camera app SIPVideo_SX_V4.4.cpk, Camera Models 6620, 6630, 3620, 3630, 6500PD, 7530PD, CUCM & IP Phone.
Hardware connection on camera to connect external mic and external speakers.
CUCM, IP Phone
The information in this document is based on VSM 7.8 with latest camera firmware 2.8 version
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any procedure.
Procedure to Install the Camera App
Step 1: Login to VSOM.
Step 2: Navigate to System Setting > Camera App.
Step 3. Click inAdd.
Step 4. Browse the SIPVideo App from local PC (Eg. SIPVideo_SX_V4.4.cpk)
Camera Apps are available on cisco.com. Click on this link, select the required Camera model and Select Software Type IP Camera Application and Utilities. Download the required App.
Step 3. Select SIPVideo and click in Configure, as shown in the image:
Step 4. Enter appropriate values in the SIPVideo App Configuration page, as shown in the image:
Note: In the above configuration, SIPVideo App is used to stream audio from camera on IP Phone or vice -versa.
App mode – CUCM
SIP Server – CUCM IP address
User Name – End Username and Password from CUCM, created below under Step 15.
Step 5. Login to CUCM.
Note: Adding a camera to Cisco Unified Communications Manager enables that application to support the camera. When you add a camera, you add the device as a phone. You must add each camera that will run the SIP Video app.
Step 6. Navigate to Device > Phone, Add New
Step 7. From Phone Type, select Third-Part SIP Device (Advanced).
Step 8. Device Information area, enter the MAC address of the IP camera.
Step 9. Select Default for Device Pool, Phone Button Template select Third-party SIP Device (Advanced)
Step 10. In the Common Phone Profile, select Standard Common Phone profile
Step 11. In the Protocol Specific Information, Device Security Profile select Third-party SIP Device Advanced.
Step 12. Check the Media Transmission Point Required.
Step 13. Rest all Default settings.
Step 14. Adding End User.
Note: Adding end user to Cisco Unified Communications Manager and associating and end user with a camera allows cameras that run the SIP Client app to register with Cisco Unified Communications Manager. Cisco recommends that you create one end user and associate that end user with each camera.
Step 15. Select User Management à End User and Add New.
Add User ID and Password (this User data should be used on the Camera App)
Step 16. Add User ID, Password, Last Name
Step 17. In the Device Information, click in Device Association. Select the Camera MAC & Save Selected/Changes, then MAC address should be viewable on controlled Devices.
Step 18. Click in Save.
Step 19. Navigate to Device à Phone > Camera MAC address.
Step 20. In the Device Information, select Owner and click User.
Step 21. In the Device Information, click Owner User ID, Select USER ID (created from Step 15)
Step 22. Save & Apply Config. (Reset the config, if required)
Step 23. Reboot camera to initialize the Camera App again to initiate SIP to CUCM.
Step 24. Dial 6005 from IP Phone, Audio / Video Streaming will begin from Camera to SIP End device (IP Phone)
How to Export Logs from Camera
Step 1. Login to Camera web gui.
Step 2. Navigate to Setup à Administration à Maintenance à Camera logs. Click Export logs.
Download to local PC
Logs to refer while Camera APPS Troubleshoot
SIPVideo.log – This log shows the SIPVideo Configuration file status and latest config file update status. It also helps in reviewing SIPDeamon status of a camera.
Alerts.log – This logs all the events on the camera, it is useful to debug the past issue which is in the reference to events in the logs.
Appmgr.log – This log has all the app related entries and also app status logs
Appmgrtrace.log – This logs info about how the apps are managed & license info.
SIPVideo_verbose.log – When Camera App is enabled with Debug lets you enable logging, which causes the system to write app-related information to a log file. The log file is named SIPVideo_verbose.log and is stored in the /var/log folder on the IP camera this log gives a complete transaction detail of Camera App, Communication between CUCM to a Camera app.
Troubleshoot Steps and Commands from Camera CLI
Camera APP config file is available on /usr/apps/appmgr/appMgrConfig.xml. This configuration file helps you to understand what are the apps managed by a camera and which VSOM is managing these APPS.
SIPClient can be stopped and started using these commands: /usr/apps/SIPVideo/stop.sh /usr/apps/SIPVideo/start.sh
/usr/apps/SIPVideo/html/configparams.xml this files holds the running config of the camera app choose to run.
/usr/apps/SIPVideo/config.info this files holds the apps version Ex.. SIPVideo 1.0, SIPVideo 2.8