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 describes the configuration tasks that you need to perform after installing the Cisco Smart+Connected Meeting Spaces (Smart+Connected MS) application.
•Assigning Roles (Groups) to the Application User
•Configuring Audio Notification to IP Phone
•Integrating CUCM and InformaCast
•Changing the User Portal Theme
The Cisco Unified Communications Manager (CUCM) administrator must configure the service URL in CUCM to make the service appear on the IP phone.
To configure the services in CUCM, perform the following steps:
Step 1 In the browser, type the CUCM URL.
Step 2 Click Cisco Unified Communications Manager.
The Cisco Unified CM Administration home page appears.
Step 3 Enter the CUCM administrator's username and password, and click Login.
Step 4 Click Device > Device Settings > Phone Services.
Step 5 Click Add New.
To add a new service, perform the following steps:
a. Enter the service name in the Service Name field. For example, S+CC service.
b. Enter the service description in the Service Description field.
c. Enter the service URL in the format given below:
http: //<host IP address>:<port>/solutions/ip-phone-comm.ip
For example,
http: //10.106.13.76:7001/solutions/ip-phone-comm.ip
d. From the Service Category drop-down list, choose XML Service.
e. From the Service Type drop-down list, choose Standard IP Phone Service.
f. Select the Enable check box.
Step 6 Click Save.
Step 7 Click Device > Phone.
The Find and List Phones page appears.
Step 8 From the "Find Phone where" drop-down list, choose Device Name.
Step 9 From the drop-down list that is adjacent to the "Find Phone where" drop-down list, choose contains.
Step 10 Enter the MAC address of the IP phone for which you want to subscribe the service.
Step 11 Click Find, and select the IP phone.
The Phone Configuration page appears.
Note Ensure that the Web Access drop-down list displays an enabled value.
Step 12 From the Related Links drop-down list, choose Subscribe/Unsubscribe Services, and click Go.
Step 13 Select the service name that you have provided in Step 5 a.
Step 14 Click Next.
Step 15 Click Subscribe.
Step 16 Click Reset in the Phone Configuration page.
A device reset dialog box appears.
Step 17 Click Reset.
The configured service name appears under Services in the IP Phone.
The Smart+Connected MS application requires an application user to be created in CUCM for pushing the audio broadcast and text messages to the Cisco IP phone.
The application user needs the following privileges minimally to allow the Smart+Connected MS application to work properly:
•Standard CTI Enabled—This user group, which is required for all CTI applications, allows an application to connect to Cisco CallManager to access CTI functionality.
•Standard CTI Allow Control of All Devices—This user group allows an application to control or monitor any CTI-controllable device in the system.
•Standard CCM Admin Users—This grants log-in rights to Cisco Unified Communications Manager Administration. A user with only the Standard CCM Admin Users role can access Cisco Unified Communications Manager Administration but cannot make any changes.
•Standard CCMADMIN Read only— This allows an administrator to view the configuration information in Cisco Unified Communications Manager Administration page.
•Copy of Standard CCM Phone Administration which includes Service URL Page, User Web Page and Phone Services Subscribe.
•Copy of Standard Serviceability named as roles for Web Services which has only SOAP related services as read and write access.
To create and assign a role to an application user, perform the following steps:
Step 1 In the browser, enter the URL to access the Call Manager application.
Step 2 Click Cisco Unified Communications Manager.
The Cisco Unified CM Administration home page appears.
Step 3 Enter the username and password and click Login.
Step 4 Click User Management > Application User to create application users and assign roles to the application users that provide them the above mentioned privileges.
The CUCM administrator needs to configure the audio notification feature to allow the Emergency Notification (EN) messages to be pushed to the IP phone.
To configure audio notification to IP phone, perform the following steps:
Step 1 Create an application user in Call Manager so that the solution can push the Emergency Notification (EN) content to IP Phone.
To create an application user in the Call Manager, perform the following steps:
a. In a browser, type the CUCM URL.
b. Click Cisco Unified Communications Manager.
The Cisco Unified CM Administration home page appears.
c. Enter the CUCM administrator's username and password for the Call Manager, and click Login.
d. Navigate to User Management > Application User.
e. Click Add New.
The Application User Configuration page appears.
f. Enter the user ID in User ID field.
g. Enter the password in the Password field.
h. Enter the confirmed password in the Confirm Password field.
i. From the Presence Group drop-down list, choose Standard Presence group.
j. In Device Information, move the desired devices from Available Devices to Controlled Devices.
k. Move the desired Available Profiles to CTI Controlled Device Profiles.
l. Under Permissions Information, click Add to User Group.
m. Select Standard CTI Enabled user group, and click Add Selected.
n. Click Save.
The roles and permission for the new user appear.
Step 2 For pushing audio to IP phone as part of EN, you have to make a change in the server on which the Smart+Connected MS & DS application is deployed. Change the /etc/hosts file by moving the assigned IP address of the machine before the local loopback address.
For example,
10.78.10.143 SCC-BGL04-DV-123
127.0.0.1 SCC-BGL04-DV-123 localhost.localdomain localhost
::1 localhost6.localdomain6 localhost6
Note The IP phones, application server, and CUCM must be on a multicast network. To verify if the application server is multi-cast run /sbin/ifconfig in the application server. The MULTICAST keyword appears in the output.
A location is a physical space that helps you define a spacial structure in a city, organization, complex, industry, and so on. For example, the various locations for an organization can be country, city, building, campus, wing, floor, room, and so on.
You can add multiple locations to the SDP application and create a location hierarchy for a city, an enterprise and so on. You can create location hierarchies beginning with the default root location that is defined during installation of the SDP application. You can also modify the name of the default root location, if required.
To add a new location to the location hierarchy, perform the following steps:
Step 1 Log in to the SDP application.
Step 2 Click the Locations tab.
The Locations page appears. The left pane displays the location hierarchy, and the right pane displays the main content area.
Step 3 Select a location for which you want to add the child location in one of the following ways:
a. Searching for a location:
1. Click in the shortcut tools.
2. In the Search field, enter a location keyword, and click .
The Search Results page appears with the location details.You can select the location for which you want to add the child location.
b. Expanding location hierarchy:
1. Click before a parent location.
If the is not displayed before a parent location, the location does not have any child location.
2. Click a location for which you want to add the child location.
Alternatively, click (Expand Immediate Child Nodes of Selection tool), and click a location for which you want to add the child location.
The following details are displayed for the selected location in the Location Details area:
•Location Type— Type of location under which the selected location has been categorized.
•Location Name—Name of the selected location.
•Parent Location—Parent of the selected location.
•Any custom property that has been setup for the location type.
Step 4 In the main content area, click .
The Add Location page appears. The Parent Location field displays the selected parent location for which you want to add the child location.
Step 5 Enter the following details:
•Location Type—From the Location Type drop-down list, choose the type of the location under which the selected location has to be categorized.
•Location Name— Enter the name of the location. The location name can be alpha-numeric, and you can use a maximum of 500 characters.
For certain location types, additional properties should be added.
Step 6 Click Save to save the location details.
The newly added location is displayed in the location hierarchy.
After adding a location to the location hierarchy, you can modify the location name and location properties.
To modify the existing location details, perform the following steps:
Step 1 On the Locations page, select a location for which you want to modify the location details in one of the following ways:
The following details are displayed for the selected location in the Location Details area:
•Location Type—Type of location under which the selected location has been categorized.
•Location Name—Name of the selected location.
•Parent Location—Parent of the selected location.
For more information on how to select a location, perform Step 1 through Step 3 in Adding Locations.
Step 2 In the right pane, click .
The Edit Location page appears. The Parent Location field displays the selected parent location. The Location Type drop-down list displays the type of the selected location.
Step 3 Modify the following fields as necessary:
•Location Name—Name of the selected location. The location name can be alpha-numeric, and you can use a maximum of 500 characters.
•Edit Location Properties—Property definitions that you defined for the location type during installation of the SDP application.
Step 4 Click Save to save the location details.
The modified details are updated and displayed in the location hierarchy.
To delete a location, perform the following steps:
Step 1 On the Locations page, select a location that you want to delete.
The following details are displayed for the selected location in the Location Details area:
•Location Type—Type of location under which the selected location has been categorized.
•Location Name—Name of the selected location.
•Parent Location—Parent of the selected location.
For more information on how to select a location, perform Step 1 through Step 3 in Adding Locations.
Step 2 In the right pane, click .
After a location is deleted, all the child locations, defined property definitions, and the role and device associations for the location are automatically removed from the SDP application.
You need to configure devices to avail the building system services for the location, such as, light settings, blinds, dimmer, and audio video controller through the Smart+Connected MS application. You need to use the SDP interface to access the Devices module.
The devices type definitions, such as, lights, blinds, dimmer, and audio video controller are available as part of SDP seed data that is added when SQL scripts are executed.
•Setting up Crestron Controller for the Projector
The following devices are supported by the Smart+Connected MS application:
•IP Phones
•Blinds
•Light
•Audio Video Controller
•Dimmer
•Light Occupancy Sensor
•ThermoFuser
•VRV
•VAV
•Energy Meter
•Gas Meter
•Water Meter
•Digital Media Player (DMP)
•Cisco Interactive Experience Client (IEC)
You can add any of these devices to the selected location in the location hierarchy if they are available at the location.
To add devices to the SDP application, perform the following steps:
Step 1 Log in to the SDP application.
For more information on how to log in to the SDP application, see the Cisco Service Delivery Platform User Guide.
Step 2 Click the Devices tab.
The Devices page appears. The left pane displays the location hierarchy, and the right pane displays the List of Devices area.
Step 3 Select a location for which you want to add the child location in one of the following ways:
a. Searching for a location:
3. Click in the shortcut tools.
4. In the Search field, enter a location keyword, and click .
The Search Results page appears with the location details. You can select the location for which you want to add the child location.
b. Expanding the location hierarchy:
1. Click next to a parent location.
If the is not displayed next to a parent location, the location does not have any child location.
2. Click a location for which you want to add the child location.
Step 4 In the right pane, click Add a Device.
The Add Device page appears. The Parent Location field displays the selected parent location with which you want to associate the device.
Step 5 Enter the following details:
•Device Category—Category under which you want to organize the device.
•Manufacturer—Manufacturer name of the device.
•Model—Model details of the device.
•Device Name—Name of the device.
Step 6 Click Save.
The newly added device is associated to the selected location.
To delete an device from the SDP application, perform the following steps:
Step 1 In the Devices page, select a location for which you want to modify the device details.
For more information on how to select a location, perform Step 3 in the "Adding Devices" section.
All devices that have been associated with the selected location are displayed.
Step 2 Do one of the following:
•To delete a single device, choose a device that you want to delete, and click .
•To delete multiple devices, select the specific check boxes of the devices that you want to delete, and click Delete.
The device is removed from the SDP application.
To set up Crestron Controller for the projector, you must have Windows 2008 R2 server machine or Windows 7 that has IIS 7.5 with .NET Framework 3.5 or above.
To set up the Crestron Controller, perform the following steps:
Step 1 From the Linux machine, copy the Crestron Controller ZIP file located in <MS_HOME>/pkg-properties/crestron to a Windows machine
Step 2 Unzip the crestroncontroller.zip files using any archive utility.
Step 3 Run the inetmgr command. The IIS manager server console appears.
Step 4 Right-click the default web site and choose create a new virtual directory.
Step 5 Enter the alias as crestron. In the physical path, choose the Crestron Controller folder that is unzipped.
Step 6 Right-click the crestron folder under Default Web Site, choose Convert to Application, and click OK.
The application is created.
Step 7 Enter the URL in a browser in the following format:
http: //localhost/crestron/Home.aspx?deviceIp=<deviceIP of the Crestron Controller> &ipId=<ipID of the Crestron controller>&port=<port of the Crestron Controller>&slot=<slot of the Crestron Controller>&type=digital&join=<join value of the Crestron Controller>
•deviceIP—The IP ID of the Crestron Controller.
•port—Port of the Crestron Controller.
•slot—Slot of the Crestron Controller.
•join—Value depends on the action performed on the Crestron Controller.
For example:
http: //localhost/crestron/Home.aspx?deviceIp=65.100.54.20&ipId=1&port=41794&slot=1&signal Type=digital&join=62
A message appears indicating that the Crestron Controller is successfully set up.
•Configuring Adapter Properties
•Configuring Adapters to a Location
Table 3-3 lists the adapters you must configure and the purpose these adapters serve for the functioning of the Smart+Connected MS application.
Note You must configure either the IPPhoneOperationBean or the InformaCastBean adapter depending on whether you want to use Cisco JTAPI or Singlewire InformaCast for sending emergency notifications.
You need to configure adapter properties for the available adapters. Adapter configuration needs to be performed in the database by inserting data into the SDP_ADAPTER_PROPERTIES table.
Table 3-4 provides information on the properties of the adapters, which can be used to come up with the SQL scripts that are then to be run against the database.
|
|
|
|
---|---|---|---|
com.cisco.cre.ssp.adapter.obix.ObixBean |
username |
The Obix username |
admin |
password |
The Obix password |
pAsswOrd |
|
url |
The Obix URL |
http : // 10.76.99.4/obix |
|
obixUrl |
The Obix URL |
http :// 10.76.99.4/obix |
|
com.cisco.cre.ssp.adapter.audiovideo.AudioVideoBean |
appPath |
The path of the crestron application. |
/crestron/Home.aspx |
hostname |
The IP address of the host on which the Smart+Connected MS & DS Crestron .NET component is setup on IIS. |
10.106.12.13 |
|
portNumber |
The IIS port of the host on which the Smart+Connected MS & DS Crestron .NET component is setup. |
80 |
|
com.cisco.cre.ssp.adapter.exch.bean.ExchangeBean |
exch_udpserverip |
The MS application server IP address/ DNS hostname |
10.106.13.15 |
exch_filepath |
The path of the file in Exchange Server. |
/apps/exchange-xml/ |
|
exch_defaulttimezone |
The timezone of the Exchange Server. |
Asia/Shanghai |
|
exch_domain |
The domain name of the Exchange Server. |
EXCH2K10 |
|
exch_host |
The IP address/DNS hostname Exchange Server. |
10.106.13.143 |
|
mail.smtp.host |
This property is not used currently. |
- |
|
exch_url |
Exchange URL |
https: // 10.106.13.143/ews/exchange.asmx |
|
exch_username |
The Exchange server username. |
scc-qa |
|
exch_password |
The Exchange server password. |
Cisco_123 |
|
mail.smtp.port |
This property is not used currently. |
- |
|
exch_udpserverport |
The MS Application server listen port. |
7001 |
|
com.cisco.cre.ssp.adapter.remedy.RemedyBean |
password |
The Remedy user's password |
WPRcreIT4 |
userName |
The Remedy user's username. |
RA_WPRIT.gen |
|
scheme |
The protocol to invoke the remedy HTTP/HTTPS. |
http |
|
appPath |
The path of the remedy application. |
/arsys/servlet/RemedyIncidentWrapper |
|
remedyurl |
The Remedy server URL. |
http: // alli-stg-01.cisco.com/arsys/servlet/RemedyIncidentWrapper |
|
hostName |
The Remedy server IP Address/DNS hostname. |
alli-stg-01.cisco.com |
|
portNumber |
The Remedy Server port. |
80 |
|
com.cisco.cre.ssp.adapter.email.bean.EmailBean |
toAddress |
The address to which the e-mail needs to be sent for the case management. This is usually the facilities team helpdesk mail alias. |
support @ cisco.com |
fromAddress |
The address from which the e-mail needs to be sent for the case management. Usually, this mailbox is set up as a no-reply mailbox. |
noreply-sdp @ cisco.com |
|
mail.smtp.port |
The SMTP Server Port. |
25 |
|
mail.smtp.host |
The IP Address/ hostname of the SMTP server. |
mailman.cisco.com |
|
com.cisco.cre.ssp.adapter.ipphone.bean.IPPhoneOperationBean |
password |
The application user's password created in CUCM. For more information on the application password, see the "Assigning Roles (Groups) to the Application User" section. |
ccmadmin |
username |
The application username created in CUCM. For more information on the application username, see the "Assigning Roles (Groups) to the Application User" section. |
Cisco @ 123 |
|
serviceuri |
The uri of the call manager configured. |
https: //10.106.6.111/realtimeservice/services/RisPort70 |
|
appusername |
The application username created in CUCM. For more information on the application username, see the "Assigning Roles (Groups) to the Application User" section. |
cisco |
|
apppassword |
The application user's password created in CUCM. For more information on the application password, see the "Assigning Roles (Groups) to the Application User" section. |
cisco |
|
com.cisco.cre.ssp.adapter.dmm.DMMBean |
dmm_url |
The DMM URL. |
https: //scc-qa-dmm-1.cisco.com:8443 |
dmm_username |
The DMM username. |
superuser |
|
dmm_domain |
The domain of DMM. |
scc-qa-dmm-1.cisco.com |
|
dmm_password |
The DMM password. |
Cisco_123 |
|
com.cisco.cre.ssp.adapter.ipphone.bean.InformaCastBean |
uri |
Infomacast URL |
https: //10.106.15.161:8444/InformaCast/services/MessageServiceV2?wsdl |
username |
Infomacast username |
admin |
|
password |
Infomacast password |
admin |
The adapters are configured to the specific location by mapping an adapter instance ID with the corresponding location in the SDP_ADAPTER_LOCATION_LINK table. When an adapter instance is associated to a location, the adapter instances are automatically applied to all the child locations for that location.
For a sample configuration for the ObixBean mapped to the location ID 10011, see the "Sample Adapter Configurations" section.
SDP_ADAPTER_DEFN table
This configuration is part of the seed data.
SDP_ADAPTER_INSTANCE
SDP_ADAPTER_LOCATION _LINK table
This table allows you to link the adapter instances with one or more locations. When an adapter is associated to a location, the adapter instances are automatically applied to all the child locations for that location.
For more information on how to configure adapters, see the Cisco Service Delivery Platform Installation Guide.
If you change the values in these tables, you must restart the application to enable the changes.
Note The IPPhoneOperationBean and the InformaCastBean adapters cannot point to the same location or the child location of either of these adapters in the sdp_adapter_location_link table.
InformaCast is an emergency notification solution by Singlewire, that can broadcast audio stream, text messages, and notifications to multiple Cisco IP phones simultaneously as a group. InformaCast can broadcast either a live, recorded, or a scheduled message on your IP network with a single click from your computer or through API calls.
To use InformaCast in a telephony environment, you have to integrate Cisco Unified Communications Manager (CUCM) and InformaCast. Also ensure that you:
•Integrate Cisco Unified Communications Manager (CUCM) and InformaCast.
•Set up a multicast network as the InformaCast broadcast works on multicast network.
Note You must verify that the InformaCast version and the CUCM version are compatible before you begin to integrate them.
For more information on how to configure and integrate the Cisco Unified Communications Manager (CUCM) and InformaCast, refer to the InformaCast help documentation and Singlewire online knowledge base.
You can change the skin of the Smart+Connected MS user interface, so that the users can view the changed skin instead of the default skin. To activate a skin, you need to update the value of the key "skin_name" in the aplication.properties file. For example, skin_name=red
Note The value should be a valid skin folder name. It is necessary that you restart the application to enable the changes.