Analysis Server Command-Line Arguments

Usually the installer program will generate shortcuts and script files to automatically start Analysis Server in the correct way. If you ever need to manually start the Analysis Server or modify the startup scripts, the following information will be useful. On most platforms, the Analysis Server is started using the following command:

java [Java Options] -jar aserver.zip [AServer Options]

On the Windows platform, there is an executable which automatically starts Analysis Server. It is used like this:

aserver.exe [Java Options] [AServer Options]

All Java Options must be of the form -X<option> (this is how the program aserver.exe knows when the Java options end and the Analysis Server Options start). This executable is also used to install Analysis Server as an NT service on Windows NT, 2000, and XP computers. See Running Analysis Server as a Service for more information on this mode.

Java Options

Depending on how Java is installed on your machine, you may want to add some Java options to the command. For a full list of available Java Options, see Sun's Online Documentation at http://java.sun.com/. These are the most commonly used Java options with Analysis Server.

Option	Description
-Xmx256M	By default Java limits the maximum amount of memory that it will ever ask for from the system. This option sets this limit to 256Megabytes.
-native	On UNIX platforms this tells java to use "Native" threads for performance. This option must be the first argument on the command line.

Analysis Server Options

In all cases, optional Analysis Server command-line arguments may be specified to alter the behavior of the Analysis Server.

Argument	Description
-c <config file>	Specifies the Analysis Server configuration file to use. If this option is not specified, the Analysis Server looks for a file named "aserver.conf" in the current directory.
-nonetwork	Tells the Analysis Server that it is running on a machine that is not on the network. Use this option if you are experiencing timeout (long periods of time where the Analysis Server seems to hang) problems. Note that when this option is used, security features are turned off.
-gui	Causes the Analysis Server to display it's graphical user interface.
-debug	Causes the Analysis Server to echo commands sent to it to stdout