How to build the Phoenix Installer: Step by Step

This section will show you how to build the Phoenix Installer.

1. Set Active Configuration

2. Pre-compile the Web Project

Tip:
You are only required to perform this step if there have been changes to the web application or phoenix class libraries.

Skip this Step

To pre-compile the web project, expand and select the Phoenix Web Deployment Project.

Select Build as you normally would.

3. Concatenate the Database scripts

Tip:
You are only required to perform this step if there have been changes to any of the database script (.sql) files.

Skip this Step

The easiest way to concatenate the database scripts is to execute the batch file joinscripts.bat which can be found in the Phoenix.Database project in the Deployment subfolder.

Caution:
This step assumes you have reviewed the joinscripts.bat file.

3.1. Open a Command Line

The easiest way to open a command line is to press + R, and type cmd in the text box.

3.2. Change your current directory to the folder that contains the batch script.

The database deployment folder is located at [Path to your solution]\Phoenix.Database\Deployment.

Figure:Change directory to Phoenix.Database\Deployment

3.3. Execute the joinscripts batch file

Type joinscripts and press Enter.

Figure:Output from Joinscripts.bat

The sql scripts will be joined and copied into the configured locations if all went well.

4. Build the NodeConfigTool tool

Expand and select the NodeConfigTool project in Visual Studio.

Select Build as you normally would.

Visual Studio will launch the prebuild application.

Important Note:

Pay attention to any warnings or errors that prebuild displays in the console.

CopyExample of Output from prebuild
This PreBuild console application will:
1. Delete all unecessary files (bin/xml, bin/pdb, flashsource/
2. Reset appSettings.config to factory settings
3. Reset web.config to factory settings
4. Zip the web-application to PhoenixWeb.zip
5. Compress and check the timestamps of the Sql scripts


[1] Deleting non-essential files
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Microsoft.ApplicationBlocks.Data.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.BLL.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.DAL.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.Resources.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.UI.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.Utilities.xml
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.BLL.pdb
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.DAL.pdb
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.Resources.pdb
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.UI.pdb
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.Utilities.pdb
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\bin\Phoenix.Resources.resources.dll
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\appSettings.config.default
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\web.config.default.2.0
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\web.config.default.3.5
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\MapExplorer\MapExplorerV2_1.fla
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\MapExplorer\MapExplorerV2_1.swf
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\MapExplorer\Classes\Legend.as
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\MapExplorer\Classes\LegendItem.as
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\MapExplorer\Classes\MapDisplay.as
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\ExtentMap\ExtentMapV1.fla
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\ExtentMap\ExtentMapV1.swf
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\ExtentMap\ExtentMapV1_2.fla
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\ExtentMap\ExtentMapV1_2.swf
Deleted file: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource\ExtentMap\Classes\MapDisplay.as
Deleted folder: D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\flashsource

[2] Resetting D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\appSettings.config to factory values

[3] Resetting D:\projects\pathways\phoenix\trunk\Installer\WebDeployment\Release\web.config to factory values

[4] Zip website
Creating zip archive 'D:\projects\pathways\phoenix\trunk\Installer\NodeConfigTool\data\PhoenixWeb.zip'
2900 files added to PhoenixWeb.zip

[5] Verifying/compressing Sql scripts
Verifying timestamps of .sql files in D:\projects\pathways\phoenix\trunk\Installer\NodeConfigTool\Scripts
2functions.sql was scripted on 07/10/2008 2:48:15 PM
2functions.sql is up to date
3views.sql was scripted on 07/10/2008 2:48:15 PM
3views.sql is up to date
4sprocs.sql was scripted on 07/10/2008 2:48:15 PM
4sprocs.sql is up to date
Verifying timestamps of .bin files in D:\projects\pathways\phoenix\trunk\Installer\NodeConfigTool\Scripts
1create.bin does not need re-compressing
Compressing '2functions.sql' to '2functions.bin'
Compressing '3views.sql' to '3views.bin'
Compressing '4sprocs.sql' to '4sprocs.bin'
5populate.bin does not need re-compressing

When the prebuild event is finished, the NodeConfigTool will compile.

5. Build the Installer

You are now ready to build the installer.

Expand and select the Phoenix.Installer project.

Select Build as you normally would.

Figure:Building the Installer

If there were no errors, you should have an installer application in the output folder. D:\projects\pathways\phoenix\trunk\Installer\Release, for example.

See Also