Public Member Functions
	CentralRepoDbManager ()

void	clearStatus ()

boolean	createDb () throws CentralRepoException

PostgresCentralRepoSettings	getDbSettingsMultiUser ()

PostgresCentralRepoSettings	getDbSettingsPostgres ()

SqliteCentralRepoSettings	getDbSettingsSqlite ()

CentralRepoDbChoice	getSelectedDbChoice ()

DatabaseTestResult	getStatus ()

void	saveNewCentralRepo () throws CentralRepoException

void	setSelctedDbChoice (CentralRepoDbChoice newSelected)

void	setupDefaultSqliteDb () throws CentralRepoException

void	setupPostgresDb (CentralRepoDbChoice choice) throws CentralRepoException

boolean	testDatabaseSettingsAreValid (String tbDbHostname, String tbDbPort, String tbDbUsername, String tfDatabasePath, String jpDbPassword) throws CentralRepoException, NumberFormatException

DatabaseTestResult	testStatus ()

boolean	wasConfigurationChanged ()

Static Public Member Functions
static void	addPropertyChangeListener (PropertyChangeListener listener)

static void	disableDueToFailure ()

static CentralRepoDbChoice	getSavedDbChoice ()

static boolean	isDisabledDueToFailure ()

static boolean	isPostgresMultiuserAllowed ()

static void	removePropertyChangeListener (PropertyChangeListener listener)

static CentralRepoDbChoice	saveDbChoice (CentralRepoDbChoice choice)

static CentralRepoDbChoice	saveDbChoice (CentralRepoDbChoice choice, boolean clearDisabledDueToError)

static void	upgradeDatabase () throws CentralRepoException

Private Member Functions
RdbmsCentralRepoFactory	getDbFactory () throws CentralRepoException

CentralRepoDbConnectivityManager	getSelectedSettings () throws CentralRepoException

Static Private Member Functions
static CentralRepoDbChoice	fromKey (String keyName)

static CoordinationService.Lock	obtainCentralRepoLock (CentralRepository db) throws CentralRepoException

static CentralRepository	obtainCentralRepository () throws CentralRepoException

static void	onUpgradeError (String message, String desc, Exception innerException) throws CentralRepoException

static void	setDisabledDueToFailure (boolean disabledDueToFailure)

static void	updatedDbSchema (CentralRepository db, CoordinationService.Lock lock) throws CentralRepoException

Private Attributes
boolean	configurationChanged = false

final PostgresCentralRepoSettings	dbSettingsMultiUser

final PostgresCentralRepoSettings	dbSettingsPostgres

final SqliteCentralRepoSettings	dbSettingsSqlite

CentralRepoDbChoice	selectedDbChoice

DatabaseTestResult	testingStatus

Static Private Attributes
static final String	CENTRAL_REPO_DB_NAME = "central_repository"

static final String	CENTRAL_REPOSITORY_SETTINGS_KEY = CentralRepoSettings.getInstance().getModuleSettingsKey()

static final String	DB_SELECTED_PLATFORM_KEY = "db.selectedPlatform"

static final Object	dbChoiceLock = new Object()

static final String	DISABLED_DUE_TO_FAILURE_KEY = "disabledDueToFailure"

static final Object	disabledDueToFailureLock = new Object()

static final Logger	logger = Logger.getLogger(CentralRepoDbManager.class.getName())

static final PropertyChangeSupport	propertyChangeSupport = new PropertyChangeSupport(CentralRepoDbManager.class)

static volatile CentralRepoDbChoice	savedChoice = null

Detailed Description

This class contains business logic for saving and validating settings for central repository.

Definition at line 37 of file CentralRepoDbManager.java.

Constructor & Destructor Documentation

org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.CentralRepoDbManager ( )

Definition at line 325 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.PostgresSettingsLoader.CUSTOM_SETTINGS_LOADER, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSavedDbChoice(), and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresSettingsLoader.MULTIUSER_SETTINGS_LOADER.

Member Function Documentation

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.addPropertyChangeListener ( PropertyChangeListener listener )

static

This method adds a property change listener. NOTE: currently only listening for changes in currently saved db choice and disabling due to failure.

Parameters

listener The listener for the event.

Definition at line 173 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.GlobalSettingsPanel.setupSettingsChangeListeners().

void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.clearStatus ( )

This method clears the current database testing status.

Definition at line 573 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.DatabaseTestResult.UNTESTED.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.TextBoxChangedListener.changedUpdate(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.customizeComponents(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.TextBoxChangedListener.insertUpdate(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.TextBoxChangedListener.removeUpdate().

boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.createDb ( ) throws CentralRepoException

This method creates a central repo database if it does not already exist.

Returns: True if successful; false if unsuccessful.

Exceptions

CentralRepoException

Definition at line 464 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.promptCreateDatabase(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupDefaultSqliteDb(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupPostgresDb().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.disableDueToFailure ( )

static

This method disables the central repository and indicates through a flag that this was due to a failure during database setup. This is used when re-enabling multi-user as a flag to determine whether or not CR should be re-enabled.

Definition at line 131 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setDisabledDueToFailure(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbUtil.setUseCentralRepo().

static CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.fromKey ( String keyName )

staticprivate

Definition at line 186 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.DISABLED.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSavedDbChoice().

RdbmsCentralRepoFactory org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbFactory ( ) throws CentralRepoException

private

Definition at line 440 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoPlatforms.POSTGRESQL, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.POSTGRESQL_CUSTOM, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.POSTGRESQL_MULTIUSER, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoPlatforms.SQLITE, and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.SQLITE.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.createDb().

PostgresCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsMultiUser ( )

This method retrieves the current multi-user database settings.

Returns: The current multi-user database settings.

Definition at line 337 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsMultiUser.

PostgresCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsPostgres ( )

This method retrieves the current custom postgres database settings.

Returns: The current custom postgres database settings.

Definition at line 346 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsPostgres.

Referenced by org.sleuthkit.autopsy.integrationtesting.IntegrationTestService.pushCentralRepoSettings(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.updatePostgresFields().

SqliteCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsSqlite ( )

This method returns the current SQLite database settings for central repository.

Returns: The current SQLite database settings

Definition at line 356 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsSqlite.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.bnDatabasePathFileOpenActionPerformed(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.updateSqliteFields().

static CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSavedDbChoice ( )

static

This method loads the selectedPlatform boolean from the config file if it is set.

Definition at line 114 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbChoiceLock, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.fromKey(), org.sleuthkit.autopsy.coreutils.ModuleSettings.getConfigSetting(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.savedChoice.

CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedDbChoice ( )

This method retrieves the currently selected database choice. NOTE: This choice may not align with the saved setting.

Returns: The currently selected database choice.

Definition at line 566 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.selectedDbChoice.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.changeDbSelection(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.customizeComponents(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.databaseFieldsArePopulated(), org.sleuthkit.autopsy.integrationtesting.IntegrationTestService.getCurrentChoice(), org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.onPromptStatusError(), org.sleuthkit.autopsy.integrationtesting.IntegrationTestService.pushCurrentCrChoice(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.setupDbChoice().

CentralRepoDbConnectivityManager org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedSettings ( ) throws CentralRepoException

private

Definition at line 423 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsMultiUser, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsPostgres, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsSqlite, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.POSTGRESQL_CUSTOM, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.POSTGRESQL_MULTIUSER, and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.SQLITE.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.createDb(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveNewCentralRepo(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testStatus().

DatabaseTestResult org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getStatus ( )

This method retrieves the current status. Note: this could be a dirty value if testing of the connection has not been performed.

Returns: The current status of the database connection.

Definition at line 556 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testingStatus.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.promptTestStatusWarnings().

static boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.isDisabledDueToFailure ( )

static

This method retrieves setting whether or not the repository has been disabled due to a database setup issue; this is used when re-enabling multi-user as a flag to determine whether or not CR should be re-enabled.

Returns: Whether or not the repository has been disabled due to a database setup issue.

Definition at line 160 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.disabledDueToFailureLock, and org.sleuthkit.autopsy.coreutils.ModuleSettings.getConfigSetting().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setDisabledDueToFailure().

static boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.isPostgresMultiuserAllowed ( )

static

This method indicates whether or not 'PostgreSQL using multi-user settings' is a valid option.

Returns: True if 'PostgreSQL using multi-user settings' is valid.

Definition at line 98 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.core.UserPreferences.getIsMultiUserModeEnabled(), org.sleuthkit.autopsy.centralrepository.datamodel.PostgresSettingsLoader.MULTIUSER_SETTINGS_LOADER, org.sleuthkit.autopsy.centralrepository.datamodel.DatabaseTestResult.TESTED_OK, and org.sleuthkit.autopsy.centralrepository.datamodel.PostgresCentralRepoSettings.testStatus().

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.isDbChoiceSelectable().

static CoordinationService.Lock org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepoLock ( CentralRepository db ) throws CentralRepoException

staticprivate

This method obtains a central repository lock.

Parameters

db	The database connection.

Returns: The lock if acquired.

Exceptions

CentralRepoException

Definition at line 226 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.upgradeDatabase().

static CentralRepository org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepository ( ) throws CentralRepoException

staticprivate

This method obtains the database connectivity for central repository.

Returns: The CentralRepository object that will be used for connection.

Exceptions

CentralRepoException

Definition at line 203 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepository.getInstance(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.upgradeDatabase().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError	(	String	message,
		String	desc,
		Exception	innerException
	)		throws CentralRepoException

staticprivate

Definition at line 299 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepository.getInstance(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveDbChoice(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepository.shutdownConnections().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepoLock(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepository(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.updatedDbSchema(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.upgradeDatabase().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.removePropertyChangeListener ( PropertyChangeListener listener )

static

This method removes a propert change listener.

Parameters

listener The listener to remove.

Definition at line 182 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.GlobalSettingsPanel.setupSettingsChangeListeners().

static CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveDbChoice ( CentralRepoDbChoice choice )

static

This saves the currently selected database choice and clears any disabledDueToFailure flag.

Parameters

choice The choice to save.

Returns: The newly saved choice.

Definition at line 61 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.GlobalSettingsPanel.onMultiUserChange(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveNewCentralRepo().

static CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveDbChoice	(	CentralRepoDbChoice	choice,
		boolean	clearDisabledDueToError
	)

static

This saves the currently selected database choice.

Parameters

choice	The choice to save.
clearDisabledDueToError	Whether or not to clear the 'disabledDueToFailure' settings key.

Returns: The newly saved choice.

Definition at line 74 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbChoiceLock, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.DISABLED, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbChoice.getSettingKey(), org.sleuthkit.autopsy.coreutils.ModuleSettings.setConfigSetting(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setDisabledDueToFailure().

void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveNewCentralRepo ( ) throws CentralRepoException

This method saves a new central repository based on current settings.

We have to shutdown the previous platform's connection pool first; assuming it wasn't DISABLED. This will close any existing idle connections.

The next use of an EamDb API method will start a new connection pool using those new settings.

Definition at line 506 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.integrationtesting.IntegrationTestService.pushCurrentCrChoice(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupDefaultSqliteDb(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupPostgresDb(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.testStatusAndCreate().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setDisabledDueToFailure ( boolean disabledDueToFailure )

staticprivate

This method sets whether or not the repository has been disabled due to a database setup issue; This is used when re-enabling multi-user as a flag to determine whether or not CR should be re-enabled.

Parameters

disabledDueToFailure Whether or not the repository has been disabled due to a database setup issue.

Definition at line 144 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.disabledDueToFailureLock, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.isDisabledDueToFailure(), and org.sleuthkit.autopsy.coreutils.ModuleSettings.setConfigSetting().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.disableDueToFailure(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveDbChoice().

void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setSelctedDbChoice ( CentralRepoDbChoice newSelected )

This method sets the currently selected database choice and sets the testing status to untested.

Parameters

newSelected The new database choice.

Definition at line 583 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.DatabaseTestResult.UNTESTED.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.changeDbSelection(), and org.sleuthkit.autopsy.integrationtesting.IntegrationTestService.pushCurrentCrChoice().

void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupDefaultSqliteDb ( ) throws CentralRepoException

This method sets up the sqlite database with default settings.

Exceptions

CentralRepoException if unable to successfully set up database.

Definition at line 365 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.Installer.setupDefaultCentralRepository().

void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupPostgresDb ( CentralRepoDbChoice choice ) throws CentralRepoException

Set up a PostgresDb using the settings for the given database choice enum.

Parameters

choice Type of postgres DB to set up

Exceptions

CentralRepoException

Definition at line 394 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.createDb(), org.sleuthkit.autopsy.centralrepository.datamodel.DatabaseTestResult.DB_DOES_NOT_EXIST, org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveNewCentralRepo(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbUtil.setUseCentralRepo(), org.sleuthkit.autopsy.centralrepository.datamodel.DatabaseTestResult.TESTED_OK, and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testStatus().

Referenced by org.sleuthkit.autopsy.centralrepository.eventlisteners.Installer.setupDefaultCentralRepository().

boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testDatabaseSettingsAreValid	(	String	tbDbHostname,
		String	tbDbPort,
		String	tbDbUsername,
		String	tfDatabasePath,
		String	jpDbPassword
	)		throws CentralRepoException, NumberFormatException

This method tests whether or not the settings have been filled in for the UI. NOTE: This does not check the connectivity status of these settings.

Returns: True if database settings are valid.

Definition at line 594 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.databaseSettingsAreValid().

DatabaseTestResult org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testStatus ( )

This method tests the current database settings to see if a valid connection can be made.

Returns: The result of testing the connection.

Definition at line 620 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedSettings(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testingStatus, and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbConnectivityManager.testStatus().

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.promptCreateDatabase(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupDefaultSqliteDb(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setupPostgresDb(), org.sleuthkit.autopsy.centralrepository.optionspanel.GlobalSettingsPanel.testCurrentConfiguration(), and org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.testStatusAndCreate().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.updatedDbSchema	(	CentralRepository	db,
		CoordinationService.Lock	lock
	)		throws CentralRepoException

staticprivate

This method updates the central repository schema if necessary.

Parameters

db	The database connectivity object.
lock	The acquired lock.

Exceptions

CentralRepoException

Definition at line 251 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.exceptions.AutopsyException.getUserMessage(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepository.upgradeSchema().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.upgradeDatabase().

static void org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.upgradeDatabase ( ) throws CentralRepoException

static

This method upgrades the current Central Reposity schema to the newest version. If the upgrade fails, the Central Repository will be disabled and the current settings will be cleared.

Definition at line 282 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepository.isEnabled(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepoLock(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.obtainCentralRepository(), org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.onUpgradeError(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.updatedDbSchema().

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepositoryService.updateSchema().

boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.wasConfigurationChanged ( )

This method returns if changes to the central repository configuration were successfully applied.

Returns: Returns true if the database configuration was successfully changed false if it was not.

Definition at line 419 of file CentralRepoDbManager.java.

References org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.configurationChanged.

Referenced by org.sleuthkit.autopsy.centralrepository.optionspanel.EamDbSettingsDialog.wasConfigurationChanged().

Member Data Documentation

final String org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.CENTRAL_REPO_DB_NAME = "central_repository"

staticprivate

Definition at line 41 of file CentralRepoDbManager.java.

final String org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.CENTRAL_REPOSITORY_SETTINGS_KEY = CentralRepoSettings.getInstance().getModuleSettingsKey()

staticprivate

Definition at line 42 of file CentralRepoDbManager.java.

boolean org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.configurationChanged = false

private

Definition at line 323 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.wasConfigurationChanged().

final String org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.DB_SELECTED_PLATFORM_KEY = "db.selectedPlatform"

staticprivate

Definition at line 43 of file CentralRepoDbManager.java.

final Object org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbChoiceLock = new Object()

staticprivate

Definition at line 50 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSavedDbChoice(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.saveDbChoice().

final PostgresCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsMultiUser

private

Definition at line 320 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsMultiUser(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedSettings().

final PostgresCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsPostgres

private

Definition at line 319 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsPostgres(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedSettings().

final SqliteCentralRepoSettings org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.dbSettingsSqlite

private

Definition at line 321 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getDbSettingsSqlite(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedSettings().

final String org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.DISABLED_DUE_TO_FAILURE_KEY = "disabledDueToFailure"

staticprivate

Definition at line 44 of file CentralRepoDbManager.java.

final Object org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.disabledDueToFailureLock = new Object()

staticprivate

Definition at line 51 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.isDisabledDueToFailure(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.setDisabledDueToFailure().

final Logger org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.logger = Logger.getLogger(CentralRepoDbManager.class.getName())

staticprivate

Definition at line 39 of file CentralRepoDbManager.java.

final PropertyChangeSupport org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.propertyChangeSupport = new PropertyChangeSupport(CentralRepoDbManager.class)

staticprivate

Definition at line 48 of file CentralRepoDbManager.java.

volatile CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.savedChoice = null

staticprivate

Definition at line 46 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSavedDbChoice().

CentralRepoDbChoice org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.selectedDbChoice

private

Definition at line 317 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getSelectedDbChoice().

DatabaseTestResult org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testingStatus

private

Definition at line 316 of file CentralRepoDbManager.java.

Referenced by org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.getStatus(), and org.sleuthkit.autopsy.centralrepository.datamodel.CentralRepoDbManager.testStatus().

The documentation for this class was generated from the following file:

/home/carriersleuth/repos/autopsy/Core/src/org/sleuthkit/autopsy/centralrepository/datamodel/CentralRepoDbManager.java

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation