Executing configuration commands at startup

Executing configuration commands at startup

Dynamics AX 4.0

Configuration commands set the options that are used when the kernel run by a Microsoft Dynamics AX client or an Application Object Server (AOS) instance starts. Configuration options can be changed with the user interface in the Client or Server Configuration Utilities.

Configuration commands can be run directly from the following locations:

  • In the Configuration Command to run at kernel startup field in the configuration utility dialog boxes.

  • From a command prompt when starting a client or AOS instance.

  • In a configuration file.

For detailed lists of configuration commands and their syntax, see the following topics:

  1. In either configuration utility, you can run a configuration command from the Configuration Command to run at kernel startup field. Use this method to set options that are not available from the user interface.

NoteNote

No syntax checking is performed before configuration commands are passed to the Microsoft Dynamics AX kernel from the configuration utilities. A bad command can disable your system. Test any command before using it.


  1. Open either the Client Configuration Utility (Start > All Programs > Control Panel > Administration > Microsoft Dynamics AX Configuration Utility) or the Server Configuration Utility (Start > All Programs > Control Panel > Administration > Microsoft Dynamics AX Server Configuration Utility).

  2. In the Configuration Command to run at kernel startup field, enter a configuration command in the format -command=value.

    To enter more than one command, leave a space between commands. For example: -command=value -command2=value

  3. Save the configuration, and close the configuration utility.

    The configuration option that is set in the Configuration Command to run at kernel startup field is only set for the current instance of the kernel: it overrides the corresponding value in the registry or configuration file, but does not change it.

If you start a client or AOS instance from a command prompt, you can pass configuration commands to be used as the instance starts.

  1. Open a command prompt (Start > All Programs > Accessories > Command Prompt), and navigate to the directory in which Microsoft Dynamics AX is installed.

  2. Type Ax32.exe followed by a configuration command. For example:

    Ax32.exe -command=value

    Microsoft Dynamics AX starts.

    The configuration option that is set using the command is only set for the current instance of the kernel: it overrides the corresponding value in the registry or configuration file, but does not change it.

  1. If you are not using a configuration file, open either the Client Configuration Utility (Start > All Programs > Control Panel > Administration > Microsoft Dynamics AX Configuration Utility) or the Server Configuration Utility (Start > All Programs > Control Panel > Administration > Microsoft Dynamics AX Server Configuration Utility).

  2. Click Manage, and then click Save configuration to a file. Choose a location and name for the configuration file, and then click Save.

    The file is saved with an .axc extension.

  3. Close the configuration utility.

  4. Open the client configuration file you are using with a text editor, such as Microsoft Notepad.

  5. Edit any configuration command that you want to change the value of, or add a configuration command that does not have an interface element. Use commands in the format command,datatype,value.

  6. Save and close the configuration file.

  7. Close any client or AOS that is using the configuration file, and then restart.

Show:
© 2016 Microsoft