Cisco Smart PHY v1.0 User Guide

Transcription

1 First Published: Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA Tel: NETS (6387) Fax:

2 2017 Cisco Systems, Inc. All rights reserved.

3 CONTENTS CHAPTER 1 Information about Cisco Smart PHY 1 Benefits of Cisco Smart PHY 2 Dashboard 3 Inventory 4 Cable RPD Automation 8 Admin 13 CHAPTER 2 How to Install Cisco Smart PHY 15 Installation Overview 15 How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server 16 How to Deploy Cisco Smart PHY OVF Template through ESXi Host 21 How to Install VMware Tools 26 How to Install the Cisco Smart PHY 26 How to Install the Mobile Application 28 How to Upgrade the Cisco Smart PHY 28 How to Uninstall the Cisco Smart PHY 29 CHAPTER 3 How to Use Cisco Smart PHY 31 How to Log In using a Browser 31 How to Bring Up the RPD 33 How to Add an RPD using Mobile Application 38 How to Create a New Credential Profile 39 How to Apply Device Credential from Credential Profiles 39 How to Apply a Different Credential Profile to Existing Devices 40 How to Apply Different Credential Profile in Bulk 40 How to Delete a Device from the Inventory 41 How to Create CSV File for Importing Devices 41 How to Export Device Information to a CSV File 42 iii

4 Contents How to Add Devices through GUI 42 How to Import Device Information in Bulk 43 How to Delete a Credential Profile 43 How to Create a New Service Definition 45 How to Specify RPD Assignment 45 CHAPTER 4 How to Troubleshoot Cisco Smart PHY 47 How to Troubleshoot Cisco Smart PHY 47 iv

5 CHAPTER 1 Information about Cisco Smart PHY The Cisco Smart PHY application is an integrated package for installing, configuring, monitoring and troubleshooting the Cisco Remote-PHY devices (RPD) connected to the Cisco CMTS. It is a micro-services platform for customers and partners to collaborate and build an application ecosystem around on-box innovation. It enables multiple use cases, including: Traffic engineering Network change automation Real-time key performance indicator (KPI) monitoring Predictive maintenance and impact analysis Security These are some general instructions and information for using the Cisco Smart PHY: Icon Description Information button. Click this button to display more information. Context Menu button. Move the mouse over this button to display a context menu. Benefits of Cisco Smart PHY, page 2 Dashboard, page 3 Inventory, page 4 Cable RPD Automation, page 8 Admin, page 13 1

6 Benefits of Cisco Smart PHY Information about Cisco Smart PHY Benefits of Cisco Smart PHY Typically, 200 to 500 RPDs might be connected to a single Cisco CMTS and manual configuration and monitoring could pose a problem. Following are some of the benefits of using the Cisco Smart PHY application: Initial RPD Zero-Touch Automation: Initial RPD installation and provisioning with Zero-touch of the Cisco CMTS. RPD Inventory: RPD inventory operations. For example, running inventory reports or searching for RPDs based on specific criteria and so on. RPD SW Management: RPD SW version management. 2

7 Information about Cisco Smart PHY Dashboard Dashboard 3

8 Inventory Information about Cisco Smart PHY Following are the field descriptions: Callout # Name Dashboard Topology Installed Nodes Cable Launch Description Snapshot view of all devices managed and monitored by the Cisco Smart PHY application. Geographical view of registered inventory. Shows the number of nodes installed using the Cisco Smart PHY application. This panel also shows the number of Credential Profiles available in the application. The pie chart shows the reachable and unknown nodes. Shows the number of RPDs, Service Templates, CCAP Cores, and Associations configured and managed using the Cable RPD Automation page. Click on a number to view more details. Click on Launch to go to the Cable RPD Automation page. Takes you to the specific page view. Inventory Inventory has two tabs; Inventory and Credential Profiles. 4

9 Information about Cisco Smart PHY Inventory Inventory The Inventory tab enables you to add, organize, and update information about the network devices. This includes non-cable devices too and hence the information to be provided is more exhaustive than in the Cable RPD Automation view. Note You must add the RPDs through the Cable Pairing table in Cisco cbr and not through the Inventory tab in the Cisco Smart PHY application. Following are the field descriptions for Inventory: 5

10 Inventory Information about Cisco Smart PHY Name Status Description Shows a graphical pie chart of all devices in the network, categorized by status: Managed Known and managed by Cisco Smart PHY. Unmanaged Known, but not managed. Unrecognized Cisco Smart PHY cannot determine if the device status is Managed or Unmanaged. Type Manufacturer Shows a graphical chart of all devices in the network, categorized by type (SNMP, Telnet/SSH, HTTP, and TL1). Shows a graphical chart of all devices in the network, categorized by vendor (Cisco and third party). The charts let you see, at a glance, the distribution of devices in the network. Adds a device to existing inventory. Edits device information. Deletes a device from the inventory. Exports device information to a CSV file. Imports devices by using a CSV file. Search Devices table Allows you to search for and filter the network devices. Shows detailed information about each device in the network. Credential Profiles 6

11 Information about Cisco Smart PHY Inventory Credential profiles are collections of device credentials for SNMP, Telnet/SSH, HTTP, and TL1 network devices. Using credential profiles lets you apply credential settings consistently across devices. When you add or import devices, you specify the credential profile the devices use. If you need to make a credential change, such as changing a device password, you can edit the profile to update the settings across all devices that use that profile. Figure 1: Credential Profiles Following are the field descriptions for Credential Profiles: 7

12 Cable RPD Automation Information about Cisco Smart PHY Name + Create New rpd_default Save/Delete/Cancel Description Allows you to add or edit a credential profile. Note: Mandatory fields are marked with an asterisks. This credential profile is the default RPD profile generated by the system. When a user deletes this profile and new one is generated automatically by the system immediately. Any new RPD added to the inventory is associated with the rpd_default profile. Use these buttons to complete your action. Cable RPD Automation The Cable RPD Automation page enables you to add, organize, and update information about CMTS and RPD devices in the network. The information to be provided in this view is less compared to that in the Inventory Manager view because this view is specific to Cable devices. The Cable RPD Automation page has three tabs; Overview, RPD Assignment and Service Definitions. Overview Provides a view of the number of RPDs, their status, and the number of Cores. Also, it provides a dashboard view of the Core and the RPDs in different status. 8

13 Information about Cisco Smart PHY Cable RPD Automation RPD Assignment Allows you to add, edit, import, or export RPDs associated with a specific service template. Search allows you to search for or filter the associated RPDs. 9

14 Cable RPD Automation Information about Cisco Smart PHY Following are the fields descriptions: Name CCAP Core Core Interface Video Interface Broadcast Video Interface Data Service Group Video Service Group Additional Cores Service Template Description The CBR8 to which the RPD should connect to Complete name of the TenGigabitEthernet DPIC Interface to be used for Data Service Complete name of the TenGigabitEthernet DPIC Interface to be used for Video (Narrowcast) Service Complete name of the TenGigabitEthernet DPIC Interface to be used for Broadcast Video Service. Cannot be same as the Video Interface. All RPDs with the same data service group will share the Downstream controller for Data Service (Virtual Splitting for Data) All RPDs with the same video service group will share the Downstream controller for Video Service (Virtual Splitting for Video) List of additional cores the RPD should connect to Service Template as created in the Service Definition tab 10

15 Information about Cisco Smart PHY Cable RPD Automation Service Definitions Allows you to add, edit, delete or assign service templates. Fields that are not marked as optional are mandatory. Following are the fields descriptions: 11

16 Cable RPD Automation Information about Cisco Smart PHY Name Event Profile R-DTI Profile Service Group Profile Downstream Controller Profile Upstream Controller Profile Narrowcast Video Controller Profile Broadcast Video Controller Profile Out Of Band Description RPD Event Profile Set Remote DOCSIS Timing Interface (R-DTI) Set Pre-existing Cable Service Profile-Group on the CBR Primary Downstream CCAP Controller Profile Primary Upstream CCAP Controller Profile Downstream Video Controller Profile Downstream Broadcast Video Controller Profile Out of Band Profile Parameters Global Settings Allows you to add, edit, or delete the software compatibility matrix. Fields that are not marked as optional are mandatory. Software Compatibilty This window displays a compatibility matrix for the RPD software versions and the Cisco cbr software versions. The Smart PHY application detects the software incompatibility between an RPD and a Cisco cbr-8 router, and alerts you about the incompatibility. After the alert appears, you can either manually upgrade the RPD software version or upgrade it through the Smart PHY application Name RPD Vendor RPD Software Version Router Vendor Router Software Version Description Name of the RPD vendor. Software version running on the RPD. Name of the router vendor. Software version of the router. Static Route To route traffic and for communication between an RPD and a Cisco cbr-8 router, static routes to the Cisco cbr router are created when you configure the RPDs. SmartPHY automatically creates a static route for the RPD if the DPIC interface is configured with a /31 subnet. The static route is determined by calculating the gateway IP address and routing traffic through the gateway for the RPD. 12

17 Information about Cisco Smart PHY Admin Note The DPIC must be a /31 subnet. Wait for the RPD to push the static route configuration. Sample of a Cisco Smart PHY Generated Configuration cable rpd <Internal UUID of the CBR> identifier core-interface Te3/1/0 principal rpd-ds 0 downstream-cable 3/0/4 profile 0 rpd-ds 0 downstream-oob-vom 1 profile 5 rpd-us 0 upstream-cable 3/0/4 profile 0 rpd-us 0 upstream-oob-varpd 2 profile 4 rpd-ds 0 downstream-cable 3/0/5 profile 67 r-dti 20 rpd-event profile 0 cable fiber-node <next available fiber-node> downstream Downstream-Cable 3/0/4 upstream Upstream-Cable 3/0/4 downstream sg-channel 0 3 downstream-cable 3/0/4 rf-channel 0 3 upstream sg-channel 0 Upstream-Cable 3/0/4 us-channel 0 service-group profile CBRServiceGroup Admin The Cisco Smart PHY application has two views under Admin. One for debugging and the other for managing users. Admin Home The Admin Home page has three tabs: Logs Traces Kubernetes Cisco Smart PHY logs capture information about actions in the system as well as interactions with managed devices. You can download log documents for troubleshooting purposes. Cisco Smart PHY retains log documents for 12 hours. Cisco Smart PHY uses Kibana for logging. Kibana is an open source data visualization plug-in for Elasticsearch. Users with administrator privileges can create additional filters or change the time period for log retention by working directly in Kibana. Admin Users The Admin Users page allows you to view existing users and add new users. Exisitng user profiles can be edited or deleted. 13

18 Admin Information about Cisco Smart PHY 14

19 CHAPTER 2 How to Install Cisco Smart PHY The task below describes how to install the Cisco Smart PHY application: Installation Overview, page 15 How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server, page 16 How to Deploy Cisco Smart PHY OVF Template through ESXi Host, page 21 How to Install VMware Tools, page 26 How to Install the Cisco Smart PHY, page 26 How to Install the Mobile Application, page 28 How to Upgrade the Cisco Smart PHY, page 28 How to Uninstall the Cisco Smart PHY, page 29 Installation Overview The Cisco Smart PHY application is based on next generation architecture including Kubernetes and Docker containers. It includes a platform that is extensible and scalable. The Cisco Smart PHY installation is deployed as a self-contained package. The upgrade packages are also self-contained and will be made available periodically. After the Cisco Smart PHY application is installated, it would include a KVM-based Guest OS running CentOS7 that runs Docker images orchestrated by Kubernetes. 15

20 How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server How to Install Cisco Smart PHY The Cisco Smart PHY application is supported on both a bare metal server with a CentOS 7 host OS and an ESXi VM with VM-in-VM configuration. How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server Procedure Step 1 From the vcenter Server WebUI, navigate to Hosts and Clusters. Step 2 Right click on the ESXi host where the VM is deployed and select Deploy OVF Template. Step 3 Click Local File, then click Browse and navigate to the local folder containing the OVF files. 16

21 How to Install Cisco Smart PHY How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server Step 4 Select SmartPHY-Deployment.ovf, SmartPHY-Deployment-1.vmdk, and SmartPHY-Deployment.mf files and click Open. Step 5 Update the name of the Virtual Machine if needed and click Next. Step 6 Select the ESXi Host for deployment and click Next. 17

22 How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server How to Install Cisco Smart PHY Step 7 Review details and click Next. Step 8 Select the Disk Format. Choose Thick Provision Eager Zeroed and the Datastore and click Next. 18

23 How to Install Cisco Smart PHY How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server Step 9 Select Networks. Lab Network should map to the Destination Network associated with the Management Interface and the VM Network should map to the RPHY/CIN Interface. Step 10 Fill in the network information for the Primary Interface (Management), Secondary Interface (RPHY/CIN), and DNS Server. 19

24 How to Deploy Cisco Smart PHY OVF Template through VMWare vcenter Server How to Install Cisco Smart PHY Step 11 Review the settings and select Finish. Step 12 Monitor the OVF deployment in the Recent Tasks pane. Step 13 After the OVF deployment task completes successfully, power on the new virtual machine. Right click on the VM and select Power and then Power On. 20

25 How to Install Cisco Smart PHY How to Deploy Cisco Smart PHY OVF Template through ESXi Host Step 14 Install the Cisco Smart PHY application on the VM. Credentials for deploying: Login: spadmin Password: spadmin How to Deploy Cisco Smart PHY OVF Template through ESXi Host Procedure Step 1 From the ESXi host WebUI, right click on Host in the Navigator pane and select Create/Register VM. Step 2 Select Deploy a Virtual Machine from an OVF or OVA file in the Select Creation Type window and click Next. 21

26 How to Deploy Cisco Smart PHY OVF Template through ESXi Host How to Install Cisco Smart PHY Step 3 Enter the name of the new virtual machine. For example, "SmartPHY-Deployment-Lab1" and click on the Click to Select Files or drag/drop box. Step 4 Navigate to the folder containing the OVF files on the local system. Select SmartPHY-Deployment.ovf, SmartPHY-Deployment-1.vmdk, and SmartPHY-Deployment.mf files. Click Open, then click Next. Note Only the.ovf and.vmdk files may display after selection. 22

27 How to Install Cisco Smart PHY How to Deploy Cisco Smart PHY OVF Template through ESXi Host Step 5 Select the Datastore for the VM. Step 6 Select Networks and Storage Type. Lab Network should map to the Destination Network associated with the Management Interface and the VM Network should map to the RPHY/CIN Interface. Select Thick for Disk Provisioning and click Next. 23

28 How to Deploy Cisco Smart PHY OVF Template through ESXi Host How to Install Cisco Smart PHY Step 7 In the Additional Settings configuration box, fill in the network information for the Primary Interface (Management), Secondary Interface (RPHY/CIN), and DNS Server and click Next. Step 8 Review the settings and select Finish. 24

29 How to Install Cisco Smart PHY How to Deploy Cisco Smart PHY OVF Template through ESXi Host Step 9 Monitor the OVF deployment in the Recent Tasks pane. Step 10 The new Virtual Machine should power on automatically. However, if it does not, expand the Virtual Machines list in the Navigator pane and right click on the VM. Select Power and then Power On to start it. Step 11 Install the Cisco Smart PHY application on the VM. Credentials for deploying: Login: spadmin Password: spadmin 25

30 How to Install VMware Tools How to Install Cisco Smart PHY How to Install VMware Tools Procedure Step 1 Step 2 CentOS / Fedora based Installation yum clean all yum install -y epel-release yum install -y open-vm-tools Debian and Ubuntu based Installation sudo aptitude install -y open-vm-tools Note You MUST make sure that the vcpu entry in the smartphy.xml file is <= the number of CPUs allocated to the ESXi VM. By default there are 16 CPUs allocated. How to Install the Cisco Smart PHY Before You Begin You must install CentOS7 on bare metal server. This ensures that the installation script spins a VM-based KVM and the required containers. Bare Metal Solution EXSi Solution 26

31 How to Install Cisco Smart PHY How to Install the Cisco Smart PHY At a minimum, it is recommended that the server has the following attributes: 32 Gb RAM 16 Physical CPU Cores 250GB of Disk Procedure Step 1 Step 2 Step 3 Step 4 Download the Cisco Smart PHY release image tarball (which is about 16 GB) from Cisco Software Central. Unzip and untar the file: pbunzip2 smartphy tar.bz2 tar -xvf smartphy tar Run the installer../install.sh <mysereno> The installer will automatically add a DNS entry in /etc/hosts to identify the new VM. Add routes to the VM for both management and CIN network if applicable. And run the iptables.sh script individually for the management and CIN network as applicable../iptables.sh <HostOS_IP> <GuestOS_IP> Note The IP address of the VM is displayed during the install process. To get the MAC and IP address of the VM, do the following: MAC Address: sudo virsh domiflist vmname grep robot-br1 IP Address: sudo virsh net-dhcp-leases robot-br1 grep MAC 27

32 How to Install the Mobile Application How to Install Cisco Smart PHY How to Install the Mobile Application You can install the Cisco Smart PHY application on ios and Android hand-held devices. Minimum required versions: ios version 10 Android version 5 Procedure Step 1 Step 2 Download the ios version of the Cisco Smart PHY application from the App Store. Search for Cisco Smart PHY. Or Download the Android version (apk file) of the Cisco Smart PHY application from Cisco Software Central. Note Disable download from unknown sources in Security (Settings -> Security -> Enable unknown sources). How to Upgrade the Cisco Smart PHY The Cisco Smart PHY application will be upgraded periodically with newer features. To upgrade an existing installation: Procedure Step 1 Step 2 Download the upgrade image from Cisco Software Central. Unzip and untar the file: pbunzip2 smartphy upgrade.tar.bz2 tar -xvf smartphy upgrade.tar Or Step 3 pbunzip2 smartphy upgrade.tar.bz2 tar jxvf smartphy upgrade.tar.bz2 Run the upgrade script../upgrade.sh <mysereno> Specific components of the Cisco Smart PHY guest OS will be updated. 28

33 How to Install Cisco Smart PHY How to Uninstall the Cisco Smart PHY How to Uninstall the Cisco Smart PHY Be aware that this procedure removes all of your Cisco Smart PHY data. Procedure Step 1 Step 2 (Recommended) Back up your current data. Uninstalling the Cisco Smart PHY application will permanently delete all data on the bare metal server. On the bare metal server, enter: sudo virsh destroy VM_name 29

34 How to Uninstall the Cisco Smart PHY How to Install Cisco Smart PHY 30

35 CHAPTER 3 How to Use Cisco Smart PHY The task below describes how to use the Cisco Smart PHY application: How to Log In using a Browser, page 31 How to Bring Up the RPD, page 33 How to Add an RPD using Mobile Application, page 38 How to Create a New Credential Profile, page 39 How to Apply Device Credential from Credential Profiles, page 39 How to Apply a Different Credential Profile to Existing Devices, page 40 How to Apply Different Credential Profile in Bulk, page 40 How to Delete a Device from the Inventory, page 41 How to Create CSV File for Importing Devices, page 41 How to Export Device Information to a CSV File, page 42 How to Add Devices through GUI, page 42 How to Import Device Information in Bulk, page 43 How to Delete a Credential Profile, page 43 How to Create a New Service Definition, page 45 How to Specify RPD Assignment, page 45 How to Log In using a Browser Procedure Step 1 Step 2 Step 3 Make sure that the iptables.sh script has been executed for the management interface. Launch one of the supported browsers (see Supported Web Browsers). In the browser's address bar, enter 31

36 How to Log In using a Browser How to Use Cisco Smart PHY The Cisco Smart PHY web GUI displays the Login window. When you access Cisco Smart PHY for the first time, some browsers display a warning that the site is untrusted. When this happens, follow the prompts to add a security exception and download the self-signed certificate from the Cisco Smart PHY server. After you do this, the browser accepts the Cisco Smart PHY server as a trusted site in all future login attempts. Figure 2: Login Step 4 Step 5 Enter the web GUI username and password as specified when you installed the server, then click Log In. The default username is admin and password is admin. To exit the web GUI, close the browser window or click the Settings icon in the top right of the Cisco Smart PHY home page and choose Log out. Exiting a Cisco Smart PHY web GUI session does not shut down Cisco Smart PHY on the server. If a system administrator stops the Cisco Smart PHY server during your Cisco Smart PHY session, your session ends. Your session does not reassociate to Cisco Smart PHY when the server restarts; you must start a new Cisco Smart PHY session. 32

37 How to Use Cisco Smart PHY How to Bring Up the RPD How to Bring Up the RPD Procedure Step 1 Step 2 Log into the Cisco Smart PHY application. Go to Username: admin Password: admin Create Credential Profile. 1 Choose Inventory > Credential Profiles. 2 Add login credentials and SNMP credentials of the Cisco cbr router that will be added in the Inventory. 3 Click Save. 33

38 How to Bring Up the RPD How to Use Cisco Smart PHY Step 3 Add the Cisco cbr router inventory and reference the credential profile. Device can be added manually or by importing from a CSV file. The following values should be set for the Cisco cbr device. IP Address - This is the key for the Cisco cbr router Product Type - CBR-8-CCAP-CHASS Connectivity Type - SSH Product Family - Cisco 34

39 How to Use Cisco Smart PHY How to Bring Up the RPD Software Type - IOS-XE Credential Profile - Specify the credential profile. Devices with the same credentials can use the same credential profile. 1 Choose Inventory > Inventory. 2 To upload a CSV file, click on Upload, select the file and click on Import. The Import dialog box also holds a link to a sample CSV file which can be downloaded for reference. Make sure you save the edited file in CSV format. Or To manually add a device, click the + icon and provide the required information and save. Step 4 Step 5 Configure the Cisco cbr to send syslog messages to the Cisco Smart PHY application. The Cisco Smart PHY application uses syslog messages to monitor the state of the RPD on the Cisco cbr. Run the following command on the Cisco cbr router: logging host <Smart PHY interface connected to the Cisco cbr> transport udp port 8514 Create a Service Template. Note Fields not marked as optional are mandatory. 1 Choose Cable RPD Automation > Service Definitions. 2 Specify Profiles as pre-configured on the Cisco cbr router. 35

40 How to Bring Up the RPD How to Use Cisco Smart PHY 3 Click Save. Step 6 Pair an RPD with a Cisco cbr router and service template. Note Fields with an asterisks is a mandatory field. 36

41 How to Use Cisco Smart PHY How to Bring Up the RPD 1 Choose Cable RPD Automation > RPD Assignment. 2 RPD Assignment can be specified manually or by importing a CSV file. To upload a CSV file, click Upload, select the file and click Import. Or To specify RPD assignment manually, click Add or Edit. 37

42 How to Add an RPD using Mobile Application How to Use Cisco Smart PHY Click Save. Step 7 In the DHCP server, enter the IP address of the Smart PHY host OS in the CCAP Core field for the RPD. After retrieving the IP address from the DHCP server, the RPDs are redirected to the Smart PHY application. When the RPD resets, it gets the new DHCP server attributes and values from the DHCP server and connects to the Smart PHY application. How to Add an RPD using Mobile Application Procedure Step 1 Step 2 Step 3 Step 4 Log into the Cisco Smart PHY mobile application. Click Add. Name is a mandatory field. Scan the RPD barcode. The RPD is listed in the Devices tab. Register the device. 38

43 How to Use Cisco Smart PHY How to Create a New Credential Profile How to Create a New Credential Profile Procedure Step 1 Step 2 Step 3 Step 4 Step 5 Choose Inventory > Credential Profiles. Click Create New. Enter a profile name and description. If you will have many credential profiles, make the name and description as informative as possible because that information will be displayed on the Credential Profiles panel. Enter the credentials for the profile. When a device is added or updated using this profile, the content you specify here is applied to the device. Click Save. How to Apply Device Credential from Credential Profiles Credential profiles are collections of device credentials for SNMP, Telnet/SSH, HTTP, and TL1 network devices. Using credential profiles lets you apply credential settings consistently across devices. When you add or import devices, you specify the credential profile the devices use. If you need to make a credential change, such as changing a device password, you can edit the profile to update the settings across all devices that use that profile. Procedure Step 1 Step 2 To view the existing profiles, choose Inventory > Credential Profiles. Click the profile you want to view. Credential profiles can be shared by multiple devices. Large networks might have similar credentials for hundreds of devices. The mandatory fields are: Profile Name Username Password Admin Username Admin Password 39

44 How to Apply a Different Credential Profile to Existing Devices How to Use Cisco Smart PHY How to Apply a Different Credential Profile to Existing Devices You can use the Inventory user interface to edit device information, including changing the credential profile in the inventory record. This operation overwrites any existing association between a device and a credential profile. You can also use this operation to synchronize device configurations with new settings. Before You Begin You need a credential profile to complete this task. Procedure Step 1 Step 2 Step 3 Step 4 Step 5 To view inventory, choose Inventory > Inventory. (Optional) In the Inventory section, filter the list of devices by entering text in the Search field or filtering on the individual headings. Check the check boxes of the devices you want to change, and click the Edit icon. Choose a different credential profile from the Credential Profile drop-down list, for example, or make other changes in the device records. Click Save. How to Apply Different Credential Profile in Bulk This is an alternative to changing the credential profile for devices within the Cisco Smart PHY Inventory Manager GUI. If you are changing the credential profile for a large number of devices, you may find it more efficient to make the change by using a CSV file rather than the Cisco Smart PHY UI. Export a CSV file, make the changes, and import the changed CSV file. This operation overwrites any existing association between a device and a credential profile. You can also use this operation to synchronize device configurations with new settings. Procedure Step 1 Step 2 Step 3 (Optional) To review the contents of a credential profile, choose Inventory > Credential Profiles. Click the profile you want to use. Else, create a new profile. To view device inventory, choose Inventory > Inventory. Choose which device records to change by including them in the CSV file. Do one of the following: Click the Export icon to include all devices. Filter the list of devices by entering text in the Search field or by filtering on the individual headings, and then click the Export icon to include the filtered list of devices. Check the check boxes for the device records you want to change, and then click the Export icon to include the selected devices. 40

45 How to Use Cisco Smart PHY How to Delete a Device from the Inventory Step 4 Step 5 Step 6 Step 7 Edit and save the new CSV file. Note: You must save the file opened in MS Excel as a CSV file only. In the Import CSV File dialog box, click Browse, select the new CSV file, and click the Import icon. In the Replace Existing Node dialog box, click Yes to All. Click Save. How to Delete a Device from the Inventory Procedure Step 1 Step 2 Step 3 Step 4 Step 5 Choose Inventory > Inventory. (Optional) In the Inventory section, filter the device list by entering text in Search or filtering specific columns. Check the check boxes for the devices you want to delete. Click Delete. In the confirmation dialog box, click Delete. How to Create CSV File for Importing Devices To add information for multiple devices to Inventory Manager, create a CSV file. Inventory Manager contains a sample template CSV file. The GUI for adding individual devices contains field information that also applies to the contents of the CSV files that you create for device import. Procedure Step 1 Step 2 Step 3 Choose Inventory > Inventory. In the Inventory section, click Import. You will be prompted to open or save the sample CSV file. Save the CSV file. Edit the CSV file and save it as a CSV file on your system. Upload this CSV file to import devices. The mandatory fields are: Product Type Credential Profile One IP Address and its Connectivity Type MAC Address Serial Number or Inventory ID 41

46 How to Export Device Information to a CSV File How to Use Cisco Smart PHY How to Export Device Information to a CSV File When you export the device list to a file, all device information is exported into a CSV file. The exported file includes device credentials, but does not include credential profiles. Caution The CSV file lists all of the credentials for the exported devices. Handle the CSV file with care. Ensure that only users with special privileges can perform a device export. Procedure Step 1 Step 2 Step 3 Step 4 Choose Inventory > Inventory. (Optional) In the Inventory section, filter the device list by entering text in the Search field or filtering specific columns. Check the check boxes for the devices you want to export. Click Export. How to Add Devices through GUI If you have many devices to add to the Inventory Manager, you may find it more efficient to put the information in a CSV file and import the file. Procedure Step 1 Step 2 Step 3 Choose Inventory > Inventory. In the Inventory section, click Add. Enter the values for the device. The mandatory fields are: Product Type Credential Profile One of the following: Inventory ID IP Address MAC Address Serial Number 42

47 How to Use Cisco Smart PHY How to Import Device Information in Bulk Step 4 Step 5 Click Save. (Optional) Repeat to add more devices. How to Import Device Information in Bulk Before starting this procedure, you need to create a CSV file that contains the device information. Procedure Step 1 Step 2 Step 3 Choose Inventory > Inventory. Click Import. In the Import CSV File window, click Browse, select the CSV file, and click Import. If any primary keys are duplicates with existing device records, Inventory Manager alerts you. How to Delete a Credential Profile To delete a credential profile from Inventory Manager, disassociate the profile from any devices. Inventory Manager displays an alert if you attempt to delete a credential profile that is associated with devices. (Optional) Check whether any devices are using the obsolete credential profile and change the credential profile before attempting deletion. 1 Choose Inventory > Inventory. 2 In the Inventory section, enter the obsolete credential profile name in the Search field. 3 Check the check boxes for the devices that use the obsolete credential profile, and click Edit. 4 Choose a different credential profile from the Credential Profile drop-down list. 5 Click Save. Procedure Step 1 Step 2 Choose Inventory > Credential Profiles. Click on a profile, and click Delete. 43

48 How to Delete a Credential Profile How to Use Cisco Smart PHY 44

49 How to Use Cisco Smart PHY How to Create a New Service Definition How to Create a New Service Definition Procedure Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Choose Cable RPD Automation > Service Definitions. Click + Create New. Enter a name and description. If you will have many service definitions, make the name and description as informative as possible because that information will be displayed on the RPD Assignment and Overview tabs. (Optional) Check the Set as Default check box. Enter the definitions for the service. See definitions. When a device is added or updated using this service definition, the content you specify here is applied to the device. All fields that are not marked as optional are mandatory. Click Save or Save & Assign. How to Specify RPD Assignment Procedure Step 1 Step 2 Step 3 Step 4 Choose Cable RPD Automation > RPD Assignment. RPD Assignment can be specified manually or by importing a CSV file. Click + to assign a service template to an RPD. Fill in all the fields. To upload a CSV file, click Upload, select the file and click Import. Click Save. Click Assign. 45

50 How to Specify RPD Assignment How to Use Cisco Smart PHY 46

51 CHAPTER 4 How to Troubleshoot Cisco Smart PHY Following are some troubleshooting tips for installing and using the Cisco Smart PHY. How to Troubleshoot Cisco Smart PHY, page 47 How to Troubleshoot Cisco Smart PHY Problem Solution Syslog messages are not received. Syslog messages MUST be sent to TCP port 8514 for it to take effect. Configure: logging host transport tcp port 8514 Unable to access the UI. Execute the following command to view the iptable rules: iptables -L -t nat -n NSO fails to configure the device. The IPTable rules might be incorrect. Reboot the VM. Permission Denied error: Ensure that the user (qemu:x:107:107:qemu user:/:/sbin/nologin) has access to your directory. error: Failed to start domain my_sereno_vm error: Cannot access storage file '/home/in stall/robot_configfs.qcow2' (as uid:107, gid :107): Permission denied This includes your home directory as well. pbzip2 error: Download and install the package: pbzip2: command not found wget _64/rpmforge/RPMS/pbzip el7.rf.x86_64.rpm rpm -Uvh pbzip el7.rf.x86_64.rpm Installation fails with the below error: Install the required packages:./robot_bringup.sh: line 290: virt -make-fs: command not found sudo yum install libguestfs-tools 47

52 How to Troubleshoot Cisco Smart PHY How to Troubleshoot Cisco Smart PHY Problem File system out of memory. libguestfs appliance crash. Solution Restart the logger: sudo docker restart robot-logger Clean the directory: sudo rm -fr.guestfs-0/ pwd /var/tmp 48