Demo
Demo

Knowledge base

PMTA knowledge base›Command§ 6.3.33

register

Connect the node to the vendor's console
Establish the link

Connects the node to PowerMTA Management Console — the vendor console for managing multiple nodes.

The node tells the console the address and port of its monitor (–webmon-ip, –webmon-port) and the name it will be visible under (–label). When connecting, the command asks for the console user’s password and prints the console certificate fingerprint.

We do not use it: fleet management is the Hub’s job.

The main trap is not checking the fingerprint. The command prints the console certificate fingerprint and asks you to compare it with the management page in the console itself: connecting to a spoofed server hands the node over to it.
What the Hub does. It does not call it: the vendor console is not used in the fleet.
Recommended values

When to use it:

Question This command or not
connect the node to the vendor console yes
check whether it is connected no — show registration
disconnect no — deregister
The options, the password prompt and the fingerprint check come from the manual (§ 6.3.33). The trap analysis is ours.
Example configuration
# connect the node under the name pmta1server
pmta register --label=pmta1server central.example.com
An example from the manual with a different console address; the command will ask for the password itself.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
⇄

Related entries

3 relations

Depends on

What protects the web monitor and what that protection is notThe mechanism the command works with. § 6.3.33

Works together with

Console connection statusA neighboring command: the same subject from another side. § 6.3.34

Can be replaced by

Disconnect the node from the consoleA neighboring command: the same subject from another side. § 6.3.31

Referenced from

Run a command over the networkThe same output from the command line. § 8.4

How to check on the node
Check the connection:
pmta show registration
The output has the console address, the node name and the same certificate fingerprint that registration showed.
◇

What else to read

3 articles

◇The activation key is a prerequisite for installation, not a step after itWithout an activation key from SparkPost support the engine neither installs nor runs, and the license tier sets the outbound connection ceiling: on Standard everything above 200 is ignored.◇Cloud restrictionsClouds restrict outbound mail on port 25 until you ask them to lift the limit, and mailbox providers treat their address ranges with suspicion.◇How to turn a sending plan into hardwareTwo constants for sizing any node: about 2 KB of memory per queued recipient and spool space proportional to the total size of the messages.

In the Hub
Cost of a mistake
disruptive: applying it interrupts the node
Scenarios
Prepare a node for sending