The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter provides information about the SIP Client app for Cisco IP cameras. This app lets an IP camera send audio to and receive audio from an external SIP client device, the Cisco Interoperability and Collaboration System (Cisco IPICS), or Cisco Unified Communications Manager (CUCM).
The SIP Client app enables an IP camera to transmit and receive audio to and from an external SIP client device, Cisco IPICS, or Cisco Unified Communications Manage. The IP camera plays audio that it receives on external speakers that are connected to it. The IP camera transmits audio through its internal or external microphone.
The SIP Client app provides these operating modes:
This mode supports one connection from a SIP device to the IP camera at a time. When a SIP client device disconnects from the IP camera, the camera is ready to establish another connection.
This mode supports simultaneous connections from multiple Cisco IPICS remote clients.
Before you can use the SIP Client app, you must configure it on each IP camera on which it will run. To configure this app, perform the following steps.
Install the SIP Client app on the IP camera on which it will run. See the “Related Documentation” section for more information.
Step 1 From the IP camera web-based user interface, click the Setup link, click Application Manager to expand the menu, then click App Setup .
Step 2 Click the SIPClient radio button, then click Configure .
The Cisco SIP Client App configuration page appears.
Step 3 Enter appropriate values in the Cisco SIP Client App configuration page fields as described in the following table:
Lets you enable logging, which causes the system to write app-related information to a log file. The log file is named SIPClient_verbose.log and is stored in the /var/log folder on the IP camera. When this file reaches 256 KB in size, it is archived to a file named SIPClient_verbose.log.1.gz in the /var/log folder and a new SIPClient_verbose.log file is created. When this new log file reaches 256 KB in size, it is archived to a file named SIPClient_verbose.log.2.gz and a new SIPClient_verbose.log file is created again. After that, each time the new SIPClient_verbose.log file reaches 256 KB in size, an archive file is created that overwrites the oldest existing archive file. In addition, the SIPlient_verbose.log is overwritten if the IP camera reboots and you restart the app.
|
||||
Enter a time interval in seconds at which the IP camera periodically contacts the SIP client to ensure that a live connection is in place. If the IP camera detects that the connection to the SIP client is lost, the camera tries three times to reestablish a connection. If the connection cannot be reestablished, the SIP Client app stops automatically. Valid values are 10 through 600 (10 seconds through 10 minutes). |
Enter a time interval in seconds at which the IP camera periodically contacts the UMS to ensure that a live connection is in place. If the IP camera detects that the connection to the UMS is lost, the camera tries three times to reestablish a connection. If the connection cannot be reestablished, the SIP Client app stops automatically. Valid values are 10 through 600 (10 seconds through 10 minutes). |
Enter a time interval in seconds at which the IP camera periodically contacts Cisco Unified Communications Manager to ensure that a live connection is in place. If the IP camera detects that the connection to Cisco Unified Communications Manager is lost, the camera tries three times to reestablish a connection. If the connection cannot be reestablished, the SIP Client app stops automatically. Valid values are 10 through 600 (10 seconds through 10 minutes). |
||
Enter the IP address of the UMS on which the channel to connect to is configured. |
Enter the IP address of the Cisco Unified Communications Manager server. |
|||
Enter the volume in decibels (dB) at which the IP camera plays on its external speakers audio that it receives from a remote SIP device, Cisco Unified Communications Manager, or Cisco IPICS. |
||||
Enter the number of the active channel to which to connect, preceded by 1 . For example, if the channel number is 469, enter 1469 .
To determine the channel number, go to
http://
ip_address |
||||
Enter the camera username that the camera uses to register with Cisco Unified Communications Manager. This value is the User ID that you configure in Cisco Unified Communications Manager as described in the “Adding and Associating an End User” section . |
||||
Enter the camera password that the camera uses to register with Cisco Unified Communications Manager. This value is the password that you configure in Cisco Unified Communications Manager as described in the “Adding and Associating an End User” section . |
Step 4 Click the Save button in the Cisco SIP Client App configuration page, and then click OK in the confirmation dialog box.
If you want to reset the options in the Cisco SIP Client App configuration page to their default values, click the Reset button, click OK in the two dialog boxes that appear, click the Save button, and then click OK in the confirmation dialog box.
If you change configuration values while the SIP Client app is running, you must stop and then restart the app before the changes take effect.
This section provides general steps for configuring Cisco IPICS for use with the SIP Client app. Ensure that Cisco IPICS is properly configured if you use the SIP Client app in UMS mode.
Cisco IPICS is configured through the Cisco IPICS Administration Console. For detailed information about configuring Cisco IPICS, see Cisco IPICS Server Administration Guide .
1. Make sure that a location is configured for the UMS that you are using.
2. Make sure that the UMS that you are using is properly configured to operate with Cisco IPCIS.
3. Add a tone controlled radio, which represents an IP camera, and configure this radio.
4. Associate users to the radio that you added.
5. Enable the radio that you added.
6. Add a channel for the radio that you added.
7. Add associations for Cisco IPICS users whom you want to allow to communicate on the channel that you added.
8. Enable the channel that you added.
9. Create a virtual talk group (VTG), and add the radio, channel, and users that you added.
You configure Cisco Unified Communications Manager for use with the SIP Client app by using the Cisco Unified Communications Manager Administration Console. For more detailed configuration information, see your Cisco Unified Communications Manager documentation.
This configuration involves the procedures that the following sections describe:
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 Client app.
To add a camera to Cisco Unified Communications Manager, follow these steps from the Cisco Unified Communications Manager Administration Console:
Step 1 Log in to the Cisco Unified Communications Manager Administration Console.
The Add a New Phone page appears
Step 3 Click Add New near the top left side of the page.
The Add a New Phone page appears.
Step 4 From the Phone Type drop-down list, choose Third-party SIP device (Advanced).
The Phone Configuration page appears.
Step 6 In the Device Information area, take these actions:
a. In the MAC Address field, enter the MAC address of the IP camera.
b. From the Device Pool drop-down list, choose Default.
c. From the Phone Button Template drop-down list, choose Third-party SIP Device (Advanced).
Step 7 In the Protocol Specific Information area, take these actions:
a. From the Device Security Profile drop-down list, choose Third-party SIP Device Advanced.
b. From the SIP Profile drop-down list, choose Standard SIP Profile.
c. Check the Media Transmission Point Required check box.
Step 8 Click Save near the bottom of the Phone Configuration page to save and load the new phone configuration, and then click OK in the dialog box that appears.
Step 9 Click Line[1]-Add a new DN in the Association Information area on left side of the window.
The Directory Number Configuration page appears.
Step 10 In the Directory Number field near the top of the page, enter a valid four-digit directory number that is within your dial plan.
Step 11 (Optional) In the Description field, enter a description of the camera.
Step 12 (Optional) In the Alerting Name field, enter the name of the camera that appears on telephones when the camera is called.
Step 13 Click Save near the bottom of the Directory Number Configuration page to associate the directory number with the device that you added.
Step 14 Click Apply Config near the top of the screen.
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.
To add an end user in Cisco Unified Communications Manager, follow these steps from the Cisco Unified Communications Manager Administration Console:
Step 1 Choose User Managemen t > End User.
The Find and List Users page appears
Step 2 Click Add New near the top left side of the page.
The End User Configuration page appears.
Step 3 In the User ID field, enter an identifier for the user.
Step 4 In the Password field, enter a password that the IP camera uses to register with Cisco Unified Communications Manager.
Step 5 In the Confirm Password field, reenter the password that you entered in the Password field.
Step 6 In the Last name field, enter a name to identify the user.
For example, enter IP camera .
Step 7 Click Save near the bottom of the End User Configuration page.
Step 8 Associate the device added with the end user by selecting a device from the Device association tab in the Device Information block.
Step 9 In the Device Information area in the End User Configuration page, click Device Association .
Step 10 Locate one or more devices that you added as described in the “Adding a Camera to Cisco Unified Communications Manager” section, click the check box that corresponds to that device, and then click Save Selected Changes at the bottom of the page.
You can repeat this step as needed.
When you run the SIP Client app, the IP camera does the following:
To run the SIP Client on an IP camera, follow these steps:
Step 1 Take these actions to enable audio on the IP camera, if it is not enabled already:
a. From the IP camera web-based user interface, click the Setup link, click Application Manager to expand the menu, then click Configuration .
b. Check the Enable Audio check box in the Audio area.
Step 2 From the IP camera web-based user interface, click the Setup link, click Application Manager to expand the menu, then click App Setup .
Step 3 Click the SIPClient radio button.
Step 4 (Optional) If you want the SIP Client app to run automatically each time the IP camera reboots, in the Installed Application List area, check the Start on Boot check box that corresponds to this app.
If you do not check this check box, you must run the app manually each time the IP camera reboots.
When you stop the SIP Client app, the IP camera does the following:
To stop the SIP Client app on an IP camera, follow these steps:
Step 1 From the IP camera web-based user interface, click the Setup link, click Application Manager to expand the menu, then click App Setup .
Step 2 Click the SIPClient radio button.