User Client Options

User Client Options
Prev	Appendix A. Tools (Advanced)	Next

The user client is used to display user balances, system notifications and request information from the users. This is discussed in more detail in Chapter 6, User Client. The user client implements a number of command-line options that change it's behavior.

Option Description

Option	Description
`--silent`	The silent option tells the client not to report errors if it has problems connecting to the server. If the server is unavailable at time of startup (e.g. the client is not connected to the network), or if the user does not currently exist in the database, the client will simply sleep waiting for the condition to change.
`--minimized`	The minimized option tells the client to start minimized. On windows the client will be minimized to the task tray. This option is recommended if the user's balance is not important to the user. For example, if a user is only allowed to assign print jobs to a shared account, then their personal balance is of little importance, so the user client should be minimized.
`--user <username>`	The user option allows the client to be run using a different username. This can be useful if the user is logged into a machine as a different user than he or she is authenticated to the server/printers. For example, if a user is using a laptop that is not a part of the domain.

--silent

The silent option tells the client not to report errors if it has problems connecting to the server. If the server is unavailable at time of startup (e.g. the client is not connected to the network), or if the user does not currently exist in the database, the client will simply sleep waiting for the condition to change.

--minimized

The minimized option tells the client to start minimized. On windows the client will be minimized to the task tray.

This option is recommended if the user's balance is not important to the user. For example, if a user is only allowed to assign print jobs to a shared account, then their personal balance is of little importance, so the user client should be minimized.

--user <username>

The user option allows the client to be run using a different username.

This can be useful if the user is logged into a machine as a different user than he or she is authenticated to the server/printers. For example, if a user is using a laptop that is not a part of the domain.

Table A.2. User Client command-line options

The command-line arguments listed above are usually used in the area/method used to start the client - a login script, shortcut, or the relevant registry key in HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run\.

The command-line arguments may also be set in the config.properties file. This is particularly helpful on Apple Mac systems where command-line arguments are difficult to implement. The config.properties file is located in the same directory as the client executable on Linux and Windows. On the Mac it can be found at:

    [app-dir]/PCClient.app/Contents/Resources/config.properties

Additionally settings may be changed at the user-level by placing a file in the user's Library Preferences folder located at:

    ~/Library/Preferences/PCClient/config.properties

The file should contain the options in a properties file form like:

    user=mary
    minimized=Y

The line starting with user= allows the client to be run using a different username. The minimized= causes the client window to start minimized if set to Y.

Prev	Up	Next
SSL/HTTPS Key Generation	Home	Stopping and Starting the Application Server