ASNA Visual RPG® 8.1 for Microsoft® Visual Studio® 2005

Installation Notes

Release Notes

 

Installation Notes

Vista Ready

This version of Visual RPG 8.1 can now be installed on machines running Windows Vista (Business edition only). 

To ensure your system is Vista-ready, Microsoft provides a software tool called Windows Vista Upgrade Advisor that checks your system and lets you know if your Windows XP-based PC can run Windows Vista. This small tool will scan your computer and create an easy-to-understand report of all known system, device, and program compatibility issues, and recommend ways to resolve them.

Upgrade Advisor can be downloaded easily at: http://www.microsoft.com/windows/products/windowsvista/buyorupgrade/upgradeadvisor.mspx?wt_svl=20409a&mg_id=20409b

For more information of Vista System Requirements, see http://www.microsoft.com/windows/products/windowsvista/editions/systemrequirements.mspx.
 

What Components You Will Need on Your System

To run Visual RPG 8.1 for Visual Studio 2005, you will need the following components on your system:

1.      Microsoft .NET 2.0 Framework and Visual Studio 2005

Visual RPG 8.1 for Visual Studio 2005 uses the .NET Framework and Visual Studio 2005. 

Note:  The .NET 3.0 Framework is part of the Windows Vista operating system.  Therefore, you do not need to install the Microsoft .NET 3.0 Framework onto a system in which Windows Vista has been installed. 

2.      Visual RPG 8.1 for Visual Studio 2005

ASNA Visual RPG 8.1 for Visual Studio 2005 is an RPG compiler that “snaps” into Microsoft’s Visual Studio 2005. 

3.       ASNA DataGate® for System i

If you are going to access the data on your AS/400 (System i), ASNA DataGate for IBM System i will need to be installed and running on your system.  You will need to be sure that your OS/400 is at V5r1 or greater to install DataGate for System i.

4.      IIS

All necessary components are automatically part of the operating system).  However, you may still need to "Add" the components.

To verify if you have IIS installed on your system, select Start - Settings - Control Panel -  Administrative Tools - Internet Information Services. 

·          If Internet Information Services is there, IIS has been installed and added.

·          If Internet Information Services is not there, you will need to install IIS. (basic instructions)

1.       From the Start menu, select Control Panel, and then click Add or Remove Programs. 

2.       Select Add/Remove Windows Components (last icon on the left).  The following screen will display.

3.      Scroll down just a little, and select the Internet Information Services (IIS) option.

5.      Aministrative Privileges

When installing Visual RPG on Windows 2000 or Windows XP, you should be signed on with Administrative Privileges to start the DataGate Service. 

If you are not signed on with Administrative Privileges, a Warning will display – stating that you need to have Administrative privileges to start the DataGate Service.

Therefore, you may want to check with your Network Administrator prior to installing to ensure you have Administrative privileges.  Note that even if you do not, you can still install Visual RPG 8.1 for Visual Studio 2005; you just cannot start the DataGate Service until you do.

6.      Licensing Requirements

A new installation of Visual RPG 8.1 for Visual Studio 2005 comes with the following trial licenses, allowing you to receive all the licenses you need to develop windows or web applications (for 30 days). 

§          Visual RPG 8.1 for Visual Studio 2005 – 30-day temporary license.  This allows you to access the IDE and create your AVR for .NET applications.

§          DataGate for Windows Servers and Desktops – a 5 user, 30-day trial license.  This allows you to create databases that run on Windows NT, 2000 and XP operating systems.

§          DataGate WebPak 8.x – a 1 processor, 30-day temporary license.  This allows you to develop and deploy web applications. 

Once your 30-day trial license is expired, you will need a new trial or permanent license from ASNA to continue using the product. 
Uninstalling and reinstalling the product will not generate a new trial license.

System Requirements to run Visual RPG 8.1 for Visual Studio 2005

Since Visual Studio 2005 and DataGate have already been installed, the initial system requirements to run Visual Studio have probably already been met on your system.  Please refer to the system requirements as required by Visual Studio. 

For Vista Machines:

To ensure your system is Vista-ready, Microsoft provides a software tool called Windows Vista Upgrade Advisor that checks your system and lets you know if your Windows XP-based PC can run Windows Vista. This small tool will scan your computer and create an easy-to-understand report of all known system, device, and program compatibility issues, and recommend ways to resolve them.

Download the Upgrade Advisor at: http://www.microsoft.com/windows/products/windowsvista/buyorupgrade/upgradeadvisor.mspx?wt_svl=20409a&mg_id=20409b

For more information of Vista System Requirements, see http://www.microsoft.com/windows/products/windowsvista/editions/systemrequirements.mspx.

Minimum Requirements

Processor

Windows 2000, Windows Servers and Windows XP:
      Minimum:  450-megahertz (MHz) Pentium II-class processor,
      Recommended:  600-MHz Pentium III-class processor recommended

Windows Vista:
      Minimum:  800 MHz processor
      Recommended:  1 GHz 32-bit (x86) processor

Operating System

Visual RPG 8.1 for Visual Studio 2005 can be installed and deployed onto any of the following systems:

- Windows 2000 Professional SP4

- Windows 2000 Server SP4

- Windows Server 2003

- Windows XP Professional SP2

- Windows Vista Business Edition only

*Memory
(Please see note above)

Windows Server 2005:
      Minimum:  160 MB of RAM
      Recommended:  3920 MB of RAM

Windows XP Professional:
      Minimum:  160 MB of RAM
      Recommended:  3920 MB of RAM

Windows 2000 Professional:
      Minimum:  160 MB of RAM
      Recommended:  3920 MB of RAM  

Windows 2000 Server:
      192 MB of RAM

Windows Vista Business Edition:
      Minimum: 512 MB of RAM
      Recommended: 1 GB of RAM

Hard Disk

Minimum:  20 GB hard drive with at least 15 GB of available space

Recommended:  40 GB hard drive with at least 15 GB of available space

Graphics

Minimum:  Support for Super VGA graphics

Recommended:  Support for DirectX 9 graphics with:

                         - WDDM Driver

                         - 128 MB of graphics memory (minimum)

                         - Pixel Shader 2.0 in hardware

                         - 32 bits per pixel

Drive

Minimum:  CD-ROM

Recommended:  CD-ROM or DVD-ROM drive

Display

Super VGA (1024 x 768) or higher-resolution display with 256 colors.

Mouse

Microsoft Mouse or compatible pointing device.

 

Getting Started

Prior to Installing Visual RPG 8.1, ensure that you have performed or have the following components on your system.

Checklist to Perform Prior to Installing Visual RPG 8.1 for Visual Studio 2005

1.      Ensure that your system meets the necessary system requirements required by Visual Studio 2005 and Visual RPG 8.1 for Visual Studio 2005. 

See System requirements for further information.

2.       Ensure that IIS is installed on your system. 

See IIS for further information.

3.       Ensure that you are signed on with Administrative Rights.

See Administrative Privileges for further information.
 

Installing Visual RPG 8.1 for Visual Studio 2005

After the Visual Studio 2005 Professional Edition has been installed, you only need to install the stand-alone version of Visual RPG 8.1 to install Visual RPG 8.1 for Visual Studio 2005 for the first time, or to install a newer version of Visual RPG 8.1.  You can install Visual RPG 8.1 from either the ASNA Product CD, or from the Downloads page on ASNA’s Developer Network web site (http://devnet.asna.com).  Installing from the CD is an easy install by selecting the appropriate options from the CD Browser that will automatically display when the ASNA Product Suite CD is inserted in the CD-Rom drive, as described below. 

Installing Visual RPG 8.1 for Visual Studio 2005 will also automatically install Release 8.1 of the DataGate for Windows Servers and Desktops.

Note that the installation procedures are the same regardless of which operating system you use, except for the note below:

Installing on Windows 2000, Windows XP, or Windows Vista:

When installing Visual RPG 8.1 for Visual Studio 2005 on Windows 2000 or Windows XP, you should be signed on with Administrative Privileges to start the DataGate Service.  If you are not signed on with Administrative Privileges, a Warning will display – stating that you need to have Administrative privileges to start the DataGate Service.

Therefore, you may want to check with your Network Administrator prior to installing to ensure you have Administrative privileges.  Note that even if you do not, you can still install Visual RPG 8.1 for Visual Studio 2005, you just cannot start the DataGate Service until you do.

To Install from ASNA Developer Network (DevNet.asna.com)

  1. Go to http://devnet.asna.com.

  2. Click on Sign In link on the top right corner and sign in to your DevNet account, or select Create an Account on the left to create a new account.

  3. Once you are signed in, click on the Downloads link at the top.

  4. Scroll down and select the product and version you wish to download.

  5. On the next screen, the list of products in the product suite selected will display for you to select from.

  6. Select the product to install.  The Release Notes for that product will display.  In the right hand corner "Downloads" window, you will see the list of products available based on your sign in.  Select the icon of the product to install.  The installation exe will display for you to Run now, or Save to your system and install later.
     

To Install from ASNA Product Suite CD

1.    Insert the ASNA Product Suite CD into your CD drive.

·      If your CD drive has AutoPlay, a screen will automatically appear.  Select the options below to install AVR. 

·      If you do not have AutoPlay installed on your CD drive, start Microsoft Windows and from the Start Menu, select Run, and enter the path:  E:\Setup.EXE, where ‘E’ is the CD-Rom drive.  Then select the options below to install AVR.

2.    Select ASNA Visual RPG® 8.1 for Microsoft® Visual Studio® 2005.

3.    Select the INSTALL button.

You can also view the Readme file by clicking the READ ME button.  

Note:  On Windows Vista systems, you will be prompted to Allow the software to run.  Select Allow to Continue.

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

5.     The installation process will automatically begin, and the component being installed will display in the title bar.  Visual RPG 8.1 for Visual Studio 2005 will install, as well as ASNA Client for .NET, Examples and Visual RPG 8.1 for Visual Studio 2005 Help.  Please note that the installation process will take awhile, and could take up to approximately 10 minutes.

6.      When the installation has completed, you will be prompted to restart your computer now.  Select No if you will restart your computer later.  Select the Finish button to close the installation. 

7.      All installation dialogs will close, and you will not be taken back to the Visual RPG 8.1 for Visual Studio 2005 Setup menu.  The installation process to install Visual RPG has been completed.

Continue with the steps below to license the Components and start Visual Studio 2005 and Visual RPG 8.1.
 

 

Licensing ASNA Products

A new installation of Visual RPG 8.1 for Visual Studio 2005 comes with the following trial licenses, allowing you to receive all the licenses you need to develop windows or web applications (for 30 days). 

§        Visual RPG 8.1 for Visual Studio 2005 – 30-day temporary license.  This allows you to access the IDE and create your Visual RPG 8.1 applications.

§        DataGate 8.1 or Windows Servers and Desktops – a 5 user, 30-day trial license.  This allows you to create databases that run on your system.

§        DataGate 8x WebPak – a 1 processor, 30-day temporary license.  This allows you to develop and deploy web applications. 

Once your 30-day trial license is expired, you will need a new trial or permanent license from ASNA to continue using the product.  Uninstalling and reinstalling the product will not generate a new trial license.

To License Visual RPG 8.1 for Visual Studio 2005, DataGate 8.1 for Windows Servers and Desktops, or ASNA DataGate 8.1 WebPak

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 for entering a license key for Visual RPG 8.1 for Visual Studio 2005, then again for DataGate 8x for Windows Servers and Desktops, then again for DataGate 8x WebPak; entering the appropriate license key for each product.