[Index]

Model: relation/HcsIOSDeviceREL

IOS Devices

Full HTML Help

In VOSS Automate, you can set up IOS devices such as SIP Local Gateways and Analog Gateways. And you can set up Command Builders to generate the appropriate IOS commands, which allow you to copy to the IOS device CLI.

Related Topics

Command Builders in the Core Feature Guide

IOS Device Management Workflow

This section outlines a possible workflow for setting up Local Break Out (LBO) using a SIP Local Gateway. This workflow copies IOS commands to the IOS device CLI after each step. Alternatively, you can use the consolidate commands tool to create one set of IOS commands to run all at once.

Perform these steps:

  1. Create customized Command Builders for events. Either add new ones, or clone the default ones and update the clones. See Set up a Command Builder or Clone a Command Builder.
  2. Add an IOS device at customer hierarchy level. See Set up an IOS Device.
  3. View the IOS Commands log and copy commands to the IOS device CLI. See View IOS Commands Log.
  4. Add SIP Local Gateways at customer hierarchy level. See:

Set up SIP Local Gateway in the Core Feature Guide

  1. View the IOS Commands log and copy commands to the IOS device CLI. See View IOS Commands Log.
  2. Perform manual configuration on the SIP Local Gateway. See IOS Gateway Manual Configuration.
  3. Associate SIP Local Gateways to sites. See:

Associate / Disassociate SIP Local Gateway to a Site in the Core Feature Guide

  1. View the IOS Commands log and copy commands to the IOS device CLI. See View IOS Commands Log.
  2. Create E.164 Associations. See:

Associate a Set of E164 Numbers to One Internal Number in the Core Feature Guide

Associate a Range of E164 Numbers to a Range of Internal Numbers in the Core Feature Guide

  1. View the IOS Commands log and copy commands to the IOS device CLI. See View IOS Commands Log.

Set up an IOS Device

Full HTML Help

  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. Go to (default menus) Apps 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.
  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.

    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: relation/HcsIOSDeviceREL

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: /api/data/HCSHcmfCUOMDAT/choices/?format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%241UjEhXsNatQgmODE%24qupHYIts0qew2kbmhJL2BtUerYiiBGnNDmUVAVHsUUBU7Lpj/4gLYXY6XJhOZcXBVJM6aj2%2BnED0kfaQ6meQBycZFsLtEMAM9GyUQ/T0K/IEGpxKHoauRTsVzRcg24aWO8Kw1uXFTlVqNy8KW6%2BgYyH1PKEybYbxG7P7OqOy%2BUp5UF3iDmdX7rA%2B7QrFjXMx2IJcHQkwiha%2BRNoq56SoHJOjKt4OAffw1FOeDCIz17gXksqckiOt/kmfI3X7DWOk%2B0rweZSrn0thewTfGE%2BtA9K7gcvqyYsoUZSwB19U896zWh540287Klxx3fVV3Ir6eeS/JsFjb850nOTxearmzztFRuiN3/tiRg9ekTu%2BLkYhsaNwRvqs7dlmwxn9mhHKJhAAhTSiw5/xwhXQeKYkG2hHokN2qq3UwVjRJG3gq%2Bisc3NdrGUt8TLVTu9egQNm3Ryj6xr967RNPHehsXLdXubAe5MvPvQENvziZCFGcjXc%2BIh7Dw%3D%3D%24%3D%3D
  • Target Model Type: data/HCSHcmfCUOMDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []
Cluster
  • Field Name: cpe.cluster
  • Type: String
  • Target: /api/data/HCSHcmfClusterDAT/choices/?format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%24oSxFAZAZD0qzZGw5%240z7kmVCACbxw/9iQirDV94n7mV8wMPVdB31VDNiVloS8X2RGdhZHOlNNmhuZ7jgHRdVg/RIwcY9qqAHTg9RKvCUgWDIm%2BVrSeQeEPT9PQNF3hkj58ExQpdJ9GnAds5mZO2XK/70xIggaY4kkTcnaOPe8mZib2CMre2lvqKposv9LLVDucDhNxoZQtzUhdRZxAtwvCctO%2Bp0Dm6cVrDopyzBdQOPR3EZ/bcgFDKCcQSttXOE9NNel74IpZyMBKvpM43CRXnhdB2FCfWvFP5kds0ACBd6uHEMBBz6MgJ/l9Qlj307zZU6TXwvuLSAfKfxQY6We14Loe/rPYQmLBvOeIlRso/ddMCcb8Web60sMMpRHlLpU2uviFes0gTBSN3m1I2B2sRFy73A1FtW/6sK4A5FNLdkxrkfps9Q5IxN82/vG8vM0MhZbvbQGAI7Jq9qagtK6iRlwh3hVfz1H2uuHNUHeQl1k0c6qO%2B43wzZTMOozJWwlQzaIcw%3D%3D%24%3D%3D
  • Target Model Type: data/HCSHcmfClusterDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []
Customer Location *
  • Field Name: cpe.customerLocation
  • Type: String
  • Target: /api/data/HCSHcmfCustomerLocationDAT/choices/?format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%24Qz8O1MIcVcfbYYZS%24p4JW5g1qFYN6PFcTz%2Bppj7SlmuMcI27W%2BdWtEdklsiX17FMehc/auxb/8HojcbNHb00GiY%2B/fV/BGZFUF17mMsvDWT%2Bpz3NJak7CDtvAGzQepqoG5a%2BdfKZpxlxSQWwgxubLMdc87lvJCcpisMSY6znVjWk0itnjCzcZrwYdn9ZiTW3o8VdfM/lrV7p83d76oHgRMFnxgRAV3Ft%2BE4wPx/GbSkflbys%2BF9uKJ/aopIZSqFZN4U83C9euuGnH8IbTepdfumNg9a3IuMzClJebxKALhzG/OQytPZEE7mEbtCPXmDoLhCkHSY4snJBTrKQLT%2BFqgPvQBfzj/QfjZRW2Rm9AcpJjwmEEPK/kjUE6IM51zCvPkI0QjVJuPdjtHZFgsTMPJNyBv/2ndR/F2giKjOCL89TRer5y8VmRlmTcjgRINX4C5voF6vxqBRFVvWLb0SMXxk5m7Szb7jtTXavxtImuE1wSisJcMOmwDz1%2BV7Qh8MHXJtkPjZD57LOQ2fTO6g%3D%3D%24%3D%3D
  • Target Model Type: data/HCSHcmfCustomerLocationDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []
Monitors Prime Collab
  • Field Name: cpe.monitorsPrimeCollab
  • Type: String
  • Target: /api/data/HCSHcmfPrimeCollabDAT/choices/?format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%24I4i2TcFp1YnHcmaX%24v%2Bbzxrqu7B8mA8Fz5M9%2BKqwaw5FhKRYzjs4AO3WxWSm%2Bm74QfPVfA2j3OlSsl0713NYBS8oLAUqVo%2BkdEKoOIQZ/YFQcA3CTd6gcxgOezgmyxZBccbaI1j53xXZA9%2BAG9fmsSR1kpYorhGaF6KvHw5rvc6RCLotAahY05s7z9qECIrVM2eV2ltY3vlhiLOoof8vcbladex3lS8RwJjxwO1TI5THJlpyXKtrJ4NoQ03le6xq0HhEA0aZEzih3RU6BN6%2BVh%2BhacPdVOJ9MaVWEs4k9f9QNUIoLS/kWeysT5s2ok6cveq/ehwI1oPhv9AYj11pXQDW%2BKwZ8H8JNPqOT%2BE2MMkmOARvKW9LIIKdM5AyW5hen0djtc70sscOm8HLEqv3hYdStmS/mWvCGVkbNmYb4pGJfRhQPxPUVf1dlvAOFSZqGlu5LlC22hCWzn%2BpsAlYjjp96j8jMxjjfHDEZ3uLgDa6JAH86E8sFvMtCXTfe7IlLUBjv45leVto%3D%24%3D%3D
  • Target Model Type: data/HCSHcmfPrimeCollabDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []
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: /api/data/HCSHcmfCustomerDAT/choices/?field=shortName&format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%24nKqEgcKQfvYMJEmD%24aCjf9gGBWPWQneL/GEEXlBSRxhqQBEcxK1cNwPxZavR6jZDAV07VM29WLDcXOK0u53HM6U4cbSon7akOrKdEBDmpPuHCbzzyzfuAG3kGLwOVVyh/ry4fNNN17br2sqwtJO21QEV2g6p52L2d9F5XQQuaybGHeC0zJuzUg1CdHmvzQ9rRPZn46yc7/oJ13Vrc2UFSZcow7138LrNknq6t99yJmO5p5ePA99d5mEtedINmFin2Zdy/HbBqq3IM7SVqggxXEOnwBc3tbYGba7/Kz7IUop8R8C5ZhanjTBINchyfUgnmQS8t0HpbUeq7kPNGFntczblgySt6ddsYAfPhRwmSpRVFMwQK/5AP0pvlgHKVe9jBFQhHnr0eFoitAnoxhuuzqDZEGZEiJxDPH3acdoshc5wRnHulnU3BJFq%2B0Lqnz5q3vewvNHzz13Bza7Zb4Wwit9bw3ljYcMOSPZP1KvGC9yvolZtUfytVmIcTMhPdoBwy5Y1MjDzsUoiVRBrUEWQ5bq471OTx%24%3D%3D
  • Target attr: shortName
  • Target Model Type: data/HCSHcmfCustomerDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []
Bk Customer Location Short Name
  • Field Name: cpe.bkCustomerLocation_shortName
  • Type: String
  • Target: /api/data/HCSHcmfCustomerLocationDAT/choices/?field=shortName&format=json&hierarchy=[hierarchy]&auth_token=%3D%3D%24wupZyXSSK53m8dgA%24xyGDvwTiXLT2KWWrMNceLPWEWzHhZ8ua%2B03hUsxpyMGjsKFPDbbcMzGBC2496VGIs2Q8yCctl97mOriL3A3deS2wr5EgWbK/TBWqDNVrbkfh2NQFqSEb%2B0zf1mI9Xy7focrM2zSRJX0EHVOLfP2n7yuvZBKaiw/5Nb1a6zKM3OMg7/Iii0vXg3oJD/7TVehd4VTf29GywB9Y49lI1joGzlZa2nz6YMOjNj/iysYLKS/L3OdQnfr01/x3KUJ8MNp/leFzvsfD17LV7PWj33NwzkNUcwmhqfwyoDm%2B0woHUFhJEwuCMc3MI1s/nkBUcKzpVeOMjN/IVggN%2B6WDJv9SUQKXSRbGH983TuCACM7aMd41v71HySNpUEV7nPwswh7ViVl5wjC0bvzYkyY%2Bq69TEcicCQ6nPrTSEX8wI4Sdl6py8aqkcUzq76AeeWjmPAuSSSKeJcGTE6HE1tgoNDQUo0iQpIc0pDwDHQhjYGCeWQ2IqPz%2BM8bt/H2MGw5MxNhxwYeCDRCEU3H%2BlLapK0EB9AE%3D%24%3D%3D
  • Target attr: shortName
  • Target Model Type: data/HCSHcmfCustomerLocationDAT
  • MaxLength: 1024
  • Format: uri
  • Choices: []