DSMAINT

Use dsmaint to configure the IMA data store for a MetaFrame XP server farm.

When using this command, user names and passwords may be case-sensitive,depending on the database product you are using and the operating system it runs on.

Syntax

dsmaint config [/user:username] [/pwd:password] [/dsn:filename]

dsmaint backup destination_path

dsmaint failover direct_server

dsmaint compactdb [/ds] [/lhc]

dsmaint migrate [{ /srcdsn:dsn1 /srcuser:user1 /srcpwd:pwd1}] [{/dstdsn:dsn2

/dstuser:user2 /dstpwd:pwd2}]

dsmaint publishsqlds {/user:username /pwd:password}

dsmaint recover

dsmaint recreatelhc

dsmaint [/?]

Options

config

Changes configuration parameters used by IMA to connect to the data store.

/user:username

The username to connect to a data store.

/pwd:password

The password to connect to a data store.

/dsn:filename

The filename of an IMA data store.

backup

Creates a backup copy of the Access database that is the farm’s data store. Run this command on the server that hosts the data store. Requires a path or share point to which the database file will be copied. The backup command cannot be used to create backups for Oracle or SQL data stores.

failover

Switches the server to use a new direct server for IMA data store operations.

compactdb

Compacts the Access database file.

/ds

Specifies the database is to be compacted immediately. If the IMA service is running, this can be executed from the direct server or an indirect server.

If the IMA service is not running, this can be executed only on the direct server.

/lhc

Specifies the local host cache is to be compacted immediately.

migrate

Migrate data from one data store to another. Use this command to move a data store to another server, rename a data store in the event of a server name change, or migrate the data store to an Oracle or SQL Server database.

Appendix A MetaFrame XP Commands 345

/srcdsn:dsn1

The name of the data store from which to migrate data.

/srcuser:user1

The user name to use to connect to the data store from which the data is migrating.

/srcpwd:pwd1

The password to use to connect to the date store from which the data is migrating.

/dstdsn:dsn2

The name of the data store to which to migrate the data.

/dstuser:user2

The user name that allows you to connect to the data store to which you are migrating the source data store.

/dstpwd:pwd2

The password that allows you to connect to the data store to which you are migrating the source data store.

publishsqlds

Publishes a MetaFrame data store to allow replication.

recover

Restores an Access data store to its last known good state. This must be executed on the direct server while the IMA service is not running.

recreatelhc

Recreates the local host cache database.

/?

Displays the syntax for the utility and information about the utility’s options.

Remarks

compactdb

During database compaction, the database is temporarily unavailable for both reading and writing. The compaction time can vary from a few seconds to a few minutes, depending on the size of the database and the usage.

config

For Access databases, this command resets the password used to protect the database, setting the matched security context to allow IMA access to this database.

You must stop the IMA service before using config with the /pwd option.

By default, the Access database does not have a user name or password. When migrating a database from Access, leave the /srcuser: and /srcpwd: parameters blank.