Rate and give feedback:  Feedback Received. Thank You!

Rate and give feedback: 

X

This document helped resolve my issue

Yes No

Additional Comments

800 characters remaining

May we contact you if necessary?

Name:  

E-mail: 

Enter a valid Email ID

Need product assistance? Contact Juniper Support

Submit

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.

English  

English

Example: Using the NETCONF Java Toolkit to Execute an Operational Request RPC

Requirements

• NETCONF Java toolkit is installed on the configuration management server.
• Client application can log in to the device where the NETCONF server resides.
• NETCONF service over SSH is enabled on the device where the NETCONF server resides.

Overview

You can use the NETCONF Java toolkit to request operational information from a remote device. The following example illustrates how to create a NETCONF Java toolkit program to execute an operational request from the Junos XML API on a device running Junos OS. The example also explains how to compile the code, execute the program, and verify the results.

Configuration

Creating the Java Program

Step-by-Step Procedure

1. Give the file a descriptive name.

   The filename must be the same as the class name. For this example, the file and class are named GetChassisInventory.

2. Include the appropriate import statements, and the code for the class declaration and the Java method, main().

   import java.io.IOException;
   import javax.xml.parsers.ParserConfigurationException;
   import net.juniper.netconf.Device;
   import net.juniper.netconf.NetconfException;
   import net.juniper.netconf.XML;
   import org.xml.sax.SAXException;
   
   public class GetChassisInventory {
       public static void main(String args[]) throws NetconfException, 
                 ParserConfigurationException, SAXException, IOException {
       }
   }

3. Within main(), create a Device object and call the connect() method.

   This creates a default NETCONF session over SSHv2 with the NETCONF server. You must update the code with the appropriate arguments for connection to and authentication on your specific device.

   Device device = new Device("10.10.1.1", "admin", "PaSsWoRd", null);
   device.connect();
   

   Having established a Device object, you can perform NETCONF operations on the device. For a complete list of available methods corresponding to NETCONF operations, refer to the NETCONF Java toolkit Javadocs.

4. Call the executeRPC() method with the operational request RPC command as the argument.

   This example uses the Junos XML API get-chassis-inventory RPC. The reply, which is returned in XML, is stored in the rpc_reply variable.

   XML rpc_reply = device.executeRPC(“get-chassis-inventory”);
   

5. Add code to take action on the RPC reply.

   The following code converts the NETCONF server’s reply to a string and prints it to the screen:

   System.out.println(rpc_reply.toString());

6. Close the device and release resources by calling the close() method on the device object.

   device.close();

Results

/*GetChassisInventory*/
import java.io.IOException;
import javax.xml.parsers.ParserConfigurationException;
import net.juniper.netconf.Device;
import net.juniper.netconf.NetconfException;
import net.juniper.netconf.XML;
import org.xml.sax.SAXException;

public class GetChassisInventory {
    public static void main(String args[]) throws NetconfException, 
              ParserConfigurationException, SAXException, IOException {
        
        Device device = new Device("10.10.1.1","admin","PaSsWoRd",null);
        device.connect();
        XML rpc_reply = device.executeRPC("get-chassis-inventory");
        System.out.println(rpc_reply.toString());
        device.close();
    }
}

Compiling and Running the Java Program

Step-by-Step Procedure

1. Compile the GetChassisInventory.java file.
   >javac GetChassisInventory.java
2. Execute the resulting GetChassisInventory program.
   >java GetChassisInventory

Verification

Verifying Program Execution

Purpose

Verify that the GetChassisInventory program runs correctly.

Action

If the program executes successfully, it establishes a connection and a creates a NETCONF session with the specified device. The program sends the get-chassis-inventory RPC to the NETCONF server, and the server responds with the requested operational information enclosed in the <rpc-reply> tag element. The program prints the reply to standard out. Following is a sample RPC reply with some output omitted for brevity.

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" 
     xmlns:junos="http://xml.juniper.net/junos/11.2R1/junos">
<chassis-inventory xmlns="http://xml.juniper.net/junos/11.2R1/junos-chassis">
<chassis junos:style="inventory">
<name>Chassis</name>
<serial-number>12345</serial-number>
<description>M7i</description>
<chassis-module>
 
...output omitted...
 
</chassis>
</chassis-inventory>
</rpc-reply>

Troubleshooting

• Troubleshooting NETCONF Exceptions

Troubleshooting NETCONF Exceptions

Problem

A NETCONF exception occurs, and you see the following error message:

Exception in thread "main" net.juniper.netconf.NetconfException: There was a problem while connecting to 10.10.1.1:830
        at net.juniper.netconf.Device.createNetconfSession(Device.java:344)
        at net.juniper.netconf.Device.connect(Device.java:225)
        at GetChassisInventory.main(GetChassisInventory.java:14)

NETCONF over SSH might not be enabled on the device where the NETCONF server resides, or it might be enabled on a different port.

Solution

Ensure that you have enabled NETCONF over SSH on the device where the NETCONF server resides. Since the example program does not specify a specific port number in the Device arguments, the NETCONF session is established on the default NETCONF-over-SSH port, 830. To verify whether NETCONF over SSH is enabled on the default port for a device running Junos OS, enter the following operational mode command on the remote device:

ftp;
netconf {
    ssh;
}

If the netconf configuration hierarchy is absent, issue the following statements in configuration mode to enable NETCONF over SSH on the default port:

netconf {
    ssh {
        port 12345;
    }
}

Device device = new Device("10.10.1.1", "admin", "PaSsWoRd", null, 12345);