How to Install, Configure and Troubleshoot – SIP Video Camera App’s

Introduction

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.

Prerequisites

Requirement

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

Components Used

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 in Add.

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.

( https://software.cisco.com/download/navigator.html?mdfid=282090226&flowid=50644 )

Now, Camera Apps needs to be enabled on the Camera Template to be managed by VSOM

Step 5. Navigate to Cameras > Template > Camera Template, as shown in the image:

Step 6. Select SIPVideo App.

Step 7. Click Save.

Step 8. Navigate to System Setting > Camera App, select the SIPVideo App and click in Install.

Step 9. Check the Camera app not installed to list the camera which does not have SIPVideo APP.

Step 10. Now select the Model of the camera on which APPS needs to be installed (multiple cameras can be selected) and click in OK., as shown in the image:

Now VSOM pushes the configuration and App data to the camera. Apps are installed on the camera depending on the camera compatibility and firmware version.

This completes the Installation of Camera Apps on Camera.

Configure Cisco CUCM for Use with the SIP Video App

Procedure to Configure the Camera App

Step 1. Login to Camera Web Gui.

Step 2. Navigate to Setup > Application Manager > App Setup.

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)

Troubleshoot

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