org.rhq.enterprise.server.installer

Class ServerInstallUtil

java.lang.Object

org.rhq.enterprise.server.installer.ServerInstallUtil

public class ServerInstallUtil
extends Object

Provides utility methods necessary to complete the server installation.

Author:

John Mazzitelli

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServerInstallUtil.ExistingSchemaOption
static class	ServerInstallUtil.SupportedDatabaseType

Constructor Summary

Constructors

Constructor and Description
ServerInstallUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static void	configureDeploymentScanner(org.jboss.as.controller.client.ModelControllerClient mcc) Configure the deployment scanner.
static void	configureLogging(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Configure the logging subsystem.
static void	configureTransactionManager(org.jboss.as.controller.client.ModelControllerClient mcc) Configure the transaction manager.
static void	createDatasourceSecurityDomain(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates the security domain for the datasources.
static void	createDefaultManagementUser(ServerDetails serverDetails, String configDirStr) Create an rhqadmin/rhqadmin management user so when discovered, the AS7 plugin can immediately connect to the RHQ Server.
static File	createKeystore(ServerDetails serverDetails, String configDirStr) Creates a keystore whose cert has a CN of this server's public endpoint address.
static void	createNewCaches(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates the Infinispan caches for RHQ.
static void	createNewDatabaseSchema(HashMap<String,String> props, ServerDetails serverDetails, String password, String logDir) This will create the database schema in the database.
static void	createNewDatasources(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates the datasources needed by the RHQ Server.
static void	createNewJdbcDrivers(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates JDBC driver configurations so the datasources can properly connect to the backend databases.
static void	createNewJMSQueues(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates the JMS Queues required for Drift and Alerting.
static void	createRESTSecurityDomain(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Creates the security domain for REST.
static String	deobfuscatePassword(String obfuscatedPassword) Use the internal JBossAS mechanism to de-obfuscate a password back to its clear text form.
static void	ensureDatabaseIsSupported(String connectionUrl, String username, String password) Call this when you need to confirm that the database is supported.
static Connection	getDatabaseConnection(String connectionUrl, String userName, String password) Returns a database connection with the given set of properties providing the settings that allow for a successful database connection.
static ServerDetails	getServerDetails(String connectionUrl, String username, String password, String serverName) Returns information on the server as found in the database (port numbers, affinity group, etc).
static ArrayList<String>	getServerNames(String connectionUrl, String username, String password) Get the list of existing servers from an existing schema.
static ServerInstallUtil.SupportedDatabaseType	getSupportedDatabaseType(HashMap<String,String> serverProperties) Give the server properties, this returns the type of database that will be connected to.
static ServerInstallUtil.SupportedDatabaseType	getSupportedDatabaseType(String dbType) Give the database type string, this returns the type of database that it refers to.
static boolean	isAutoinstallEnabled(HashMap<String,String> serverProperties) Determines if we are in auto-install mode.
static boolean	isDatabaseSchemaExist(String connectionUrl, String username, String password) Returns true if the database already has the database schema created for it.
static boolean	isEmpty(String s) Given a server property value string, returns true if it is not specified.
static boolean	isSameDatasourceSecurityDomainExisting(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) This checks to see if the security domain for the datasources already exists and has the same username/password as those found in the given properties THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321.
static boolean	isSameLoggingExisting(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) This checks to see if the logging settings have the same values as those found in the given properties.
static boolean	isSameMailServiceExisting(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) This checks to see if the mail service already exists and has the same settings as those found in the given properties.
static boolean	isSameWebConnectorsExisting(org.jboss.as.controller.client.ModelControllerClient mcc, String appServerConfigDir, HashMap<String,String> serverProperties) This checks to see if the web connectors already exist and have the same settings as those found in the given properties THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321.
static String	obfuscatePassword(String password) Use the internal JBossAS mechanism to obfuscate a password.
static void	setSocketBindings(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties)
static void	setupMailService(org.jboss.as.controller.client.ModelControllerClient mcc, HashMap<String,String> serverProperties) Prepares the mail service by configuring the SMTP settings.
static void	setupWebConnectors(org.jboss.as.controller.client.ModelControllerClient mcc, String configDirStr, HashMap<String,String> serverProperties) Ensures our web connectors are configured properly.
static void	storeServerDetails(HashMap<String,String> serverProperties, String password, ServerDetails serverDetails) Stores the server details (such as the public endpoint) in the database.
static String	testConnection(String connectionUrl, String username, String password) Tests to make sure the server can be connected to with the given settings.
static void	upgradeExistingDatabaseSchema(HashMap<String,String> props, ServerDetails serverDetails, String password, String logDir) This will update an existing database schema so it can be upgraded to the latest schema version.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerInstallUtil

public ServerInstallUtil()

Method Detail

configureLogging

public static void configureLogging(org.jboss.as.controller.client.ModelControllerClient mcc,
                    HashMap<String,String> serverProperties)
                             throws Exception

Configure the logging subsystem.

Parameters:

mcc - JBossAS management client

serverProperties - the server properties, which includes the default log level to use

Throws:

Exception

configureTransactionManager

public static void configureTransactionManager(org.jboss.as.controller.client.ModelControllerClient mcc)
                                        throws Exception

Configure the transaction manager.

Parameters:

mcc - JBossAS management client

Throws:

Exception

configureDeploymentScanner

public static void configureDeploymentScanner(org.jboss.as.controller.client.ModelControllerClient mcc)
                                       throws Exception

Configure the deployment scanner.

Parameters:

mcc - JBossAS management client

Throws:

Exception

setupMailService

public static void setupMailService(org.jboss.as.controller.client.ModelControllerClient mcc,
                    HashMap<String,String> serverProperties)
                             throws Exception

Prepares the mail service by configuring the SMTP settings.

Parameters:

mcc - JBossAS management client

serverProperties - the server's properties

Throws:

Exception

getSupportedDatabaseType

public static ServerInstallUtil.SupportedDatabaseType getSupportedDatabaseType(HashMap<String,String> serverProperties)

Give the server properties, this returns the type of database that will be connected to.

Parameters:

serverProperties -

Returns:

the type of DB

getSupportedDatabaseType

public static ServerInstallUtil.SupportedDatabaseType getSupportedDatabaseType(String dbType)

Give the database type string, this returns the type of database that it refers to.

Parameters:

dbType - the database type string

Returns:

the type of DB

createDatasourceSecurityDomain

public static void createDatasourceSecurityDomain(org.jboss.as.controller.client.ModelControllerClient mcc,
                                  HashMap<String,String> serverProperties)
                                           throws Exception

Creates the security domain for the datasources. This is needed to support obfuscation of the password in the configuration file.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the obfuscated password to store in the security domain

Throws:

Exception

createNewJMSQueues

public static void createNewJMSQueues(org.jboss.as.controller.client.ModelControllerClient mcc,
                      HashMap<String,String> serverProperties)
                               throws Exception

Creates the JMS Queues required for Drift and Alerting.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the obfuscated password to store in the security domain

Throws:

Exception

createRESTSecurityDomain

public static void createRESTSecurityDomain(org.jboss.as.controller.client.ModelControllerClient mcc,
                            HashMap<String,String> serverProperties)
                                     throws Exception

Creates the security domain for REST.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the obfuscated password to store in the security domain

Throws:

Exception

createNewCaches

public static void createNewCaches(org.jboss.as.controller.client.ModelControllerClient mcc,
                   HashMap<String,String> serverProperties)
                            throws Exception

Creates the Infinispan caches for RHQ.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the obfuscated password to store in the security domain

Throws:

Exception

createNewJdbcDrivers

public static void createNewJdbcDrivers(org.jboss.as.controller.client.ModelControllerClient mcc,
                        HashMap<String,String> serverProperties)
                                 throws Exception

Creates JDBC driver configurations so the datasources can properly connect to the backend databases. This will attempt to create drivers for all supported databases, not just for the database type that is currently configured.

Parameters:

mcc -

serverProperties -

Throws:

Exception

createNewDatasources

public static void createNewDatasources(org.jboss.as.controller.client.ModelControllerClient mcc,
                        HashMap<String,String> serverProperties)
                                 throws Exception

Creates the datasources needed by the RHQ Server.

Parameters:

mcc - the JBossAS management client

serverProperties - properties to help determine the properties of the datasources to be created

Throws:

Exception

isAutoinstallEnabled

public static boolean isAutoinstallEnabled(HashMap<String,String> serverProperties)

Determines if we are in auto-install mode. This means the properties file is fully configured and the installation can begin without asking the user for more input.

Parameters:

serverProperties - the full set of server properties

Returns:

true if we are in auto-install mode; false if the user must give us more information before we can complete the installation.

isDatabaseSchemaExist

public static boolean isDatabaseSchemaExist(String connectionUrl,
                            String username,
                            String password)
                                     throws Exception

Returns true if the database already has the database schema created for it. It will not be known what version of schema or if its the latest, all this method tells you is that some RHQ database schema exists.

Parameters:

connectionUrl -

username -

password -

Returns:

true if the database can be connected to

Throws:

Exception - if failed to communicate with the database

getServerNames

public static ArrayList<String> getServerNames(String connectionUrl,
                               String username,
                               String password)
                                        throws Exception

Get the list of existing servers from an existing schema.

Parameters:

connectionUrl -

username -

password -

Returns:

List of server names registered in the database. Empty list if the table does not exist or there are no entries in the table.

Throws:

Exception - if failed to communicate with the database

getServerDetails

public static ServerDetails getServerDetails(String connectionUrl,
                             String username,
                             String password,
                             String serverName)

Returns information on the server as found in the database (port numbers, affinity group, etc).

Parameters:

connectionUrl -

username -

password -

serverName - the server whose details are to be returned

Returns:

the information on the named server

testConnection

public static String testConnection(String connectionUrl,
                    String username,
                    String password)

Tests to make sure the server can be connected to with the given settings. If the test is successful, null. If the test fails, the returned string will be the error message to indicate the problem.

Parameters:

connectionUrl -

username -

password -

Returns:

error message if test failed; null if test succeeded

ensureDatabaseIsSupported

public static void ensureDatabaseIsSupported(String connectionUrl,
                             String username,
                             String password)
                                      throws Exception

Call this when you need to confirm that the database is supported.

Parameters:

connectionUrl -

username -

password -

Throws:

Exception - if the database is not supported

getDatabaseConnection

public static Connection getDatabaseConnection(String connectionUrl,
                               String userName,
                               String password)
                                        throws SQLException

Returns a database connection with the given set of properties providing the settings that allow for a successful database connection. If props is null, it will use the server properties from #getServerProperties().

Parameters:

connectionUrl -

userName -

password -

Returns:

the database connection

Throws:

SQLException - if cannot successfully connect to the database

obfuscatePassword

public static String obfuscatePassword(String password)

Use the internal JBossAS mechanism to obfuscate a password. This is not true encryption.

Parameters:

password - the clear text of the password to obfuscate

Returns:

the obfuscated password

deobfuscatePassword

public static String deobfuscatePassword(String obfuscatedPassword)

Use the internal JBossAS mechanism to de-obfuscate a password back to its clear text form. This is not true encryption.

Parameters:

obfuscatedPasswordd - the obfuscated password

Returns:

the clear-text password

storeServerDetails

public static void storeServerDetails(HashMap<String,String> serverProperties,
                      String password,
                      ServerDetails serverDetails)
                               throws Exception

Stores the server details (such as the public endpoint) in the database. If the server definition already exists, it will be updated; otherwise, a new server will be added to the HA cloud.

Parameters:

serverProperties - the server properties

password - clear text password to connect to the database

serverDetails - the details of the server to put into the database

Throws:

Exception

createNewDatabaseSchema

public static void createNewDatabaseSchema(HashMap<String,String> props,
                           ServerDetails serverDetails,
                           String password,
                           String logDir)
                                    throws Exception

This will create the database schema in the database. props define the connection to the database -

Note that if the schema already exists, it will be purged of all data/tables and recreated.

Parameters:

props - the full set of server properties

serverDetails - additional information about the server being installed

password - the database password in clear text

logDir - a directory where the db schema upgrade logs can be written

Throws:

Exception - if failed to create the new schema for some reason

upgradeExistingDatabaseSchema

public static void upgradeExistingDatabaseSchema(HashMap<String,String> props,
                                 ServerDetails serverDetails,
                                 String password,
                                 String logDir)
                                          throws Exception

This will update an existing database schema so it can be upgraded to the latest schema version.

Note that if the schema does not already exist, errors will occur.

Parameters:

props - the full set of server properties

serverDetails - additional information about the server being installed

password - the database password in clear text

logDir - a directory where the db schema upgrade logs can be written

Throws:

Exception - if the upgrade failed for some reason

isEmpty

public static boolean isEmpty(String s)

Given a server property value string, returns true if it is not specified.

Parameters:

s - the property string value

Returns:

true if it is null or empty

setupWebConnectors

public static void setupWebConnectors(org.jboss.as.controller.client.ModelControllerClient mcc,
                      String configDirStr,
                      HashMap<String,String> serverProperties)
                               throws Exception

Ensures our web connectors are configured properly.

Parameters:

mcc - the AS client

configDirStr - location of a configuration directory where the keystore is to be stored

serverProperties - the full set of server properties

Throws:

Exception

createKeystore

public static File createKeystore(ServerDetails serverDetails,
                  String configDirStr)

Creates a keystore whose cert has a CN of this server's public endpoint address.

Parameters:

serverDetails - details of the server being installed

configDirStr - location of a configuration directory where the keystore is to be stored

Returns:

where the keystore file should be created (if an error occurs, this file won't exist)

createDefaultManagementUser

public static void createDefaultManagementUser(ServerDetails serverDetails,
                               String configDirStr)

Create an rhqadmin/rhqadmin management user so when discovered, the AS7 plugin can immediately connect to the RHQ Server.

Parameters:

serverDetails - details of the server being installed

configDirStr - location of a configuration directory where the mgmt-users.properties file lives

setSocketBindings

public static void setSocketBindings(org.jboss.as.controller.client.ModelControllerClient mcc,
                     HashMap<String,String> serverProperties)
                              throws Exception

Throws:

Exception

isSameLoggingExisting

public static boolean isSameLoggingExisting(org.jboss.as.controller.client.ModelControllerClient mcc,
                            HashMap<String,String> serverProperties)

This checks to see if the logging settings have the same values as those found in the given properties. THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321. ONCE AS7 DOES THIS, THIS METHOD CAN GO AWAY.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the logging settings

Returns:

true if the logging settings have the same values

Throws:

Exception

isSameMailServiceExisting

public static boolean isSameMailServiceExisting(org.jboss.as.controller.client.ModelControllerClient mcc,
                                HashMap<String,String> serverProperties)
                                         throws Exception

This checks to see if the mail service already exists and has the same settings as those found in the given properties. THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321. ONCE AS7 DOES THIS, THIS METHOD CAN GO AWAY.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the mail service settings

Returns:

true if the mail service exists with the same settings

Throws:

Exception

isSameDatasourceSecurityDomainExisting

public static boolean isSameDatasourceSecurityDomainExisting(org.jboss.as.controller.client.ModelControllerClient mcc,
                                             HashMap<String,String> serverProperties)
                                                      throws Exception

This checks to see if the security domain for the datasources already exists and has the same username/password as those found in the given properties THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321. ONCE AS7 DOES THIS, THIS METHOD CAN GO AWAY.

Parameters:

mcc - the JBossAS management client

serverProperties - contains the obfuscated password and username to compare

Returns:

true if the domain exists with the same username and password

Throws:

Exception

isSameWebConnectorsExisting

public static boolean isSameWebConnectorsExisting(org.jboss.as.controller.client.ModelControllerClient mcc,
                                  String appServerConfigDir,
                                  HashMap<String,String> serverProperties)
                                           throws Exception

This checks to see if the web connectors already exist and have the same settings as those found in the given properties THIS IS ONLY HERE TO SUPPORT INSTALLER --reconfig OPTION WHICH SHOULD GO AWAY ONCE AS7 SUPPORTS EXPRESSIONS WHERE WE NEED THEM - JIRA AS7-5321. ONCE AS7 DOES THIS, THIS METHOD CAN GO AWAY.

Parameters:

mcc - the JBossAS management client

configDirStr - location of a configuration directory where the keystore is to be stored

serverProperties - contains the obfuscated password and username to compare

Returns:

true if the domain exists with the same username and password

Throws:

Exception