ConfigureToolset.exe

From Dragon Age Toolset Wiki
(Redirected from Configure Toolset)
Jump to: navigation, search

The external configuration utility is used to configure the toolset's database connection and to tell the toolset where the game's executable is and which server and database to connect to. You shouldn't need to run the configuration utility during routine usage of the toolset, and if the defaults set up by your installer work you may never need to run it at all.

Occasions you need to use Configure Toolset

  1. If you get an error when attempting to start the toolset stating Location of game build build either not specified or the update program was never run to copy the build onto your computer, you need to run Configure toolset to rectify the problem.
  2. You are troubleshooting the unable to connect to the database issue, and have determined that you have a working instance of SQL Server installed and that the database is restored correctly. Here you can make sure that the toolset is pointed in the right direction
  3. Switch between databases. If you have set up multiple instances of SQL Server or have multiple databases set up in an instance of SQL Server, you can use this utility to switch between them.

Location

To run Configure Toolset, navigate to the directory where you have installed the toolset. Typically the location would be something like:

C:\Program Files\Dragon Age\Tools\

In the Tools directory, double click on ConfigureToolset.exe to launch the utility.

There are two screens available on the Utility:

  1. Game Builds
  2. Databases
  3. Property Page

The functions of each are explained in the sections below.

Game Builds

When the toolset starts up, it looks for the existence of the game. This screen is where you specify the location for the toolset to look for the game.


Win32 Game Build

This field points to the directory where Dragon Age is installed. Either type the path into this field, or click on the ellipsis button (Ellipsis.png) next to it to browse to the directory. Set the value of this field to the location of the installed game, typically, it should be something like: C:\Program Files\Dragon Age

Alternate Game Build

Community users will not generally have need to do anything with this field. As a general rule, leave it unchecked and blank.

The toolset can keep an alternate location in sync with your current game build override. This location can be another directory on the same machine, a different machine or a network location. To enable this function, check the "Enable alternate game build" checkbox. With that option checked, enter or browse for a location that you wish to use as your alternate game build. Whenever you do an export from the toolset, once the export is finished, it will then synchronize all the export files to the path specified.

Databases

Databases window.png

Default Database Settings

If you leave the "Use the default database" checkbox checked, the toolset will try to connect to the standard location. If your toolset is currently able to connect to the database, and you are not trying to connect it to another database, just leave this checkbox checked.

Custom Database Settings

For advanced configuration, uncheck the "Use the default database" checkbox and then click on the ellipsis button (Ellipsis.png) to open the data link properties window. The Data Link Properties window open. This window can be used to connect to different Servers or instances and to different databases on a selected server.

Data Link Properties Window.png

You should only need to make changes on the "Connection" tab, only make changes on the other tabs if you know what you are doing.

1. Select or enter a server name:

This field shows which database you are connecting to. In a default installation, this should display .\BWDATOOLSET
If you have done a manual installation of SQL Server, this value will likely need to be changed to .\SQLEXPRESS as that is the default on a manual installation. The dropdown list does not always populate properly, so you may just need to type in the correct entry here.

2. Enter information to log on to the server:

Unless you changed this option while installing SQL Server manually, this field should be left as is with the "Use Windows NT Integrated Security" selected. This is the default setting when SQL is installed by the toolset, and also if you accept the defaults on a manual installation.

3. Select the database on the server

Make sure "Select the database on the server" is checked. Select "bw_dragonage_content" from this list.
note: If you have created a different database, or restored your database to a different name, select or type it in this box. If you have multiple databases set up on the server, this is how you switch which one the toolset is using.

When you have finished changes on this window, press the "Test Connection" button. If you get the message "Test connection succeeded" then you should be good to carry on. Hit the OK button.

Note that you may need to set a registry key manually when changing database settings. See Bug: ConfigureToolset application fails to set a registry key.

Property Page

This is just the wrap up page. Push the appropriate button.

  • Back sends you back into the utility
  • Finish saves your changes and closes the utility
  • Cancel aborts your changes without saving them and closes the utility