ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 3-22
Important note: Sending a SIGUSR1 signal to the ASAP Hybrid Linux server
causes all down domains to be removed. There is no means for picking and
choosing which down domains to remove if you use this approach.
Removing Down Domains Using the asapremove Utility
The asapremove utility supplied with ASAP Hybrid for Linux is intended to be
used to remove individual domains that are down. It works by accepting a
domain name, registering that domain, and then immediately removing it. Like
the other methods described previously, it ensures that the host and Linux sides
remain synchronized. If the Linux server cannot notify the host that a domain has
been removed, the removal remains pending until the notification can be
delivered.
By default the asapremove utility is located in the bin directory that contains the
ASAP Hybrid for Linux server. The executable file name is asapremove. The
command syntax is:
./asapremove [<domain name> [ <domain name> …]]
where <domain name> specifies a complete domain name currently registered
on the Linux system.
If one or more domain names are specified on the command line, asapremove
attempts to remove each and then exits. If no domain names are supplied on the
command line, the utility runs in interactive mode and prompts for the domain
names to be removed.
Important note: Most ASAP domain names contain backslash (\) characters. In
interactive mode, these characters do not need to be escaped by preceding them
with an additional backslash. The asapremove utility does not give any special
meaning to backslash characters though many Linux-based tools and utilities do.
Thus, for example, if you want to remove the domain My\DomainName, specify
to asapremove in interactive mode the value My\DomainName, not
My\\DomainName.
However, if you specify domain names on the asapremove command line, you
might need to precede each embedded backslash with an additional backslash
character. For example, to remove the domain name My\DomainName: