[Index]

Model: relation/HcsIOSDeviceREL

IOS Devices

Procedure

  1. Log in as provider, reseller, or customer administrator.
  2. Set the hierarchy path to the customer hierarchy node where you want to set up the IOS Device.
  3. Choose Device Management > IOS > IOS Devices.
  4. Click Add.
  5. Provide the following information:
Field Description
IOS Device Name Enter the name for the IOS Device. This field is mandatory.
Description Enter a description for the IOS Device.
Prime Collaboration Select the Prime Collaboration to manage the IOS Device.
  1. In the Network Addresses pane, configure the SERVICE_PROVIDER_SPACE address space.
Field Description
Address Space Address Space Type. SERVICE_PROVIDER_SPACE is the default. This field is required.
IPV4 Address Enter the IP address of the IOS Device.
Host Name

The Host Name field is automatically populated with the IOS Device Name. If the IOS Device Name is not the host name, you can edit this field to provide the host name, or provide an IP address in the IPV4 Address field.

Note: Either a host name or an IP address is required. If both are provided, the host name is used. If a host name is provided must be resolvable by the IOS Device.

Domain The domain of the IOS Device.
Description An optional description for the network address

If NAT is used, also configure an APPLICATION_SPACE network address.

If a double NAT is deployed, also configure a CUSTOMER_SPACE network address.

  1. Optionally, expand Credentials.

    1. Add credentials for CLI, SNMP_V2, SNMP_V3 credentials types. Click + to add more credentials.
    2. For CLI and SNMP_V3, fill in the user ID and password that you configured when you installed the IOS Device. For SNMP_V2, only the password is required.
    3. For SNMP credentials, choose RO (Read-only) or RW (Read or Write) for the Access Type. The default is RO.
    4. Provide an optional description for the credential.

    SNMP credentials are used by PCA to manage the IOS Device. CLI credentials are used to log in to the IOS Device.

    Note:

    SNMP configuration must be done manually on the IOS Device.

  2. Click Save.

Model Details

Title Description Details
IOS Device Name *
  • Field Name: name
  • Type: String
  • MaxLength: 1024
  • Pattern: ^[A-Za-z0-9_\- ]+$
Host Name *
  • Field Name: host
  • Type: String
  • MaxLength: 1024
Description
  • Field Name: description
  • Type: String
  • MaxLength: 1024
Local Gateway Associated
  • Field Name: localGw
  • Type: Boolean
Analog Gateway Associated
  • Field Name: analogGw
  • Type: Boolean
Ext
  • Field Name: ext
  • Type: Object
Host Name * The host name of IOS device
  • Field Name: ext.host
  • Type: String
Description The description of the IOS device.
  • Field Name: ext.description
  • Type: String
Username The username for the device.
  • Field Name: ext.username
  • Type: String
Password The password for the device.
  • Field Name: ext.password
  • Type: String
  • Is Password: True
  • Store Encrypted: True
Enable Password The enable password
  • Field Name: ext.enable_password
  • Type: String
  • Is Password: True
  • Store Encrypted: True
Port The port of the IOS device.
  • Field Name: ext.port
  • Type: String
Cpe
  • Field Name: cpe
  • Type: Object
id
  • Field Name: cpe.id
  • Type: String
  • MaxLength: 1024
Name *
  • Field Name: cpe.name
  • Type: String
  • MaxLength: 128
Is Router
  • Field Name: cpe.isRouter
  • Type: Boolean
Is Gateway
  • Field Name: cpe.isGateway
  • Type: Boolean
Is SRST
  • Field Name: cpe.isSRST
  • Type: Boolean
Is Media Device
  • Field Name: cpe.isMediaDevice
  • Type: Boolean
Is Cube Enterprise
  • Field Name: cpe.isCubeEnterprise
  • Type: Boolean
Description
  • Field Name: cpe.description
  • Type: String
  • MaxLength: 152
CUOM
  • Field Name: cpe.cUOM
  • Type: String
  • Target: data/HCSHcmfCUOMDAT
  • MaxLength: 1024
  • Format: uri
Cluster
  • Field Name: cpe.cluster
  • Type: String
  • Target: data/HCSHcmfClusterDAT
  • MaxLength: 1024
  • Format: uri
Customer Location *
  • Field Name: cpe.customerLocation
  • Type: String
  • Target: data/HCSHcmfCustomerLocationDAT
  • MaxLength: 1024
  • Format: uri
Monitors Prime Collab
  • Field Name: cpe.monitorsPrimeCollab
  • Type: String
  • Target: data/HCSHcmfPrimeCollabDAT
  • MaxLength: 1024
  • Format: uri
Credentials
  • Field Name: credentials.[n]
  • Type: Array
Description
  • Field Name: cpe.credentials.[n].description
  • Type: String
  • MaxLength: 128
Type Credential *
  • Field Name: cpe.credentials.[n].typeCredential
  • Type: String
  • MaxLength: 1024
  • Choices: ["SNMP_V1", "SNMP_V2", "SNMP_V3", "ADMIN", "PLATFORM", "WMI", "IOS_ENABLE", "HTTP", "CLI", "OPERATOR", "SFTP", "JTAPI"]
User ID
  • Field Name: cpe.credentials.[n].userID
  • Type: String
  • MaxLength: 256
Password Community String
  • Field Name: cpe.credentials.[n].password_CommunityString
  • Type: String
  • Is Password: True
  • Store Encrypted: True
  • MaxLength: 512
Type SNMP Access Default: RO
  • Field Name: cpe.credentials.[n].typeSNMPAccess
  • Type: String
  • Default: RO
  • MaxLength: 1024
  • Choices: ["RO", "RW"]
Network Addresses
  • Field Name: networkAddresses.[n]
  • Type: Array
Type Address Space *
  • Field Name: cpe.networkAddresses.[n].typeAddressSpace
  • Type: String
  • MaxLength: 1024
  • Choices: ["APPLICATION_SPACE", "SERVICE_PROVIDER_SPACE", "CUSTOMER_SPACE"]
Description
  • Field Name: cpe.networkAddresses.[n].description
  • Type: String
  • MaxLength: 128
IP Addr V4
  • Field Name: cpe.networkAddresses.[n].iPAddrV4
  • Type: String
  • MaxLength: 64
IP Addr V6
  • Field Name: cpe.networkAddresses.[n].iPAddrV6
  • Type: String
  • MaxLength: 64
Host Short Name Only
  • Field Name: cpe.networkAddresses.[n].hostShortNameOnly
  • Type: String
  • MaxLength: 128
Domain
  • Field Name: cpe.networkAddresses.[n].domain
  • Type: String
  • MaxLength: 128
Is SRV Address *
  • Field Name: cpe.networkAddresses.[n].isSRVAddress
  • Type: Boolean
Bk Customer Short Name
  • Field Name: cpe.bkCustomer_shortName
  • Type: String
  • Target: data/HCSHcmfCustomerDAT
  • Target attr: shortName
  • MaxLength: 1024
  • Format: uri
Bk Customer Location Short Name
  • Field Name: cpe.bkCustomerLocation_shortName
  • Type: String
  • Target: data/HCSHcmfCustomerLocationDAT
  • Target attr: shortName
  • MaxLength: 1024
  • Format: uri
API reference for relation/HcsIOSDeviceREL