Deploying your ASNA Visual RPG^® Web Application for Microsoft Visual Studio 2005^®

This document is specific to deploying AVR 8.1 Web applications, not AVR 8.1 Windows applications. For information on deploying Windows applications, please refer to the document titled “Deploying your Visual RPG for 2005 Windows Application”.

There are 5 parts to deploying your AVR 8.1 Web application. They are:

1. Your Web application files.

2. The Microsoft 2005 framework.

3. The Visual RPG 8.1 Web Deployment Installation.

4. Licensing.

5. Configuring the Database name.

Currently, Visual RPG for 2005 Web deployment is supported on the Windows XP Professional, Windows 2000, and Windows Server 2003 operating systems.

Your Web Application Files

1. Open an instance of Visual Studio 2005.

2. Start a new project by selecting File – New – Project, or Ctrl+Shift+N.

You will then be shown the following dialog:

3. Select and enter the following in the New Project dialog shown above.

a. Select the Setup and Deployment Projects folder on the left, as shown above.

b. Select the Web Setup Project option in the Templates pane.

c. Give the setup project the Name you wish it to have. In the above example we just “My_WebSetup1”, but you can enter your own name and location).

d. Change the Location where your application deployment files will be saved.

e. Click OK to create the deployment solution.

You will see the following screen.

4. The next step is to add the compiled AVR 8.1 Web project you wish to deploy.

a. First, we’ll select the ASPx pages and related information for them to run correctly on the web server. Right-click on your Solution ‘setup’ in the Solution Explorer, ( My_WebSetup1) and select Add – File….

b. Navigate to your Web application’s folder where Your ASPx pages reside (inside of Inetpub\wwwroot), first to the folder:

c. Then to the files.

d. Select Open:

e. You will need to select your compiled AVR 8.1 ASP2005 DLL files.

· Selecting Add - File.

· You will need to select the bin folder, right-click, add existing files, and select the Open button.

You screen will now appear as in the following.

5. You will need to select the Startup Page or “DefaultDocument” for the target web server. To do this, right-click on the “Web Application Folder” and select Properties.

The Properties window will display.

6. You will need to enter the Virtual Directory name that the install will default to by entering the directory name in the VirtualDirectory property.

7. You can make any other modifications to the Properties at this time to suite your needs.

8. You can add any other files that the end user will need in the necessary folder(s), e.g., if you have a DLL that needs to go into the System Folder.

Please consult with the third-party vendors to determine which files are required for a deployment installation.

You can also add files and folders to the Common Files folder, Fonts folder, Program Files folder, System folder, User Application Data folder, Desktop, Favorites folder, Personal Data folder, and several other options. You can do this by Right-clicking on the “File System on Target Machine”, selecting Add Special Folder, then selecting the type of special folder to add, as shown below.

9. Once you have all of your solution files correctly configured, create your installation file by selecting Build – Build Solution, or Ctrl+Shift+B, as shown below.

10. Build your solution to determine if there are any warnings or errors. The default build type is Debug.

Once you have verified and tested that the build installs properly on a test web server, you can rebuild the project in: Release.

11. Your installation files will be created in the path specified by your setup project properties. Copy these files to the appropriate media. You are now ready to begin deploying your files to the target web server.

The Microsoft 2005 Framework

Important Note: To access the features of ASP2005, Internet Information Services (IIS) with the latest security updates must be installed prior to installing the 2005 Framework. If IIS is not present on the computer when the 2005 Framework is installed, ASP2005 will fail to register correctly and ASP2005 applications will not run. If IIS is installed after the 2005 Framework, you must manually register the Aspnet_isapi.dll file using Regsvr32.exe.

Verify if the Microsoft 2005 Framework Exists

1. The latest version of the Microsoft 2005 framework must exist on the web server prior to your installation. You can confirm that the 2005 framework exists on the web server by selecting Start – Settings – Control Panel - Add/Remove programs and see if Microsoft 2005 Framework 2.0 displays.

If Microsoft 2005 framework does not appear, you can get the 2005 framework from:

· Going to the Windows Update website and installing the latest 2005 framework. Go to Start -> Windows Update.

· Downloading it from the Microsoft Download Center.

· Order an installation CD from Microsoft.

Follow the following link for information on downloading the 2005 framework re-distributable or ordering a CD from Microsoft. http://msdn.microsoft.com/netframework/downloads/howtoget.aspx.

Once the 2005 framework is installed on the web server, the AVR 8.1 Web Distribution installation can be run.

Installing ASNA AVR 8.1 Web Distribution

So far, your Setup files are built and the 2005 framework has been installed on the server. Next, you need to install the AVR 8.1 Web Distribution Installation. This installation can be found on our website where AVR 8.1 was downloaded, or on the ASNA 8.1 2005 Product Suite CD.

1. Go to ASNA’s Downloads page and select the link to Install ASNA Visual RPG for 2005 Web Distribution.

2. After the setup file is located, the Welcome screen will display. Select Next > to continue.

3. The following License Agreement dialog will display. Click on “I accept the terms of the license agreement” and select the Next> button (which will be available after you click the “I accept….” option).

4. The Customer Information dialog will display.
Enter your computer’s user name and company name will display. You can change either as desired.

5. When finished, press Next > to continue.

6. The Setup Type dialog will display, select Complete, then Next> to continue.

7. To review any of the previous settings, select < Back.

8. At this point, Visual RPG for 2005 Web Distribution 8.1 is ready to be installed. Select Install to continue.

The installation process will begin, and the component being installed will display in the title bar. When the installation has completed, the final dialog will display.

9. Select the Finish button to close the installation.

Licensing

When the installation is complete, license the following items using ASNAs Registration Assistant.

· Visual RPG 8.1 Compiler

· DataGate 8.1 WebPak

· DataGate Client 8.1 (if you will need to have a database local to the web server)

To License an ASNA Product using Registration Assistant

The steps below will describe how to use ASNA Registration Assistant to register one of the components, but the steps are exactly the same for any ASNA Product you’re registering.

If you purchased licenses for each product described above, you will need to repeat these steps for each product you’re licensing. For example, you would perform these steps entering a license key for Visual RPG for 2005 Compiler 8.1, then again for DataGate Client 8.1, then again for DataGate 8.1 WebPak; entering the appropriate license key for each product.

1. Contact ASNA to obtain a License Key(s) for the desired component(s) as described above.

2. Once you are given the License Key(s), enter the License Key(s) within ASNA Registration Assistant. Start ASNA Registration Assistant by selecting Start - ASNA Product Suite - ASNA Registration Assistant.

3. The Registration Assistant dialog will display. You must first select the Product that you are licensing.

The Product name will vary for each product you are licensing. In the example below, the product displayed is Visual RPG for 2005 Compiler 8.1, but could also be DataGate 8x WebPak, or DataGate 8.1 Client.

4. Enter the appropriate License Key (for the product you are currently licensing) that you received from ASNA, along with the other pertinent information, such as Name, Company, Users, and License Period.

5. Select the Register Product button to accept the information, the Exit button to close Registration Assistant, or the Help button to get help on ASNA Registration Assistant.

6. Continue with steps 3-5 to license DataGate for Web 8.1 and DataGate Engine 8.1.

Requirements for database connectivity on your database server:

· DataGate Engine 8.1 for Windows

· DataGate 8.1 for IBM System i, formerly known as DataGate/400.

Create a Database Name

Next, we need to use DataGate Database Manager to create a Public database name as specified by your program.

1. Open DataGate Database Manager by selecting Start – Programs – ASNA Product Suite – DataGate – DataGate Database Manager.

2. Once DataGate Database Manager is opened, select Database – Work with Database Names.

The Work with Database Names dialog will display.

3. Click on the arrow to the right of Name: and select *Public/DG NET iSeries, as shown below. The rest of the appropriate information will display.

4. If you will need to restore an archive or manipulate any files, you can use the Archive menu to work with these objects.

Once you have performed these steps, you can run the setup program you created in “Release mode” that will install your AVR 8.1 ASP2005 Web application on your target server.