NAME

pmx-profile - Synchronize resources


SYNOPSIS

    pmx-profile sync-from-db


DESCRIPTION

Use the pmx-profile command to synchronize resources between local and database stores. Typically, you must initialize the resource definitions and their associated instances before synchronizing. To do so, use the following steps:

    pmx-profile init --store=local
    pmx-profile init --store=db --sync
    pmx-profile init-location
    ..
    pmx-profile sync-to-db

Commands

help
Displays help.

init
Initialize the current store with the configuration file specified with the --file option or the default if there is none passed. The default configuration creates the required instances in the current store.

init-location
Register this server as a new location in the database store.

sync-from-db
Copies the contents of the database resources to the local copy.

sync-to-db
Copies the contents of local resources to the database.

list
Lists the defined resource definitions. These are all of the resources known within the system that can be added to individual stores.

contents
Lists the current resources that exist within the current store (as defined by default) or the requested store (as defined by --store).
    pmx-profile contents --store=db

remove
Removes the resource from the current store. The resource name must be passed using the --resource option.

add
Add a resource to the current store. The resource name must be passed using the --resource option.

default
Add or update the current default resource store. The store to change the default to is passed with the --store option.
    pmx-profile default
    pmx-profile default --store=db

clean
Do any required periodic database cleanup that is needed by the resources framework. This includes cleaning of tables required to implement incremental synchronization of resources. This operation should be undertaken at least once per day as routine maintenance. It may be more convenient to use the option form of this command which can be used in conjuction with the sync-from-db command.

status
Display a summary of the resources system and the current version of local resources vs. database resources.

dump
Display the contents of the resources passed with the --resource option.

Options

The following options are recognized:

--store local|db
Which resource store to operate on. By default the db store is operated on.

--file filename
Indicate a filename to use for resource initialization different from the default.

--resource resource name
Restrict the set of resources acted on by the current command to the passed resource name.

--quiet
Suppress all strictly informational messages.

--force
Ignore errors when creating or updating a resource. Note that this option requires you to also specify the resource name to force using the --resource option. This may be required if a local configuration file has syntax errors and you want to sync a new, proper version from the database. For example:
    pmx-profile sync-from-db --resource=enduser_ui_config --force

--all
Ignore the configured import and export sections from resources.conf that define resources to be synchronized. Instead sync all defined resources.

--sync
When initializing the store and adding resource instances by default, synchronize the contents of those resources too.

--clean
Do any required periodic database cleanup that is needed by the resources framework. This includes cleaning of tables required to implement incremental synchronization of resources. This operation should be undertaken at least once per day as routine maintenance. This option can and should be added to any sync-from-db operation.
  pmx-profile sync-to-db --clean


SEE ALSO

PureMessage::Resources::Manager


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.