Command Line Reference

To invoke fmsadmin from the command line, youll need to supply three pieces of information. Youll need the name of the tool itself (fmsadmin, assuming it is accessible by an existing path; otherwise, the full path to the tool must be specified). Youll need the name of a particular command to invoke (such as "backup" to back up files or "close" to close files). And you may need one or more options that give further specificity to the command. An example would be

 fmsadmin close -m "All files closing" -t 120


This command would close all files on the server after a two-minute (120-second) grace period, and send all connected clients a warning saying "All files closing."

FileMaker Server Command Line Reference

In the reference that follows, we list the name of each command, along with a description, a general usage template, one or more examples, and explanations of any applicable options. Some of the options are specific to only one or two commands, but most are applicable across several commands.

backup

fmsadmin backup [file...] [path...] [-diopuwy] 


Description:

The backup command can be used to back up a single file, all the files in a directory, or all the files hosted by a single instance of FileMaker Server. The backup command can be used alone, in which case it performs a "live" or "hot" backup of the specified files. It can also be used in conjunction with the pause and resume commands. Though this method will interfere with user access to the files, it will also allow the backup to complete more quickly. The pause-backup-resume usage mimics the backup behavior of FileMaker Server 5.5.

Examples:

 fmsadmin backup Products.fp7

 fmsadmin backup /Products -d E:FileMaker_Backups


Options:

-d PATH, --dest PATH

Specify a destination path for a backup.

-i address, --ip address

Specify the IP address of a remote server.

-o, --offline

Perform an offline backup.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


close

fmsadmin close [file...] [path...] [-imptuwy] 


Description:

This command closes one or more database files. It can be used to close a specific file, all the files in a directory, or all files on the server.

Examples:

 fmsadmin close

 fmsadmin close -y

 fmsadmin close -y Products.fp7

 fmsadmin close -y "Invoice Items.fp7"


Options:

-i address, --ip address

Specify the IP address of a remote server.

-m message, --message message

Specify a text message to send to clients.

-p pass, --password pass

Password to use to authenticate with the server.

-t, --grace-time

Specify time in seconds before clients will be forcibly disconnected.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


delete

fmsadmin delete schedule [schedule #] [-ipuwy] 


Description:

This command deletes a specific schedule, referenced by its schedule number. Schedule numbers can be determined using the list schedules command.

Examples:

 fmsadmin delete schedule 1

 fmsadmin delete schedule 3 --wait 5 -y


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


disable

fmsadmin disable type [plug-in #] [schedule #] [-ipuwy] 


Description:

This command is used to disable server-side plug-ins or schedules. Plug-ins and schedules are referenced by number. The numbers can be determined by using the list schedules or list plugins commands.

Examples:

 fmsadmin disable plugin 3 -y

 fmsadmin disable schedule 1 y


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


disconnect

fmsadmin disconnect client [client #] [-impuwy] 


Description:

This command is used to disconnect a specific client. Clients are referenced by client number. Client numbers can be determined by using the list clients command. A specific message can be sent to the client(s) as well.

Examples:

 fmsadmin disconnect client 13 -y

 fmsadmin disconnect client 12 -m "Its time for lunch, Sarah" -y


Options:

-i address, --ip address

Specify the IP address of a remote server.

-m message, --message message

Specify a text message to send to clients.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


enable

fmsadmin enable type [plug-in #] [schedule #][-ipuwy] 


Description:

This command is used to enable plug-ins or schedules. Plug-ins and schedules are referenced by number. The numbers can be determined by using the list schedules or list plugins commands.

Examples:

 fmsadmin enable schedule 3

 fmasdmin enable plugin 1


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


Help

fmsadmin help [command] 


Description:

This command will display help information on the command line commands and syntax.

Examples:

 fmsadmin help options

 fmsadmin help commands

 fmsadmin help resume


Options:

None

list

fmsadmin list type [-ipsuwy] 


Description:

This command can be used to obtain a list of clients, files, plug-ins, or schedules from the server. Among other things, this command will return item numbers that are necessary for other commands such as enable schedule and similar commands.

Examples:

 fmsadmin list clients

 fmsadmin list plugins


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-s, --stats

Return additional detail about clients or files.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


open

fmsadmin open [file...] [path...] [-ipuwy] 


Description:

This command is used to open databases. Like the close command, it can be used to open all files on the server, all files within a single directory, or a single named file.

Examples:

 fmsadmin open Clinic.fp7

 fmsadmin open -y

 fmsadmin open /ClinicFiles


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


pause

fmsadmin pause [file...] [path...] [-ipuwy] 


Description:

This command is used to pause databases. Like the open and close commands, it can be used to affect all files on the server, all files within a single directory, or a single named file.

Examples:

 fmsadmin pause -y

 fmsadmin pause --wait 30 y


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


reload

fmsadmin reload [-ipuvwy] 


Description:

This command reloads the server configuration. Any unsaved properties will be replaced with the most recently stored values for those properties.

Examples:

 fmsadmin reload


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


resume

fmsadmin resume [file...][path...] [-ipuwy] 


Description:

This command is used to resume databases that have been paused. Like the open and close commands, it can be used to affect all files on the server, all files within a single directory, or a single named file.

Examples:

 fmsadmin resume -y

 fmsadmin resume "Clinic.fp7"


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


run

fmsadmin run schedule [schedule #] [-ipuwy] 


Description:

This command is used to run a schedule, specified by number. Schedule numbers can be obtained by using the list schedules command.

Examples:

 fms admin run schedule 3


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


send

fmsadmin send [-cimpuwy] [client #] [file...] [path...] 


Description:

This command can be used to send a text message to all clients. The command can be used to affect all clients connected to the server, or limited to just those clients connected to files in a specific path, or to a single specific file, or to a single client specified by number. Unlike other commands, with send you must use the -c option when specifying a client number.

Examples:

 fmsadmin send -m "The server will shut down for maintenance in 15 minutes."

 fmsadmin send -c 17 -m "Fred, its time to go home."

 fmsadmin send "Clinics.fp7" -m "The Clinics file will shut down in 5 minutes."


Options:

-c, --client

Used to specify a client number.

-i address, --ip address

Specify the IP address of a remote server.

-m message, --message message

Specify a text message to send to clients.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


status

fmsadmin status type [-ipuwy] [id #] [file] 


Description:

This command is used to determine the status of a client or a file.

Examples:

 fmsadmin status file "Clinics.fp7"

 fmsadmin status client 30


Options:

-i address, --ip address

Specify the IP address of a remote server.

-p pass, --password pass

Password to use to authenticate with the server.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.


stop

fmsadmin stop [-fimptuwy] 


Description:

This command will stop the server process. All connected users will have 30 seconds to close their open files. This grace period can be changed using the -t option.

Examples:

 fmsadmin stop

 fmsadmin stop -f

 fmsadmin stop -t 120 -m "The server will shut down in two minutes."


Options:

-f, --force

Close databases or shut down the server forcefully, without waiting for clients to disconnect gracefully.

-i address, --ip address

Specify the IP address of a remote server.

-m message, --message message

Specify a text message to send to clients.

-p pass, --password pass

Password to use to authenticate with the server.

-t, --grace-time

Specify time in seconds before clients will be forcibly disconnected.

-u user, --user user

Username to use to authenticate with the server.

-w seconds, --wait seconds

Specify time in seconds for command to time out.

-y, --yes

Automatically answer "yes" to all prompts.




: FileMaker Specifications

FileMaker 8 Product Line

Specifications and Storage Limits

Field Types and Import/Export Formats

: Calculation Functions

Working with Calculations Primer

Calculation Signatures

Calculation Functions

: Custom Functions

Custom Functions Primer

Useful Custom Functions

: Script Steps

Scripting Primer

Script Step Reference

: Quick Reference

FileMaker Error Codes

FileMaker Keyboard Shortcuts

FileMaker Network Ports

FileMaker Server Command Line Reference

FileMaker XML Reference

: Other Resources

Where to Go for More Information



FileMaker 8 Functions and Scripts Desk Reference
FileMaker 8 Functions and Scripts Desk Reference
ISBN: 0789735113
EAN: 2147483647
Year: 2004
Pages: 352

Flylib.com © 2008-2020.
If you may any questions please contact us: flylib@qtcs.net