=====本地或远程管理和控制Digi联网设备=====
管理联网的设备，首先是用Digi Remote Manager，通过它也可以实现私网的路由器管理。许多用户仍执着于本地接口的监控和管理，这虽然有一定意义，但如果是SIM卡发卡方的原因或是物理因素，这最多也只是记录log的手段而已。
虽然Digi可以提供方式，让SIM卡未正常连上网络时有了调试手段，但在阅读本文之前，请先了解：
1、Digi和北美欧洲运营商有全面的合作关系，您也可以通过Digi来获取北美或欧洲运营商的SIM卡，通过这种方式可避免因开卡问题引发的部署联网问题。
2、Digi有集中管理平台包括Digi Remote Manager设备云和On-Prem Manager本地管理软件，它们都可以支持私网SIM卡的管理，并且对IT管理非常友好，同时，DRM还支持通过API查询运营商的SIM卡状态和消费的流量信息
3、Digi路由器也支持SNMP软件来管理和配置SIM卡
4、Digi路由器支持通过ssh连接和执行相关的命令行，查询和设置SIM卡的连网情况，本功能可通过python或Java来实现程序接口而非交互式访问。
5、Digi的本地Web接口可对接口部分进行配置和查询
上面详述了Digi的路由器功能，通常出海企业最优的选择是通过Digi Remote Manager来远程管理设备，这也是最方便，最安全，功能最全的方式。
====通过Digi Remote Manager的API获取LTE连网信息====
虽然可以通过平台可视化地获取或配置相关信息，但如果是程序或自建管理平台需要的话，可以用API方式来实现相关的功能。
登陆到Digi Remote Manager后，点击右上角的配置齿轮图标，打开经典配置界面，然后点Documentation>API Explorer，在这里，您可以测试API功能，并导出相关例程，包括Java的支持。
点击SCI Target，从下拉窗口中添加您要测试的在线设备，然后在Example里选择v1/reports/devices/carrier，点击Send（首次使用会要求输入用户名和密码），就会向你的设备通过DRM发起一次Web请求，并返回相关的蜂窝网络连接信息。
{{:digi:cellular-router:pasted:20241120-165456.png}}
点击Export，选择Java，就可以生成这个web service请求的例程，把它复制保存下来以备用：
#其它API请修改id和insatll_code对应那两行
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import javax.net.ssl.HttpsURLConnection;
import java.net.URL;
import java.util.Scanner;
/* Can replace this with any base 64 encoder for basic authentication. For java 6
* installations on Sun's JRE you can use "sun.misc.BASE64Encoder" however this will
* not work in some installations (using OpenJDK). Java mail
* (javax.mail.internet.MimeUtility) also contains a Base 64 encoder in Java 6. A
* public domain version exists at http://iharder.sourceforge.net/current/java/base64/
*/
import org.apache.commons.codec.binary.Base64;
/**
* This is a stub class with a main method to run a Remote Manager web service.
*/
public class WebServiceRequest {
private static final String username = "username"; // put your Remote Manager username here
private static final String password = "password"; // put your Remote Manager password here
/**
* Run the web service request
*/
public static void main(String[] args) {
HttpsURLConnection conn = null;
try {
// Create url to the Remote Manager server for a given web service request
URL url = new URL("https://remotemanager.digi.com/ws/v1/reports/devices/carrier");
conn = (HttpsURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setRequestMethod("GET");
// Build authentication string
String userpassword = username + ":" + password;
// can change this to use a different base64 encoder
String encodedAuthorization = Base64.encodeBase64String(userpassword.getBytes()).trim();
// set request headers
conn.setRequestProperty("Authorization", "Basic "
+ encodedAuthorization);
// Get input stream from response and convert to String
InputStream is = conn.getInputStream();
Scanner isScanner = new Scanner(is);
StringBuffer buf = new StringBuffer();
while (isScanner.hasNextLine()) {
buf.append(isScanner.nextLine() + "\n");
}
String responseContent = buf.toString();
// add line returns between tags to make it a bit more readable
responseContent = responseContent.replaceAll("><", ">\n<");
// Output response to standard out
System.out.println(responseContent);
} catch (Exception e) {
// Print any exceptions that occur
e.printStackTrace();
} finally {
if (conn != null)
conn.disconnect();
}
}
}
注意，我们只需改变URL url = new URL("https://remotemanager.digi.com/ws/v1/reports/devices/carrier"); 中的URL地址，就可以实现任意的http的请求。
同样的道理，选择请求类型为POST时，我们就获取到了相关的例程。
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import javax.net.ssl.HttpsURLConnection;
import java.net.URL;
import java.util.Scanner;
/* Can replace this with any base 64 encoder for basic authentication. For java 6
* installations on Sun's JRE you can use "sun.misc.BASE64Encoder" however this will
* not work in some installations (using OpenJDK). Java mail
* (javax.mail.internet.MimeUtility) also contains a Base 64 encoder in Java 6. A
* public domain version exists at http://iharder.sourceforge.net/current/java/base64/
*/
import org.apache.commons.codec.binary.Base64;
/**
* This is a stub class with a main method to run a Remote Manager web service.
*/
public class WebServiceRequest {
private static final String username = "username"; // put your Remote Manager username here
private static final String password = "password"; // put your Remote Manager password here
/**
* Run the web service request
*/
public static void main(String[] args) {
HttpsURLConnection conn = null;
try {
// Create url to the Remote Manager server for a given web service request
URL url = new URL("https://remotemanager.digi.com/ws/v1/devices/inventory");
conn = (HttpsURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setRequestMethod("POST");
// Build authentication string
String userpassword = username + ":" + password;
// can change this to use a different base64 encoder
String encodedAuthorization = Base64.encodeBase64String(userpassword.getBytes()).trim();
// set request headers
conn.setRequestProperty("Authorization", "Basic "
+ encodedAuthorization);
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("Accept", "application/json");
// Send data to server
OutputStreamWriter out = new OutputStreamWriter(conn.getOutputStream());
out.write("{\r\n");
out.write(" \"id\": \"00000000-00000000-00000000-00000000\",\r\n");
out.write(" \"install_code\": \"myInstallCode\"\r\n");
out.write("}\r\n");
out.close();
// Get input stream from response and convert to String
InputStream is = conn.getInputStream();
Scanner isScanner = new Scanner(is);
StringBuffer buf = new StringBuffer();
while (isScanner.hasNextLine()) {
buf.append(isScanner.nextLine() + "\n");
}
String responseContent = buf.toString();
// add line returns between tags to make it a bit more readable
responseContent = responseContent.replaceAll("><", ">\n<");
// Output response to standard out
System.out.println(responseContent);
} catch (Exception e) {
// Print any exceptions that occur
e.printStackTrace();
} finally {
if (conn != null)
conn.disconnect();
}
}
}
由于经典界面的例程不够多，下面我们回到当前DRM界面，在Example里选择V1/network_interfaces，发起post请求，便可以获取相关的SIM卡信息。
{{:digi:cellular-router:pasted:20241120-171641.png}}
此外，在经典界面下，执行SCI>RCI的例程，也可从Query Device Setting或Status命令中获取更多有用的状态或配置信息。
用这种办法几乎可以获取路由器的任意信息，包括log的调试信息，因此非常方便。
高阶的功能包括执行设备所支持的CLI命令，甚至也可以是一个自定义python脚本命令和返值值，通过云端触发后，在本地执行，并按需返回相关参数。
比如像SIM卡DHCP自动获取的IP地址等信息，通常没必要在本地接口获取，但也是可以实现的，它可以通过SCI>CLI>Send a single Command获取，也就是发送show network命令并返回相关结果。
Java 例程代码:
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import javax.net.ssl.HttpsURLConnection;
import java.net.URL;
import java.util.Scanner;
/* Can replace this with any base 64 encoder for basic authentication. For java 6
* installations on Sun's JRE you can use "sun.misc.BASE64Encoder" however this will
* not work in some installations (using OpenJDK). Java mail
* (javax.mail.internet.MimeUtility) also contains a Base 64 encoder in Java 6. A
* public domain version exists at http://iharder.sourceforge.net/current/java/base64/
*/
import org.apache.commons.codec.binary.Base64;
/**
* This is a stub class with a main method to run a Remote Manager web service.
*/
public class WebServiceRequest {
private static final String username = "username"; // put your Remote Manager username here
private static final String password = "password"; // put your Remote Manager password here
/**
* Run the web service request
*/
public static void main(String[] args) {
HttpsURLConnection conn = null;
try {
// Create url to the Remote Manager server for a given web service request
URL url = new URL("https://remotemanager.digi.com/ws/sci");
conn = (HttpsURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setRequestMethod("POST");
// Build authentication string
String userpassword = username + ":" + password;
// can change this to use a different base64 encoder
String encodedAuthorization = Base64.encodeBase64String(userpassword.getBytes()).trim();
// set request headers
conn.setRequestProperty("Authorization", "Basic "
+ encodedAuthorization);
conn.setRequestProperty("Content-Type", "text/xml");
conn.setRequestProperty("Accept", "text/xml");
// Send data to server
OutputStreamWriter out = new OutputStreamWriter(conn.getOutputStream());
out.write(" \r\n");
out.write(" \r\n");
out.write(" \r\n");
out.write(" \r\n");
out.write(" \r\n");
out.write(" show network\r\n");
out.write(" \r\n");
out.write(" \r\n");
out.write("\r\n");
out.close();
// Get input stream from response and convert to String
InputStream is = conn.getInputStream();
Scanner isScanner = new Scanner(is);
StringBuffer buf = new StringBuffer();
while (isScanner.hasNextLine()) {
buf.append(isScanner.nextLine() + "\n");
}
String responseContent = buf.toString();
// add line returns between tags to make it a bit more readable
responseContent = responseContent.replaceAll("><", ">\n<");
// Output response to standard out
System.out.println(responseContent);
} catch (Exception e) {
// Print any exceptions that occur
e.printStackTrace();
} finally {
if (conn != null)
conn.disconnect();
}
}
}
{{:digi:cellular-router:pasted:20241120-175451.png}}
注意，获取到的值为BASE64，需转码为ASCII即可，如本例转码后：
{{:digi:cellular-router:pasted:20241120-180308.png}}
====通过本地REST接口或SNMP接口设置和获取相关信息====
SNMP能实现大部分功能，包括读取SIM卡信息等，SNMP协议比较复杂，一般专业的网络管理软件支持SNMP协议来管理网络设备。详情请[[https://www.digi.com/resources/documentation/digidocs/90002537/#os/services-snmp-c.htm|参考文档]]
REST API可以用于读取和设置部分信息，但并不支持读取Modem的相关配置，它的用法详见：[[digi:cellular-router:dal-restful|使用本地基于Web的REST API 来配置DAL设备]]
要在本地使用完整功能，一般是可通过Python和Java来ssh到路由器设备并获取相关的CLI信息，这个方法和同DRM的API相比较为不方便，因为它不像DRM可以精细化的直接得到Json键值对，而是需要通过对seesion中命令的输出来提取相关信息。这里是一些示例，比如使用python或java来获取CLI的输出：
{{:digi:cellular-router:pasted:20241120-185116.png}}
一、python的方式
确保你安装了paramiko库。如果你还没有安装，可以使用以下命令安装：
pip install paramiko
以下是:
import paramiko
import time
# 连接参数
hostname = 'your.server.com'
username = 'your_username'
password = 'your_password'
# 创建SSH对象
ssh = paramiko.SSHClient()
# 自动添加策略，保存服务器的主机名和密钥信息
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
# 连接服务器
ssh.connect(hostname, username=username, password=password)
# 打开一个Channel并获取一个交互式shell
channel = ssh.invoke_shell()
# 等待shell初始化
time.sleep(1)
# 发送交互字符并回车
channel.send('a\n')
# 等待交互字符被处理
time.sleep(1)
# 发送命令并回车
channel.send('show network\n')
# 获取命令输出
time.sleep(1) # 等待命令执行完成
output = channel.recv(65535).decode('utf-8')
# 打印输出
print(output)
# 关闭连接
channel.close()
ssh.close()
二、Java的实现方式
在Java中，你可以使用JSch库来实现SSH连接并执行命令，然后获取命令的执行结果。以下是一个简单的示例，演示如何使用JSch库来实现这一功能。
import com.jcraft.jsch.*;
import java.io.InputStream;
public class JSchExample {
public static void main(String[] args) {
String host = "your.server.com";
String user = "your_username";
String password = "your_password";
try {
JSch jsch = new JSch();
Session session = jsch.getSession(user, host, 22);
session.setPassword(password);
java.util.Properties config = new java.util.Properties();
config.put("StrictHostKeyChecking", "no");
session.setConfig(config);
session.connect();
Channel channel = session.openChannel("shell");
((ChannelShell) channel).setPty(true);
InputStream in = channel.getInputStream();
channel.connect();
// Wait for the initial prompt (adjust the sleep time as necessary)
Thread.sleep(2000);
// Send the interactive character followed by a newline
String interactiveChar = "a\n";
sendCommand(channel, interactiveChar);
// Wait for the server to process the interactive character
Thread.sleep(1000);
// Send the 'show network' command followed by a newline
String command = "show network\n";
sendCommand(channel, command);
// Read the output of the 'show network' command
String output = readOutput(in);
System.out.println("Command output:\n" + output);
channel.disconnect();
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
private static void sendCommand(Channel channel, String command) throws Exception {
OutputStream out = channel.getOutputStream();
out.write(command.getBytes());
out.flush();
}
private static String readOutput(InputStream in) throws Exception {
byte[] buffer = new byte[1024];
StringBuilder output = new StringBuilder();
int readCount;
while ((readCount = in.read(buffer)) != -1) {
output.append(new String(buffer, 0, readCount));
if (output.toString().contains("username@hostname:~$")) { // Adjust the end of output marker as necessary
break;
}
}
return output.toString();
}
}
在这个代码示例中，sendCommand 方法用于发送命令到服务器，而 readOutput 方法用于读取命令的输出。请注意，你可能需要根据服务器的实际响应来调整 readOutput 方法中的结束标记，以便正确地捕获命令的输出。