View source for Configuring APC SmartUPS with AP9630 Network Cards

{{howto_header}}

This assumes you are on [[EL8]] (CentOS Stream 8 or RHEL 8) with the [[Alteeve M3 Repo]] enabled. More specifically, this assumes that you have the <span class="code">screen</span> installed.

= Serial Access =

[[image:Antaira_UTS-1110A_Top.jpg|thumb|right|400px|Antaira [http://www.antaira.com/products/USB-to-Serial/UTS-1110A UTS-1110A] single-port USB to RS-232] serial adapter. Photo by [http://shopping.netsuite.com/c.685553/site/images/Products/full/uts-1110a_1.jpg Antaira].]]

By default, the APC AP9630 NMC (Network Management Card) does not have an IP address assigned.

The easiest way to configure an IP address is to log into the UPS's NMC  over a [https://en.wikipedia.org/wiki/Serial_port serial] port. Many servers still come with a built-in 9-pin serial port, but most desktops and laptops do not. If you don't have one, many vendors sell USB to serial adapters. The one we've used quite successfully is the [http://www.antaira.com/products/USB-to-Serial/UTS-1110A Antaira UTS-1110A], but almost any adapter you can find at your local computer store will work.

{{note|1=The [[Build an M3 Anvil! Cluster|M3 ''Anvil!'']] installs <span class="code">screen</span> on all machines.}}

We're going to use a program called <span class="code">[http://www.gnu.org/software/screen/ screen]</span> to talk to the PDU over the serial port.

To do this, you need to know what device the PDU's serial cable is plugged into. Some common ones:

{|class="wikitable"
!Type
!Device path
|-
|Serial port 1
|class="code"|/dev/ttyS0
|-
|Serial port 2
|class="code"|/dev/ttyS1
|-
|USB-Connected port 1
|class="code"|/dev/ttyUSB0
|-
|USB-Connected port 2
|class="code"|/dev/ttyUSB1
|}

... and so on.

The [[SMX1500RM2UC]] includes the new [[AP9641]] network card, which provides a serial connection using a micro-USB port. When connected to a machine (typically a Striker), the <span class="code">/dev/ttyACM0</span> device is created. Of course, if that device exists already, <span class="code">ttyACM0</span> will increment to the first free <span class="code">ACMx</span> device number.

Connect:

<syntaxhighlight lang="bash">
screen /dev/ttyACM0
</syntaxhighlight>

== First Connection ==

On the very first connection, you will be prompted to change the password.

<syntaxhighlight lang="text">
User Name : apc
Password  : ***

The current password policy requires you to change your password...

Enter current password: ***

Enter new password: ***
Confirm new password: ***
</syntaxhighlight>

== Main Menu ==

When connecting, enter your password (as set in the initial connection). The default is <span class="code">apc</span>.

<syntaxhighlight lang="text">
User Name : apc
Password  : ***
</syntaxhighlight>

Once authenticated, you will see the main page.

<syntaxhighlight lang="text">
Schneider Electric                      Network Management Card AOS    v1.3.3.1
(c) Copyright 2019 All Rights Reserved  Smart-UPS APP                  v1.3.3.1
-------------------------------------------------------------------------------
Name      : apc605BB0                                 Date : 05/20/2022
Contact   : Unknown                                   Time : 23:56:09
Location  : Unknown                                   User : Super User
Up Time   : 0 Days 6 Hours 43 Minutes                 Stat : P+ N4? N6+ A+
-------------------------------------------------------------------------------
IPv4               : Enabled            IPv6               : Enabled
Ping Response      : Enabled
-------------------------------------------------------------------------------
HTTP               : Disabled           HTTPS              : Enabled
FTP                : Disabled           Telnet             : Disabled
SSH/SCP            : Enabled            SNMPv1             : Disabled
SNMPv3             : Disabled           Modbus TCP         : Disabled
BACnet/IP          : Disabled
-------------------------------------------------------------------------------
Super User         : Enabled            RADIUS             : Disabled
Administrator      : Disabled           Device User        : Disabled
Read-Only User     : Disabled           Network-Only User  : Disabled


Type ? for command listing
Use tcpip command for IP address(-i), subnet(-s), and gateway(-g)

apc>
</syntaxhighlight>

== Set the IP address ==

In this example, we'll set the IP address <span class="code">10.201.3.1</span>, which puts it on the [[Back-Channel Network]].

<syntaxhighlight lang="text">
apc>tcpip -i 10.201.3.7 -s 255.255.0.0   
</syntaxhighlight>
<syntaxhighlight lang="text">
E002: Success
Reboot required for change to take effect.

* Reboot required for change to take effect.
</syntaxhighlight>

<syntaxhighlight lang="text">
apc>reboot -Y
</syntaxhighlight>

The system will now reboot. See '''Problems''' below if it doesn't come back up.

== Enable Web and SMTP Access ==

For use in an '''Anvil!''', we need to enable web and SMTP access. 

Enable http (<span class="code">-h<span>) and https access (<span class="code">-s<span>);

<syntaxhighlight lang="text">
apc>web -h enable
</syntaxhighlight>
<syntaxhighlight lang="text">
E002: Success
Reboot required for change to take effect.

* Reboot required for change to take effect.
</syntaxhighlight>

<syntaxhighlight lang="text">
apc>web -s enable
</syntaxhighlight>
<syntaxhighlight lang="text">
E002: Success
Reboot required for change to take effect.

* Reboot required for change to take effect.
</syntaxhighlight>

Now enable SNMP access, specifically, allow the <span class="code">private<span> and <span class="code">public<span> communities.

<syntaxhighlight lang="text">
apc>snmp -S enable -c1 private -a1 writeplus
</syntaxhighlight>
<syntaxhighlight lang="text">
E000: Success

* Reboot required for change to take effect.
</syntaxhighlight>
<syntaxhighlight lang="text">
apc>snmp -S enable -c2 public -a2 writeplus
</syntaxhighlight>
<syntaxhighlight lang="text">
E000: Success

* Reboot required for change to take effect.
</syntaxhighlight>


Reboot to make the changes take effect now.

= Problems =

== Can't Ping After Setting IP ==

When setting the IP address, and then rebooting, you will find over the serial interface that the UPS will get stuck at;

<syntaxhighlight lang="text">
console interrupted on usbuart(1)
BM> 
</syntaxhighlight>

To fix this, run;

<syntaxhighlight lang="text">
BM> boot
</syntaxhighlight>

The serial connection will close, and then the IP should be pingable.

= Recipe = 

If you know what you're doing, and you want a quick copy-paste configuration, edit the IP to be what you want and then paste this.

{{note|1=Make sure you change <span class="code">.x<span> to the IP address you want!}}

<syntaxhighlight lang="text">
tcpip -i 10.201.3.x -s 255.255.0.0
web -h enable
web -s enable
snmp -S enable -c1 private -a1 writeplus
snmp -S enable -c2 public -a2 writeplus
reboot -Y
</syntaxhighlight>

{{footer}}