Chapter 11
The am2bak Command Line Tool

This chapter provides information on the am2bak command line tool and contains the following section:

The am2bak Command Line Executable

---

The am2bak Command Line Executable

Identity Server contains an am2bak utility under IdentityServer_base/SUNWam/bin. This utility performs a backup of either all or optional components of Identity Server. Directory Server must be running while taking the log backup.

The am2bak Syntax

The generic syntax for using the am2bak tool for the Solaris operating system is:

./am2bak [ -v | --verbose ] [ -k | --backup backup-name ] [ -l | --location location ] [[-c | --config] | [-b | --debug] | [-g | --log] | [-t | --cert] | [-d | --ds] | [-a | --all]]*

./am2bak -h | --help

./am2bak -n | --version

The generic syntax for using the am2bak tool for the Windows 2000 operating system is:

am2bak [ -v | --verbose ] [ -k | --backup backup-name ] [ -l | --location location ] [[-c | --config] | [-b | --debug] | [-g | --log] | [-t | --cert] | [-d | --ds] | [-a | --all]]*

am2bak -h | --help

am2bak -n | --version

Note	Two hyphens must be entered exactly as shown in the syntax.

am2bak Options

--verbose (-v)

--verbose is used to run the backup utility in verbose mode.

--backup backup-name (-k)

--backup backup-name defines the name of the backup file. The default is ambak.

--location (-l)

--location specifies the directory location of the backup. The default location is IdentityServer_base/backup.

--config (-c)

--config specifies backup only for configuration files.

--debug (-b)

--debug specifies backup only for debug files.

--log (-g)

--log specifies backup only for log files.

--cert (-t)

--cert specifies backup only for certificate database files.

--ds (-d)

--ds specifies backup only for the Directory Server.

--all (-a)

--all specifies a complete backup of the entire Identity Server.

--help (-h)

--help is an argument that displays the syntax for the am2bak command.

--version (-n)

--version is an argument that displays the utility name, product name, product version and legal notice.

Backup Procedure

Login as root.

The user running this script must have root access.

Run the script ensuring that the correct path is used, if necessary.

The script will backup the following Solaris™ Operating Environment files:

Configuration and Customization Files:
IdentityServer_base/SUNWam/config/
IdentityServer_base/SUNWam/locale/
IdentityServer_base/SUNWam/servers/httpacl
IdentityServer_base/SUNWam/lib/*.properties (Java property files)
IdentityServer_base/SUNWam/bin/amserver.instance-name
IdentityServer_base/SUNWam/servers/https-all_instances
IdentityServer_base/SUNWam/servers/web-apps-all_instances
IdentityServer_base/SUNWam/web-apps/services/WEB-INF/config
IdentityServer_base/SUNWam/web-apps/services/config
IdentityServer_base/SUNWam/web-apps/applications/WEB-INF/classes
IdentityServer_base/SUNWam/web-apps/applications/console
/etc/rc3.d/K55amserver.all_instances
/etc/rc3.d/S55amserver.all_instances
DirectoryServer_base/slapd-host/config/schema/
DirectoryServer_base/slapd-host/config/slapd-collations.conf
DirectoryServer_base/slapd-host/config/dse.ldif
Log And Debug Files:
var/opt/SUNWam/logs (Identity Server log files)
var/opt/SUNWam/install (Identity Server installation log files)
var/opt/SUNWam/debug (Identity Server debug files)
Certificates:
IdentityServer_base/SUNWam/servers/alias
DirectoryServer_base/alias

The script will also backup the following Microsoft® Windows 2000 operating system files:

Configuration and Customization Files:
IdentityServer_base/web-apps/services/WEB-INF/config/*
IdentityServer_base/locale/*
IdentityServer_base/web-apps/applications/WEB-INF/classes/*.properties (java property files)
IdentityServer_base/servers/https-host/config/jvm12.conf
IdentityServer_base/servers/https-host/config/magnus.conf
IdentityServer_base/servers/https-host/config/obj.conf
DirectoryServer_base/slapd-host/config/schema/*.ldif
DirectoryServer_base/slapd-host/config/slapd-collations.conf
DirectoryServer_base/slapd-host/config/dse.ldif
Log And Debug Files:
var/opt/logs (Identity Server log files)
var/opt/debug (Identity Server debug files)
Certificates:
IdentityServer_base/servers/alias
IdentityServer_base/alias

Previous      Contents      Index      Next

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.