MobiLink user authentication utility [mluser]

Registers MobiLink users at the consolidated database. For SQL Anywhere remotes, the users must have previously been created at the remote databases with the CREATE SYNCHRONIZATION USER statement.

Syntax
mluser [ options ] -c "connection-string"
  { -f file | -u user [ -p password ] }

Option

Description

@data

Use this to read in options from the specified environment variable or configuration file. If both exist with the same name, the environment variable is used. See Using configuration files.

If you want to protect passwords or other information in the configuration file, you can use the File Hiding utility to obfuscate the contents of the configuration file. See File Hiding utility (dbfhide).

-c "keyword=value;..."

Use this to supply database connection parameters. The connection string must give the utility permission to connect to the consolidated database using an ODBC data source. This parameter is required.

-d

Deletes the user name(s) specified by -f or -u.

-f filename

Reads the user names and passwords from the specified file. The file should be a text file containing one user name and password pair on each line, separated by white space. You must specify either -f or -u.

-fips When set, mluser fails if FIPS support is not installed.

-o filename

Logs output messages to the specified file.

-ot filename

Truncate the log file and then append output messages to it. The default is to send output to the screen.

-p password

Password to associate with the user. This option can only be used with -u.

-pc collation-id

Supplies a database collation ID for character set conversion of the user name and password. This should be one of the SQL Anywhere collation labels such as those listed in Supported and alternate collations. This option is required when user names and passwords are read from a file that is encoded in a different character set than the default character set determined by locale.

-u ml_username

Specify the user name to add (or delete, if used with -d). Only one user can be specified on a single command line. This option is used with -p if passwords are being used. You must specify either -f or -u.

-v

Specifies verbose logging.

Remarks

Given a user/password pair, the mluser utility first attempts to add the user. If the user has already been added to the consolidated database, it attempts to update the password for that user.

There are alternative ways to register user names in the consolidated database:

  • Use Sybase Central.
  • Specify the -zu+ command line option with mlsrv11. In this case, any existing MobiLink users that have not been added to the consolidated database are added when they first synchronize.

The MobiLink user must already exist in a remote database. To add users at the remote, you have the following options:

  • For SQL Anywhere remotes, set the name with CREATE SYNCHRONIZATION USER and synchronize with that user name.
  • For UltraLite remotes, you can either use the user_name field of the ul_synch_info structure; or in Java, use the SetUserName() method of the ULSynchInfo class before synchronizing.
See also