Cisco Smart PHY v1.0 User Guide€¦ · HowtoAddDevicesthroughGUI 42 HowtoImportDeviceInformationinBulk 43 HowtoDeleteaCredentialProfile 43 HowtoCreateaNewServiceDefinition 45 HowtoSpecifyRPDAssignment

Cisco Smart PHY v1.0 User GuideFirst Published: 2017-11-22

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800 553-NETS (6387)Fax: 408 527-0883

© 2017 Cisco Systems, Inc. All rights reserved.

C O N T E N T S

C H A P T E R 1 Information about Cisco Smart PHY 1

Benefits of Cisco Smart PHY 2

Dashboard 3

Inventory 4

Cable RPD Automation 8

Admin 13

C H A P T E R 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

C H A P T E R 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

Cisco Smart PHY v1.0 User Guide iii

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

C H A P T E R 4 How to Troubleshoot Cisco Smart PHY 47

How to Troubleshoot Cisco Smart PHY 47

Cisco Smart PHY v1.0 User Guideiv

Contents

C H A P T E R 1Information about Cisco Smart PHY

The Cisco Smart PHY application is an integrated package for installing, configuring, monitoring andtroubleshooting the Cisco Remote-PHY devices (RPD) connected to the Cisco CMTS. It is a micro-servicesplatform for customers and partners to collaborate and build an application ecosystem around on-boxinnovation. 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:

DescriptionIcon

Information button. Click this button to displaymore information.

Context Menu button. Move the mouse over thisbutton 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

Cisco Smart PHY v1.0 User Guide 1

Benefits of Cisco Smart PHYTypically, 200 to 500 RPDs might be connected to a single Cisco CMTS and manual configuration andmonitoring 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 theCisco CMTS.

• RPD Inventory: RPD inventory operations. For example, running inventory reports or searching forRPDs based on specific criteria and so on.

• RPD SWManagement: RPD SW version management.

Cisco Smart PHY v1.0 User Guide2

Information about Cisco Smart PHYBenefits of Cisco Smart PHY

Dashboard


Information about Cisco Smart PHYDashboard

Following are the field descriptions:

DescriptionNameCallout #

Snapshot view of all devices managed andmonitored by the CiscoSmart PHY application.

Dashboard1

Geographical view of registered inventory.Topology2

Shows the number of nodes installed using the Cisco Smart PHYapplication. This panel also shows the number of CredentialProfiles available in the application.

The pie chart shows the reachable and unknown nodes.

Installed Nodes3

Shows the number of RPDs, Service Templates, CCAP Cores,and Associations configured and managed using the Cable RPDAutomation page.

Click on a number to view more details.

Click on Launch to go to the Cable RPD Automation page.

Cable4

Takes you to the specific page view.Launch5

InventoryInventory has two tabs; Inventory and Credential Profiles.


Information about Cisco Smart PHYInventory

Inventory

The Inventory tab enables you to add, organize, and update information about the network devices. Thisincludes non-Cable devices too and hence the information to be provided is more exhaustive than in the CableRPD Automation view.

You must add the RPDs through the Cable Pairing table in Cisco cBR and not through the Inventory tabin the Cisco Smart PHY application.

Note

Following are the field descriptions for Inventory:



DescriptionName

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 isManaged or Unmanaged.

Status

Shows a graphical chart of all devices in the network, categorized by type (SNMP,Telnet/SSH, HTTP, and TL1).

Type

Shows a graphical chart of all devices in the network, categorized by vendor (Ciscoand third party).

The charts let you see, at a glance, the distribution of devices in the network.

Manufacturer

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.

Allows you to search for and filter the network devices.Search

Shows detailed information about each device in the network.Devices table

Credential Profiles



Credential profiles are collections of device credentials for SNMP, Telnet/SSH, HTTP, and TL1 networkdevices. Using credential profiles lets you apply credential settings consistently across devices. When youadd or import devices, you specify the credential profile the devices use. If you need to make a credentialchange, such as changing a device password, you can edit the profile to update the settings across all devicesthat use that profile.

Figure 1: Credential Profiles

Following are the field descriptions for Credential Profiles:



DescriptionName

Allows you to add or edit a credential profile.

Note: Mandatory fields are marked with an asterisks.

+ Create New

This credential profile is the default RPD profile generated by the system. When auser deletes this profile and new one is generated automatically by the systemimmediately.

Any new RPD added to the inventory is associated with the rpd_default profile.

rpd_default

Use these buttons to complete your action.Save/Delete/Cancel

Cable RPD AutomationThe Cable RPD Automation page enables you to add, organize, and update information about CMTS andRPD devices in the network. The information to be provided in this view is less compared to that in theInventory 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 dashboardview of the Core and the RPDs in different status.


Information about Cisco Smart PHYCable RPD Automation

RPD Assignment

Allows you to add, edit, import, or export RPDs associated with a specific service template. Search allowsyou to search for or filter the associated RPDs.



Following are the fields descriptions:

DescriptionName

The CBR8 to which the RPD should connect toCCAP Core

Complete name of the TenGigabitEthernet DPICInterface to be used for Data Service

Core Interface

Complete name of the TenGigabitEthernet DPICInterface to be used for Video (Narrowcast) Service

Video Interface

Complete name of the TenGigabitEthernet DPICInterface to be used for Broadcast Video Service.Cannot be same as the Video Interface.

Broadcast Video Interface

All RPDs with the same data service group will sharethe Downstream controller for Data Service (VirtualSplitting for Data)

Data Service Group

All RPDs with the same video service group willshare the Downstream controller for Video Service(Virtual Splitting for Video)

Video Service Group

List of additional cores the RPD should connect toAdditional Cores

Service Template as created in the Service Definitiontab

Service Template



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:



DescriptionName

RPD Event Profile SetEvent Profile

Remote DOCSIS Timing Interface (R-DTI) SetR-DTI Profile

Pre-existing Cable Service Profile-Group on the CBRService Group Profile

Primary Downstream CCAP Controller ProfileDownstream Controller Profile

Primary Upstream CCAP Controller ProfileUpstream Controller Profile

Downstream Video Controller ProfileNarrowcast Video Controller Profile

Downstream Broadcast Video Controller ProfileBroadcast Video Controller Profile

Out of Band Profile ParametersOut Of Band

Global Settings

Allows you to add, edit, or delete the software compatibility matrix. Fields that are not marked as optionalare mandatory.

Software Compatibilty—This window displays a compatibility matrix for the RPD software versions and theCisco cBR software versions. The Smart PHY application detects the software incompatibility between anRPD and a Cisco cBR-8 router, and alerts you about the incompatibility. After the alert appears, you can eithermanually upgrade the RPD software version or upgrade it through the Smart PHY application

DescriptionName

Name of the RPD vendor.RPD Vendor

Software version running on the RPD.RPD Software Version

Name of the router vendor.Router Vendor

Software version of the router.Router Software Version

Static Route

To route traffic and for communication between an RPD and a Cisco cBR-8 router, static routes to the CiscocBR 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 /31subnet. The static route is determined by calculating the gateway IP address and routing traffic through thegateway for the RPD.



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 Configurationcable rpd <Internal UUID of the CBR>-5000.0000.0001identifier 5000.0000.0001core-interface Te3/1/0principalrpd-ds 0 downstream-cable 3/0/4 profile 0rpd-ds 0 downstream-oob-vom 1 profile 5rpd-us 0 upstream-cable 3/0/4 profile 0rpd-us 0 upstream-oob-varpd 2 profile 4rpd-ds 0 downstream-cable 3/0/5 profile 67

r-dti 20rpd-event profile 0

cable fiber-node <next available fiber-node>downstream Downstream-Cable 3/0/4upstream Upstream-Cable 3/0/4downstream sg-channel 0 3downstream-Cable 3/0/4 rf-channel 0 3upstream sg-channel 0 Upstream-Cable 3/0/4 us-channel 0service-group profile CBRServiceGroup

AdminThe Cisco Smart PHY application has two views under Admin. One for debugging and the other for managingusers.

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 manageddevices. You can download log documents for troubleshooting purposes. Cisco Smart PHY retains logdocuments for 12 hours. Cisco Smart PHY uses Kibana for logging. Kibana is an open source data visualizationplug-in for Elasticsearch. Users with administrator privileges can create additional filters or change the timeperiod 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 beedited or deleted.


Information about Cisco Smart PHYAdmin


Information about Cisco Smart PHYAdmin

C H A P T E R 2How 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 OverviewThe Cisco Smart PHY application is based on next generation architecture including Kubernetes and Dockercontainers. 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 alsoself-contained and will be made available periodically.

After the Cisco Smart PHY application is installated, it would include a KVM-based Guest OS runningCentOS7 that runs Docker images orchestrated by Kubernetes.


The Cisco Smart PHY application is supported on both a bare metal server with a CentOS 7 host OS and anESXi VM with VM-in-VM configuration.

How to Deploy Cisco Smart PHY OVF Template through VMWarevCenter 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.


How to Install Cisco Smart PHYHow to Deploy Cisco Smart PHY OVF Template through VMWare vCenter Server

Step 4 Select SmartPHY-Deployment.ovf, SmartPHY-Deployment-1.vmdk, and SmartPHY-Deployment.mffiles 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.



Step 7 Review details and click Next.

Step 8 Select the Disk Format. Choose Thick Provision Eager Zeroed and the Datastore and click Next.



Step 9 Select Networks. Lab Network should map to the Destination Network associated with the ManagementInterface 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.



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 onthe VM and select Power and then Power On.



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 ESXiHost

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 clickNext.


How to Install Cisco Smart PHYHow to Deploy Cisco Smart PHY OVF Template through ESXi Host

Step 3 Enter the name of the new virtual machine. For example, "SmartPHY-Deployment-Lab1" and click on theClick 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.

Only the .ovf and .vmdk files may display afterselection.

Note



Step 5 Select the Datastore for the VM.

Step 6 Select Networks and Storage Type. Lab Network should map to the Destination Network associated withthe Management Interface and the VM Network should map to the RPHY/CIN Interface. Select Thick forDisk Provisioning and click Next.



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.



Step 9 Monitor the OVF deployment in the Recent Tasks pane.

Step 10 The newVirtual Machine should power on automatically. However, if it does not, expand the Virtual Machineslist 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



How to Install VMware ToolsProcedure

Step 1 CentOS / Fedora based Installationyum clean allyum install -y epel-releaseyum install -y open-vm-tools

Step 2 Debian and Ubuntu based Installationsudo aptitude install -y open-vm-tools

You MUST make sure that the vCPU entry in the smartphy.xml file is <= the number of CPUsallocated to the ESXi VM. By default there are 16 CPUs allocated.

Note

How to Install the Cisco Smart PHYBefore You Begin

You must install CentOS7 on bare metal server. This ensures that the installation script spins a VM-basedKVM and the required containers.

Bare Metal Solution

EXSi Solution


How to Install Cisco Smart PHYHow to Install VMware Tools

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 Download the Cisco Smart PHY release image tarball (which is about 16 GB) from Cisco Software Central.Step 2 Unzip and untar the file:

pbunzip2 smartphy-1.0.9.tar.bz2tar -xvf smartphy-1.0.9.tar

Step 3 Run the installer../install.sh <mysereno>

The installer will automatically add a DNS entry in /etc/hosts to identify the new VM.

Step 4 Add routes to the VM for both management and CIN network if applicable. And run the iptables.sh scriptindividually for the management and CIN network as applicable../iptables.sh <HostOS_IP> <GuestOS_IP>

The IP address of the VM is displayed during the install process. To get the MAC and IP address ofthe VM, do the following:

MAC Address:

sudo virsh domiflist vmname | grep robot-br1

IP Address:

sudo virsh net-dhcp-leases robot-br1 | grep MAC

Note


How to Install Cisco Smart PHYHow to Install the Cisco Smart PHY

https://software.cisco.com/download/release.html?mdfid=286319080&softwareid=286319227&release=1.0.1&relind=AVAILABLE&rellifecycle=&reltype=latest

How to Install the Mobile ApplicationYou 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 Download the iOS version of the Cisco Smart PHY application from the App Store. Search for Cisco SmartPHY.Or

Step 2 Download the Android version (apk file) of the Cisco Smart PHY application from Cisco Software Central.Disable download from unknown sources in Security (Settings -> Security -> Enable unknownsources).

Note

How to Upgrade the Cisco Smart PHYThe Cisco Smart PHY application will be upgraded periodically with newer features. To upgrade an existinginstallation:

Procedure

Step 1 Download the upgrade image from Cisco Software Central.Step 2 Unzip and untar the file:

pbunzip2 smartphy-1.0.9-upgrade.tar.bz2tar -xvf smartphy-1.0.9-upgrade.tar

Or

pbunzip2 smartphy-1.0.9-upgrade.tar.bz2tar jxvf smartphy-1.0.9-upgrade.tar.bz2

Step 3 Run the upgrade script.

./upgrade.sh <mysereno>

Specific components of the Cisco Smart PHY guest OS will be updated.


How to Install Cisco Smart PHYHow to Install the Mobile Application



How to Uninstall the Cisco Smart PHYBe aware that this procedure removes all of your Cisco Smart PHY data.

Procedure

Step 1 (Recommended) Back up your current data. Uninstalling the Cisco Smart PHY application will permanentlydelete all data on the bare metal server.

Step 2 On the bare metal server, enter:sudo virsh destroy VM_name


How to Install Cisco Smart PHYHow to Uninstall the Cisco Smart PHY


How to Install Cisco Smart PHYHow to Uninstall the Cisco Smart PHY

C H A P T E R 3How 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 BrowserProcedure

Step 1 Make sure that the iptables.sh script has been executed for the management interface.Step 2 Launch one of the supported browsers (see Supported Web Browsers).Step 3 In the browser's address bar, enter https://server_name:30604.


The Cisco Smart PHY web GUI displays the Login window. When you access Cisco Smart PHY for the firsttime, some browsers display a warning that the site is untrusted. When this happens, follow the prompts toadd a security exception and download the self-signed certificate from the Cisco Smart PHY server. Afteryou do this, the browser accepts the Cisco Smart PHY server as a trusted site in all future login attempts.

Figure 2: Login

Step 4 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.

Step 5 To exit the web GUI, close the browser window or click the Settings icon in the top right of the Cisco SmartPHY 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, yoursession ends. Your session does not reassociate to Cisco Smart PHY when the server restarts; you must starta new Cisco Smart PHY session.


How to Use Cisco Smart PHYHow to Log In using a Browser

How to Bring Up the RPDProcedure

Step 1 Log into the Cisco Smart PHY application.Go to https://<HostOS_IP>:30604.

Username: admin

Password: admin

Step 2 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.


How to Use Cisco Smart PHYHow to Bring Up the RPD

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



• Software Type - IOS-XE

Credential Profile - Specify the credential profile. Devices with the same credentials can use the same credentialprofile.

1 Choose Inventory > Inventory.

2 To upload a CSV file, click on Upload, select the file and click on Import. The Import dialog box alsoholds a link to a sample CSV file which can be downloaded for reference. Make sure you save the editedfile in CSV format.

Or

To manually add a device, click the + icon and provide the required information and save.

Step 4 Configure the Cisco cBR to send syslog messages to the Cisco Smart PHY application. The Cisco Smart PHYapplication uses syslog messages to monitor the state of the RPD on the Cisco cBR. Run the followingcommand on the Cisco cBR router:logging host <Smart PHY interface connected to the Cisco cBR> transport udp port 8514

Step 5 Create a Service Template.Fields not marked as optional aremandatory.

Note

1 Choose Cable RPD Automation > Service Definitions.

2 Specify Profiles as pre-configured on the Cisco cBR router.



3 Click Save.

Step 6 Pair an RPD with a Cisco cBR router and service template.Fields with an asterisks is a mandatoryfield.

Note



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.



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 connectsto the Smart PHY application.

How to Add an RPD using Mobile ApplicationProcedure

Step 1 Log into the Cisco Smart PHY mobile application.Step 2 Click Add.

Name is a mandatory field.

Step 3 Scan the RPD barcode.The RPD is listed in the Devices tab.

Step 4 Register the device.


How to Use Cisco Smart PHYHow to Add an RPD using Mobile Application

How to Create a New Credential ProfileProcedure

Step 1 Choose Inventory > Credential Profiles.Step 2 Click Create New.Step 3 Enter a profile name and description. If you will havemany credential profiles, make the name and description

as informative as possible because that information will be displayed on the Credential Profiles panel.Step 4 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.Step 5 Click Save.

How to Apply Device Credential from Credential ProfilesCredential profiles are collections of device credentials for SNMP, Telnet/SSH, HTTP, and TL1 networkdevices. Using credential profiles lets you apply credential settings consistently across devices. When youadd or import devices, you specify the credential profile the devices use. If you need to make a credentialchange, such as changing a device password, you can edit the profile to update the settings across all devicesthat use that profile.

Procedure

Step 1 To view the existing profiles, choose Inventory > Credential Profiles.Step 2 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


How to Use Cisco Smart PHYHow to Create a New Credential Profile

How to Apply a Different Credential Profile to Existing DevicesYou can use the Inventory user interface to edit device information, including changing the credential profilein the inventory record. This operation overwrites any existing association between a device and a credentialprofile. 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 To view inventory, choose Inventory > Inventory.Step 2 (Optional) In the Inventory section, filter the list of devices by entering text in the Search field or filtering

on the individual headings.Step 3 Check the check boxes of the devices you want to change, and click the Edit icon.Step 4 Choose a different credential profile from the Credential Profile drop-down list, for example, or make other

changes in the device records.Step 5 Click Save.

How to Apply Different Credential Profile in BulkThis is an alternative to changing the credential profile for devices within the Cisco Smart PHY InventoryManager GUI. If you are changing the credential profile for a large number of devices, you may find it moreefficient 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 associationbetween a device and a credential profile. You can also use this operation to synchronize device configurationswith new settings.

Procedure

Step 1 (Optional) To review the contents of a credential profile, choose Inventory > Credential Profiles. Click theprofile you want to use. Else, create a new profile.

Step 2 To view device inventory, choose Inventory > Inventory.Step 3 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 toinclude the selected devices.


How to Use Cisco Smart PHYHow to Apply a Different Credential Profile to Existing Devices

Step 4 Edit and save the new CSV file. Note: You must save the file opened in MS Excel as a CSV file only.Step 5 In the Import CSV File dialog box, click Browse, select the new CSV file, and click the Import icon.Step 6 In the Replace Existing Node dialog box, click Yes to All.Step 7 Click Save.

How to Delete a Device from the InventoryProcedure

Step 1 Choose Inventory > Inventory.Step 2 (Optional) In the Inventory section, filter the device list by entering text in Search or filtering specific

columns.Step 3 Check the check boxes for the devices you want to delete.Step 4 Click Delete.Step 5 In the confirmation dialog box, click Delete.

How to Create CSV File for Importing DevicesTo add information for multiple devices to InventoryManager, create a CSV file. InventoryManager containsa sample template CSV file. The GUI for adding individual devices contains field information that also appliesto the contents of the CSV files that you create for device import.

Procedure

Step 1 Choose Inventory > Inventory.Step 2 In the Inventory section, click Import.

You will be prompted to open or save the sample CSV file. Save the CSV file.

Step 3 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


How to Use Cisco Smart PHYHow to Delete a Device from the Inventory

How to Export Device Information to a CSV FileWhen you export the device list to a file, all device information is exported into a CSV file. The exported fileincludes device credentials, but does not include credential profiles.

The CSV file lists all of the credentials for the exported devices. Handle the CSV file with care. Ensurethat only users with special privileges can perform a device export.

Caution

Procedure

Step 1 Choose Inventory > Inventory.Step 2 (Optional) In the Inventory section, filter the device list by entering text in the Search field or filtering specific

columns.Step 3 Check the check boxes for the devices you want to export.Step 4 Click Export.

How to Add Devices through GUIIf you have many devices to add to the InventoryManager, you may find it more efficient to put the informationin a CSV file and import the file.

Procedure

Step 1 Choose Inventory > Inventory.Step 2 In the Inventory section, click Add.Step 3 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


How to Use Cisco Smart PHYHow to Export Device Information to a CSV File

Step 4 Click Save.Step 5 (Optional) Repeat to add more devices.

How to Import Device Information in BulkBefore starting this procedure, you need to create a CSV file that contains the device information.

Procedure

Step 1 Choose Inventory > Inventory.Step 2 Click Import.Step 3 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 ProfileTo delete a credential profile from Inventory Manager, disassociate the profile from any devices. InventoryManager 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 credentialprofile 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 Choose Inventory > Credential Profiles.Step 2 Click on a profile, and click Delete.


How to Use Cisco Smart PHYHow to Import Device Information in Bulk


How to Use Cisco Smart PHYHow to Delete a Credential Profile

How to Create a New Service DefinitionProcedure

Step 1 Choose Cable RPD Automation > Service Definitions.Step 2 Click + Create New.Step 3 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 Overviewtabs.

Step 4 (Optional) Check the Set as Default check box.Step 5 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 aremandatory.

Step 6 Click Save or Save & Assign.

How to Specify RPD AssignmentProcedure

Step 1 Choose Cable RPD Automation > RPD Assignment.Step 2 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.

Step 3 Click Save.Step 4 Click Assign.


How to Use Cisco Smart PHYHow to Create a New Service Definition

https://www.cisco.com/c/en/us/td/docs/cable/cbr/administration/guide/cisco_smart_phy_application_user_guide/information_about_cisco_sdn_application.html#concept_v1b_svb_bbb


How to Use Cisco Smart PHYHow to Specify RPD Assignment

C H A P T E R 4How 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 PHYSolutionProblem

Syslog messages MUST be sent to TCP port 8514for it to take effect. Configure:logging host 192.0.2.1 transport tcp port8514

Syslog messages are not received.

Execute the following command to view the iptablerules:iptables -L -t nat -n

Unable to access the UI.

The IPTable rules might be incorrect. Reboot the VM.NSO fails to configure the device.

Ensure that the user (qemu:x:107:107:qemuuser:/:/sbin/nologin) has access to your directory.

This includes your home directory as well.

Permission Denied error:

error: Failed to start domain my_sereno_vmerror: Cannot access storage file '/home/install/robot_configfs.qcow2' (as uid:107, gid:107): Permission denied

Download and install the package:

wgethttp://ftp.tu-chemnitz.de/pub/linux/dag/redhat/el7/en/x86_64/rpmforge/RPMS/pbzip2-1.0.5-1.el7.rf.x86_64.rpmrpm -Uvh pbzip2-1.0.5-1.el7.rf.x86_64.rpm

pbzip2 error:pbzip2: command not found

Install the required packages:sudo yum install libguestfs-tools

Installation fails with the below error:./robot_bringup.sh: line 290: virt-make-fs: command not found


SolutionProblem

Restart the logger:sudo docker restart robot-logger

File system out of memory.

Clean the directory:sudo rm -fr .guestfs-0/pwd/var/tmp

libguestfs appliance crash.


How to Troubleshoot Cisco Smart PHYHow to Troubleshoot Cisco Smart PHY

Documents

Cisco Smart PHY v1.0 User Guide€¦ · HowtoAddDevicesthroughGUI 42 HowtoImportDeviceInformationinBulk 43 HowtoDeleteaCredentialProfile 43 HowtoCreateaNewServiceDefinition 45 HowtoSpecifyRPDAssignment