sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

User Commands | hadbm-unregisterpackage(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- ERROR CODES
- SEE ALSO

## NAME

> hadbm unregisterpackage - removes registered HADB packages from the management domain

## SYNOPSIS

> `hadbm unregisterpackage` [hosts=hostlist] [adminpassword=password | adminpasswordfile=filename] [agent=ma_url] [package_name]

## DESCRIPTION

> Use the `hadbm unregisterpackage` command to remove the HADB packages that are registered with the management domain. The default package name is a string starting with V and containing the version number of the hadbm program. If the hosts option is omitted, the hostlist defaults to the enabled hosts where the package is registered.

> Before using the `hadbm unregisterpackage` command, ensure that all management agents are configured and running on all the hosts in the hostlist, the management agent's repository is available for updates, the package is registered in the management domain, and no existing databases are configured to run on the package about to be unregistered.

## OPTIONS

> Hhosts

>   A comma-separated or double quote enclosed space separated list of hosts to register the package on.

> w adminpassword

>   The actual HADBM administation password.

> W adminpasswordfile

>   The file from which the HADBM administration password is read.

> m agent

>   Identifies the URL to the Management Agent. The default is localhost:1862.

## OPERANDS

> package_name

>   The name of the package you wish to remove from the domain.

## EXAMPLES

> Example 1. Unregistering a software package named v4

> > >     hadbm unregisterpackage v4
> > >     Package successfully unregistered

> Example 2. Unregistering a software package named v4 from specific hosts in the domain

> > >     hadbm unregisterpackage --hosts=host1,host2,host3 v4
> > >     Package successfully unregistered

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## ERROR CODES

> 22172

>   the software package is not registered in the domain

> 22173

>   the software package is in use by a database instance and cannot be removed

## SEE ALSO

> `hadbm`(1m), `hadbm-registerpackage`(1), `hadbm-list-packages`(1)

J2EE SDK 1.4 | Go To Top | Last Changed 22 Dec 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.