Configuring an APC AP7900: Difference between revisions

From Alteeve Wiki
Jump to navigation Jump to search
No edit summary
Line 22: Line 22:


The easiest way to configure an IP address is to log into the PDU over a [https://en.wikipedia.org/wiki/Serial_port serial] port. Most 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/industrial-usb/usb-to-serial/1-port/uts-1110a?pid=4509 Antaira UTS-1110A], but almost any adapter you can find at your local computer store will work.
The easiest way to configure an IP address is to log into the PDU over a [https://en.wikipedia.org/wiki/Serial_port serial] port. Most 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/industrial-usb/usb-to-serial/1-port/uts-1110a?pid=4509 Antaira UTS-1110A], but almost any adapter you can find at your local computer store will work.
{{note|1=If you used the [[Anvil!_m2_Tutorial#Running_the_Striker_Installer|Striker installer]] or configured the node using an [[Anvil!_m2_Tutorial#Building_an_Anvil.21|Install Manifest]], then <span class="code">screen</span> will already be installed. If not, you can install it with the command "<span class="code">yum install screen</span>".}}


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.
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.
Line 39: Line 41:
|USB-Connected port 1
|USB-Connected port 1
|class="code"|/dev/ttyUSB0
|class="code"|/dev/ttyUSB0
|-
|USB-Connected port 2
|class="code"|/dev/ttyUSB1
|}
... and so on.
In my case, I'm using the first built-in serial port, so I will use '<span class="code">/dev/ttyS0</span>'.
Knowing this, we're ready to go!
Open a terminal window and run:
<syntaxhighlight lang="bash">
screen /dev/ttyS0
</syntaxhighlight>
The screen will be blank at first. Press '<span class="code"><enter></span>' a couple of times and the AP7900 login prompt should appear.
<syntaxhighlight lang="text">
User Name :   
</syntaxhighlight>
{{note|1=If you make a mistake and nothing happens when you press '<span class="code"><Backspace></span>', try pressing '<span class="code">ctrl</span>' + '<span class="code">h</span>' instead.}}
The default user name is '<span class="code">apc</span>' and the default password is '<span class="code">apc</span>' as well.
<syntaxhighlight lang="text">
User Name : apc
Password  : ***
</syntaxhighlight>
You will see a summary page.
<syntaxhighlight lang="text">
American Power Conversion              Network Management Card AOS      v3.7.4
(c) Copyright 2009 All Rights Reserved  Rack PDU APP                    v3.7.4
-------------------------------------------------------------------------------
Name      : RackPDU                                  Date : 05/23/2000
Contact  : Unknown                                  Time : 20:44:16
Location  : Unknown                                  User : Administrator
Up Time  : 3 Days 3 Hours 1 Minute                  Stat : P+ N? A+
Switched Rack PDU: Communication Established
------- Control Console -------------------------------------------------------
    1- Device Manager
    2- Network
    3- System
    4- Logout
    <ESC>- Main Menu, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Press '<span class="code">2</span>' to go into the "<span class="code">Network</span>" sub-menu.
<syntaxhighlight lang="text">
> 2
</syntaxhighlight>
<syntaxhighlight lang="text">
------- Network ---------------------------------------------------------------
    1- TCP/IP
    2- DNS
    3- Ping Utility
    4- FTP Server
    5- Telnet/SSH
    6- Web/SSL/TLS
    7- Email
    8- SNMP
    9- Syslog
    10- ISX Protocol
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Press the '<span class="code">1</span>' key to go into the "<span class="code">TCP/IP</span>" menu.
<syntaxhighlight lang="text">
> 1
</syntaxhighlight>
<syntaxhighlight lang="text">
------- TCP/IP ----------------------------------------------------------------
        Network not started. Currently making a BOOTP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E
    1- Boot Mode  : DHCP & BOOTP
    2- Advanced...
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
First we need to change the "<span class="code">Boot Mode</span>" to "<span class="code">Manual</span>", so press '<span class="code">1</span>'.
<syntaxhighlight lang="text">
> 1
</syntaxhighlight>
<syntaxhighlight lang="text">
------- Boot Mode -------------------------------------------------------------
    1- DHCP & BOOTP
    2- DHCP only
    3- BOOTP only
    4- Manual
    <ESC>- Back, <ENTER>- Refresh
</syntaxhighlight>
Press '<span class="code">4</span>' to select the "<span class="code">Manual</span>" option.
<syntaxhighlight lang="text">
> 4
</syntaxhighlight>
<syntaxhighlight lang="text">
------- TCP/IP ----------------------------------------------------------------
        Network not started. Currently making a BOOTP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E
        * Changes will take effect on logout.
    1- System IP      : 0.0.0.0
    2- Subnet Mask    : 0.0.0.0
    3- Default Gateway: 0.0.0.0
    4- Boot Mode      : Manual
    5- Advanced...
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Now we're ready to set the IP address.
In [[AN!Cluster_Tutorial_2#Subnets|most ''Anvil!'' systems]], the switched PDUs have the IP address of '<span class="code">10.20.2.x/255.255.0.0</span>'.
This is the convention we're going to use here. This is our first PDU, so we'll set:
{|class="wikitable"
|-
|class="code"|System IP
|class="code"|10.20.2.1
|-
|class="code"|Subnet Mask
|class="code"|255.255.0.0
|-
|class="code"|Default Gateway
|class="code"|10.20.255.254
|}
|}


There is no outside network access on the [[Back-Channel Network]], so it may not seem like it makes sense to set the "<span class="code">Default Gateway</span>". The problem is that the PDU requires a gateway be set, so we give it a fake, unused address. Often, when there is a router on a network, it takes the top of bottom IP address in the subnet. We're using the top IP address as the dummy gateway here.
So back to it!
Press '<span class="code">1</span>' to set the IP.
<syntaxhighlight lang="text">
> 1
</syntaxhighlight>
<syntaxhighlight lang="text">
System IP : 10.20.2.1
</syntaxhighlight>
<syntaxhighlight lang="text">
------- TCP/IP ----------------------------------------------------------------
        Network not started. IP, Subnet, Gateway must be configured.
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E
        * Changes will take effect on logout.
    1- System IP      : 10.20.2.1
    2- Subnet Mask    : 0.0.0.0
    3- Default Gateway: 0.0.0.0
    4- Boot Mode      : Manual
    5- Advanced...
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Now press '<span class="code">2</span>' to set the "<span class="code">Subnet Mask</span>".
<syntaxhighlight lang="text">
> 2
</syntaxhighlight>
<syntaxhighlight lang="text">
Subnet Mask : 255.255.0.0
</syntaxhighlight>
<syntaxhighlight lang="text">
------- TCP/IP ----------------------------------------------------------------
        Network not started. IP, Subnet, Gateway must be configured.
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E
        * Changes will take effect on logout.
    1- System IP      : 10.20.2.1
    2- Subnet Mask    : 255.255.0.0
    3- Default Gateway: 0.0.0.0
    4- Boot Mode      : Manual
    5- Advanced...
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Now press '<span class="code">3</span>' to set the dummy "<span class="code">Default Gateway</span>" address.
<syntaxhighlight lang="text">
> 3
</syntaxhighlight>
<syntaxhighlight lang="text">
Default Gateway : 10.20.255.254
------- TCP/IP ----------------------------------------------------------------
        Network not started. Currently making a DHCP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E
        * A cookie is required in the vendor options to accept a DHCP offer.
        * Changes will take effect on logout.
    1- System IP      : 10.20.2.1
    2- Subnet Mask    : 255.255.0.0
    3- Default Gateway: 10.20.255.254
    4- Boot Mode      : Manual
    5- Advanced...
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
{{note|1=The changes won't take effect until we log out.}}
Press '<span class="code"><esc></span>' to go back to the main menu.
<syntaxhighlight lang="text">
<esc>
</syntaxhighlight>
<syntaxhighlight lang="text">
------- Network ---------------------------------------------------------------
    1- TCP/IP
    2- DNS
    3- Ping Utility
    4- FTP Server
    5- Telnet/SSH
    6- Web/SSL/TLS
    7- Email
    8- SNMP
    9- Syslog
    10- ISX Protocol
    <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
</syntaxhighlight>
Press '<span class="code"><esc></span>' again.
<syntaxhighlight lang="text">
<esc>
</syntaxhighlight>
<syntaxhighlight lang="text">
------- Control Console -------------------------------------------------------
    1- Device Manager
    2- Network
    3- System
    4- Logout
    <ESC>- Main Menu, <ENTER>- Refresh, <CTRL-L>- Event Log
>
</syntaxhighlight>
Lastly, press '<span class="code">4</span>' to log out.
<syntaxhighlight lang="text">
> 4
</syntaxhighlight>
<syntaxhighlight lang="text">
Logging out.
</syntaxhighlight>
The terminal window will no longer respond (the PDU is rebooting).
To exit out of '<span class="code">screen</span>', you need to press '<span class="code">ctrl</span> + <span class="code">a</span>', release the keys, then press '<span class="code">k</span>'.
<syntaxhighlight lang="text">
<ctrl> + <a>
</syntaxhighlight>
(release)
<syntaxhighlight lang="text">
<k>
</syntaxhighlight>
Screen will ask if you want to kill the session.
<syntaxhighlight lang="text">
Really kill this window [y/n]
</syntaxhighlight>
Press '<span class="code">y</span>'
<syntaxhighlight lang="text">
y
</syntaxhighlight>
<syntaxhighlight lang="text">
[screen is terminating]
</syntaxhighlight>
Now you are back at the normal linux terminal.
{{note|1=Please be patient while the PDU reboots. It might take a minute.}}
You can test the connection to the PDU using '<span class="code">ping</span>';
<syntaxhighlight lang="bash">
ping -c 3 10.20.2.1
</syntaxhighlight>
<syntaxhighlight lang="text">
PING 10.20.2.1 (10.20.2.1) 56(84) bytes of data.
64 bytes from 10.20.2.1: icmp_seq=1 ttl=255 time=4.61 ms
64 bytes from 10.20.2.1: icmp_seq=2 ttl=255 time=4.30 ms
64 bytes from 10.20.2.1: icmp_seq=3 ttl=255 time=3.00 ms


--- 10.20.2.1 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2006ms
rtt min/avg/max/mdev = 3.006/3.976/4.613/0.697 ms
</syntaxhighlight>


<span class="code"></span>
Done!


{{footer}}
{{footer}}

Revision as of 04:46, 31 December 2014

Template:Howto tutorial

APC AP7900 8-Outlet 1U 120vAC PDU. Photo by APC.

Purpose of This Tutorial =

The APC-brand AP7900 switched PDU is an excellent backup fence device. All Anvil! systems we build use a pair of them.

This mini-tutorial covers how to configure them with an IP address.

That is all you need to do for them to start working!

Warning: If you need to put the PDUs onto a public network, be sure to enable SNMP authentication!

We run them on our VLAN isolated subnet which how no access to the normal internal network, nor does it have access to the Internet. Thanks to this, we can safely run them without authentication over SNMP queries.

Serial Access

Antaira UTS-1110A single-port USB to RS-232] serial adapter. Photo by Antaira.

By default, the APC AP7900 does not have an IP address assigned.

The easiest way to configure an IP address is to log into the PDU over a serial port. Most 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 Antaira UTS-1110A, but almost any adapter you can find at your local computer store will work.

Note: If you used the Striker installer or configured the node using an Install Manifest, then screen will already be installed. If not, you can install it with the command "yum install screen".

We're going to use a program called screen 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:

Type Device path
Serial port 1 /dev/ttyS0
Serial port 2 /dev/ttyS1
USB-Connected port 1 /dev/ttyUSB0
USB-Connected port 2 /dev/ttyUSB1

... and so on.

In my case, I'm using the first built-in serial port, so I will use '/dev/ttyS0'.

Knowing this, we're ready to go!

Open a terminal window and run:

screen /dev/ttyS0

The screen will be blank at first. Press '<enter>' a couple of times and the AP7900 login prompt should appear.

User Name :
Note: If you make a mistake and nothing happens when you press '<Backspace>', try pressing 'ctrl' + 'h' instead.

The default user name is 'apc' and the default password is 'apc' as well.

User Name : apc
Password  : ***

You will see a summary page.

American Power Conversion               Network Management Card AOS      v3.7.4
(c) Copyright 2009 All Rights Reserved  Rack PDU APP                     v3.7.4
-------------------------------------------------------------------------------
Name      : RackPDU                                   Date : 05/23/2000
Contact   : Unknown                                   Time : 20:44:16
Location  : Unknown                                   User : Administrator
Up Time   : 3 Days 3 Hours 1 Minute                   Stat : P+ N? A+

Switched Rack PDU: Communication Established

------- Control Console -------------------------------------------------------

     1- Device Manager
     2- Network
     3- System
     4- Logout

     <ESC>- Main Menu, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Press '2' to go into the "Network" sub-menu.

> 2
------- Network ---------------------------------------------------------------

     1- TCP/IP
     2- DNS
     3- Ping Utility
     4- FTP Server
     5- Telnet/SSH
     6- Web/SSL/TLS
     7- Email
     8- SNMP
     9- Syslog
    10- ISX Protocol

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Press the '1' key to go into the "TCP/IP" menu.

> 1
------- TCP/IP ----------------------------------------------------------------

        Network not started. Currently making a BOOTP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E

     1- Boot Mode  : DHCP & BOOTP
     2- Advanced...

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>

First we need to change the "Boot Mode" to "Manual", so press '1'.

> 1
------- Boot Mode -------------------------------------------------------------

     1- DHCP & BOOTP
     2- DHCP only
     3- BOOTP only
     4- Manual

     <ESC>- Back, <ENTER>- Refresh

Press '4' to select the "Manual" option.

> 4
------- TCP/IP ----------------------------------------------------------------

        Network not started. Currently making a BOOTP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E

        * Changes will take effect on logout.

     1- System IP      : 0.0.0.0
     2- Subnet Mask    : 0.0.0.0
     3- Default Gateway: 0.0.0.0
     4- Boot Mode      : Manual
     5- Advanced...

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Now we're ready to set the IP address.

In most Anvil! systems, the switched PDUs have the IP address of '10.20.2.x/255.255.0.0'.

This is the convention we're going to use here. This is our first PDU, so we'll set:

System IP 10.20.2.1
Subnet Mask 255.255.0.0
Default Gateway 10.20.255.254

There is no outside network access on the Back-Channel Network, so it may not seem like it makes sense to set the "Default Gateway". The problem is that the PDU requires a gateway be set, so we give it a fake, unused address. Often, when there is a router on a network, it takes the top of bottom IP address in the subnet. We're using the top IP address as the dummy gateway here.

So back to it!

Press '1' to set the IP.

> 1
System IP : 10.20.2.1
------- TCP/IP ----------------------------------------------------------------

        Network not started. IP, Subnet, Gateway must be configured.
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E

        * Changes will take effect on logout.

     1- System IP      : 10.20.2.1
     2- Subnet Mask    : 0.0.0.0
     3- Default Gateway: 0.0.0.0
     4- Boot Mode      : Manual
     5- Advanced...

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Now press '2' to set the "Subnet Mask".

> 2
Subnet Mask : 255.255.0.0
------- TCP/IP ----------------------------------------------------------------

        Network not started. IP, Subnet, Gateway must be configured.
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E

        * Changes will take effect on logout.

     1- System IP      : 10.20.2.1
     2- Subnet Mask    : 255.255.0.0
     3- Default Gateway: 0.0.0.0
     4- Boot Mode      : Manual
     5- Advanced...

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Now press '3' to set the dummy "Default Gateway" address.

> 3
Default Gateway : 10.20.255.254

------- TCP/IP ----------------------------------------------------------------

        Network not started. Currently making a DHCP request...
        -----------------------------------------------------------------------
        MAC Address : 00 C0 B7 88 CC 1E

        * A cookie is required in the vendor options to accept a DHCP offer.
        * Changes will take effect on logout.

     1- System IP      : 10.20.2.1
     2- Subnet Mask    : 255.255.0.0
     3- Default Gateway: 10.20.255.254
     4- Boot Mode      : Manual
     5- Advanced...

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log
>
Note: The changes won't take effect until we log out.

Press '<esc>' to go back to the main menu.

<esc>
------- Network ---------------------------------------------------------------

     1- TCP/IP
     2- DNS
     3- Ping Utility
     4- FTP Server
     5- Telnet/SSH
     6- Web/SSL/TLS
     7- Email
     8- SNMP
     9- Syslog
    10- ISX Protocol

     <ESC>- Back, <ENTER>- Refresh, <CTRL-L>- Event Log

Press '<esc>' again.

<esc>
------- Control Console -------------------------------------------------------

     1- Device Manager
     2- Network
     3- System
     4- Logout

     <ESC>- Main Menu, <ENTER>- Refresh, <CTRL-L>- Event Log
>

Lastly, press '4' to log out.

> 4
Logging out.

The terminal window will no longer respond (the PDU is rebooting).

To exit out of 'screen', you need to press 'ctrl + a', release the keys, then press 'k'.

<ctrl> + <a>

(release)

<k>

Screen will ask if you want to kill the session.

Really kill this window [y/n]

Press 'y'

y
[screen is terminating]

Now you are back at the normal linux terminal.

Note: Please be patient while the PDU reboots. It might take a minute.

You can test the connection to the PDU using 'ping';

ping -c 3 10.20.2.1
PING 10.20.2.1 (10.20.2.1) 56(84) bytes of data.
64 bytes from 10.20.2.1: icmp_seq=1 ttl=255 time=4.61 ms
64 bytes from 10.20.2.1: icmp_seq=2 ttl=255 time=4.30 ms
64 bytes from 10.20.2.1: icmp_seq=3 ttl=255 time=3.00 ms

--- 10.20.2.1 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2006ms
rtt min/avg/max/mdev = 3.006/3.976/4.613/0.697 ms

Done!

 

Any questions, feedback, advice, complaints or meanderings are welcome.
Alteeve's Niche! Enterprise Support:
Alteeve Support
Community Support
© Alteeve's Niche! Inc. 1997-2024   Anvil! "Intelligent Availability®" Platform
legal stuff: All info is provided "As-Is". Do not use anything here unless you are willing and able to take responsibility for your own actions.