Contents

Using Python· 1

Entering the Python shell 1

Executing a Python script 1

Python usage example· 1

Network requirements· 1

Usage procedure· 1

Verifying the configuration· 2

Comware 7 extended Python API 0

Importing and using the Comware 7 extended Python API 0

Comware 7 extended Python API functions· 0

CLI class· 0

Transfer class· 2

API get_self_slot 3

API get_standby_slot 3

API get_slot_range· 4

API get_slot_info· 4

 

Using Python

Comware 7 provides a built-in Python interpreter that supports the following items:

·     Python 2.7 commands.

·     Python 2.7 standard API.

·     Comware 7 extended API. For more information about the Comware 7 extended API, see "Comware 7 extended Python API."

·     Python scripts. You can use a Python script to configure the system.

Entering the Python shell

To use Python commands and APIs, you must enter the Python shell.

 

Task	Command
Enter the Python shell from user view.	python

 

Executing a Python script

Execute a Python script in user view.

 

Task	Command
Execute a Python script.	python filename

 

Python usage example

Network requirements

Use a Python script to perform the following tasks:

·     Download configuration files main.cfg and backup.cfg to the device.

·     Configure the files as the main and backup configuration files for the next startup.

Figure 1 Network diagram

 

Usage procedure

# Use a text editor on the PC to edit Python script test.py as follows:

#!usr/bin/python

import comware

 

comware.Transfer('tftp', '192.168.1.26', 'main.cfg', 'cfa0:/main.cfg')

comware.Transfer('tftp', '192.168.1.26', 'backup.cfg', 'cfa0:/backup.cfg')

comware.CLI('startup saved-configuration cfa0:/main.cfg main ;startup saved-configuration cfa0:/backup.cfg backup')

# Use TFTP to download the script to the device.

<Sysname> tftp 192.168.1.26 get test.py

# Execute the script.

<Sysname> python cfa0:/test.py

<Sysname>startup saved-configuration cfa0:/main.cfg main

Please wait...... Done.

<Sysname>startup saved-configuration cfa0:/backup.cfg backup

Please wait...... Done.

Verifying the configuration

# Display startup configuration files.

<Sysname> display startup

 Current startup saved-configuration file: cfa0:/startup.cfg

 Next main startup saved-configuration file: cfa0:/main.cfg

 Next backup startup saved-configuration file: cfa0:/backup.cfg

Comware 7 extended Python API

The Comware 7 extended Python API is compatible with the Python syntax.

Importing and using the Comware 7 extended Python API

To use the Comware 7 extended Python API, you must import the API to Python.

Use either of the following methods to import and use the Comware 7 extended Python API:

·     Use import comware to import the entire API and use comware.API to execute an API.

For example, to use the extended API Transfer to download the test.cfg file from TFTP server 192.168.1.26:

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.Transfer('tftp', '192.168.1.26', 'test.cfg', 'cfa0:/test.cfg', user='', password='')

<comware.Transfer object at 0x37e2a0e0>

·     Use from comware import API to import an API and use API to execute the API.

For example, to use the extended API Transfer to download the test.cfg file from TFTP server 192.168.1.26:

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> from comware import Transfer

>>> Transfer('tftp', '192.168.1.26', 'test.cfg', 'cfa0:/test.cfg', user='', password='')

<comware.Transfer object at 0x37e2a090>

Comware 7 extended Python API functions

CLI class

CLI

Use CLI to execute Comware 7 CLI commands and create CLI objects.

Syntax

CLI(command=‘’, do_print=True)

Parameters

command: Specifies the commands to be executed. To enter multiple commands, use a space and a semicolon (;) as the delimiter. To enter a command in a view other than user view, you must first enter the commands used to enter the view. For example, you must enter ’system-view ;local-user test class manage’ to execute the local-user test class manage command.

do_print: Specifies whether to output the execution result:

·     True—Outputs the execution result. This value is the default.

·     False—Does not output the execution result.

Usage guidelines

This API supports only Comware commands. It does not support Linux, Python, or Tcl commands.

Returns

CLI objects

Examples

# Add a local user with the username test.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.CLI('system-view ;local-user test class manage')

Sample output

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] local-user test class manage

New local user added.

<comware.CLI object at 0x37e2a0e0>

get_output

Use get_output to get the output from executed commands.

Syntax

CLI.get_output()

Returns

Output from executed commands

Examples

# Add a local user and get the output from the command.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> c = comware.CLI('system-view ;local-user test class manage', False)

>>> c.get_output()

Sample output

['<Sysname>system-view', 'System View: return to User View with Ctrl+Z.', '[Sysname]local-user test class manage', 'New local user added.']

Transfer class

Transfer

Use Transfer to download a file from a server.

Syntax

Transfer(protocol=‘’, host=‘’, source=‘’, dest=‘’, vrf=‘’,login_timeout=10, user=‘’, password=‘’)

Parameters

protocol: Specifies the protocol used to download a file:

·     ftp—Uses FTP.

·     tftp—Uses TFTP.

host: Specifies the IP address of the remote server.

source: Specifies the name of the file to be downloaded from the remote server.

dest: Specifies a name for the downloaded file.

vrf: Specifies the VPN instance to which the remote server belongs. This argument is a case-sensitive string of 1 to 31 characters. If the server belongs to the public network, do not specify this argument.

login_timeout: Specifies the timeout for the operation, in seconds. The default is 10.

user: Specifies the username for logging in to the server.

password: Specifies the login password.

Returns

Transfer object

Examples

# Download the test.cfg file from TFTP server 192.168.1.26.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.Transfer('tftp', '192.168.1.26', 'test.cfg', 'cfa0:/test.cfg', user='', password='')

Sample output

<comware.CLI object at 0x37e2a0e0>

get_error

Use get_error to get the error information from the download operation.

Syntax

Transfer.get_error()

Returns

Error information (if there is no error information, None is returned)

Examples

# Download the test.cfg file from TFTP server 1.1.1.1 and get the error information from the operation.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> c = comware.Transfer('tftp', '1.1.1.1', 'test.cfg', 'cfa0:/test.cfg', user='', password='')

>>> c.get_error()

Sample output

'Timeout was reached'

API get_self_slot

get_self_slot

Use get_self_slot to get the slot number of the device. (In standalone mode.)

Use get_self_slot to get the member ID of the master device. (In IRF mode.)

Syntax

get_self_slot()

Returns

A list object in the format of [-1,slot-number]. The slot-number is fixed at 0. (In standalone mode.)

A list object in the format of [chassis-number,slot-number]. The chassis-number argument indicates the member ID of the master device. The slot-number argument is fixed at 0. (In IRF mode.)

Examples

# Get the member ID of the device.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.get_self_slot()

Sample output

[-1,0]

API get_standby_slot

get_standby_slot

Use get_standby_slot to get the slot number of the device. (In standalone mode.)

Use get_standby_slot to get the member IDs of the subordinate devices. (In IRF mode.)

Syntax

get_standby_slot()

Returns

 A list object in the format of [[-1,slot-number]]. The slot-number is fixed at 0. (In standalone mode.)

A list object in one of the following formats:

·     [ ]—The IRF fabric does not have a global standby MPU.

·     [[chassis-number,slot-number]]—The IRF fabric has only one member device.

·     [[chassis-number1,slot-number1],[chassis-number2,slot-number2],…]—The IRF fabric has multiple member devices.

The chassis-number arguments indicate the device member ID. The slot-number arguments are fixed at 0. (In IRF mode.)

Examples

# Get the slot number of the suborinate devices.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.get_standby_slot()

Sample output

[]

API get_slot_range

get_slot_range

Use get_slot_range to get the supported slot number range.

Syntax

get_slot_range()

Returns

A dictionary object in the format of {'MaxSlot': max-slot-number, 'MinSlot': min-slot-number }. The max-slot-number argument indicates the maximum slot number. The min-slot-number argument indicates the minimum slot number.

Examples

# Get the supported slot number range.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware. get_slot_range()

Sample output

{'MaxSlot': 19, 'MinSlot': 0}

API get_slot_info

get_slot_info

Use get_slot_info to get information about a card or device.

Syntax

get_slot_info()

Returns

A dictionary object in the format of {'Slot': slot-number, 'Status': 'status', 'Chassis': chassis-number, 'Role': 'role', 'Cpu': CPU-number }. The slot-number argument indicates the slot number. The status argument indicates the status of the card or device. The chassis-number argument indicates the member ID of the device. The role argument indicates the role of the card or device. The CPU-number argument indicates the ID of the main CPU on the card or device.

Examples

# Get information about a slot.

<Sysname> python

Python 2.7.3 (default)

[GCC 4.4.1] on linux2

Type "help", "copyright", "credits" or "license" for more information.

>>> import comware

>>> comware.get_slot_info(1)

Sample output

{'Slot': 1, 'Status': 'Normal', 'Chassis': 0, 'Role': 'Master', 'Cpu': 0}