com.sun.enterprise.admin.servermgmt
Interface DomainsManager

All Known Implementing Classes:

PEDomainsManager

public interface DomainsManager

Method Summary

void	createDomain(DomainConfig domainConfig) Creates a domain
void	deleteDomain(DomainConfig domainConfig) Deletes a domain identified by the given name.
BitSet	getDomainFlags() In SE/EE we need an admin user/password that the DAS can use to authenticate to Node Agents and servers in the domain.
String[]	getExtraPasswordOptions(DomainConfig config) SE/EE supports NSS as its native SSL database.
String[]	listDomains(DomainConfig domainConfig) Lists all the domains.
void	validateDomain(DomainConfig domainConfig, boolean domainExists) Changes the master password for the domain
void	validateMasterPassword(DomainConfig config)

Method Detail

getDomainFlags

BitSet getDomainFlags()

In SE/EE we need an admin user/password that the DAS can use to authenticate to Node Agents and servers in the domain. This is not the case in PE; hence this flag -- DomainConfig.K_FLAG_START_DOMAIN_NEEDS_ADMIN_USER In SE/EE we need an extra non secure http port to host the Lockhart components which is controlled by -- DomainConfig.K_FLAG_CREATE_DOMAIN_NEEDS_ALTERNATE_ADMIN_PORT

Returns:

flags toggling SE/EE specific behavior.

getExtraPasswordOptions

String[] getExtraPasswordOptions(DomainConfig config)
                                 throws DomainException

SE/EE supports NSS as its native SSL database. NSS is capable of supporting multiple slots (e.g. for different SSL hardware devices, smartcards, etc). Each device needs a specific password which the CLI must prompt for.

Throws:

DomainException

createDomain

void createDomain(DomainConfig domainConfig)
                  throws DomainException

Creates a domain

Parameters:

domainConfig - The configuration params that are required to create the domain. (eg :- domain admin port, http port, default locale, domain root, install root etc.) The relevant keys are defined in DomainConfig. The implementors of this class should validate the values that are supplied.

Throws:

DomainException - This exception is thrown if - the domain already exists. - an invalid or insufficient config. is supplied. - an exception occurred during domain creation.

deleteDomain

void deleteDomain(DomainConfig domainConfig)
                  throws DomainException

Deletes a domain identified by the given name. (Should we stop the DAS and instances administered by this domain before deleting the domain?)

Parameters:

domainConfig -

Throws:

DomainException - This exception is thrown if

- the domain doesnot exist. - an exception occurred while deleting the domain.

listDomains

String[] listDomains(DomainConfig domainConfig)
                     throws DomainException

Lists all the domains.

Throws:

DomainException

validateDomain

void validateDomain(DomainConfig domainConfig,
                    boolean domainExists)
                    throws DomainException

Changes the master password for the domain

Throws:

DomainException

validateMasterPassword

void validateMasterPassword(DomainConfig config)
                            throws DomainException

Throws:

DomainException