ASNA Visual RPG® 14.0 for Microsoft� Visual Studio� Readme

Product Issues
Fixes in this Release
New Features

Getting Started
Components You Will Need
System Requirements

Installation Issues
Installing Visual RPG
Licensing ASNA Products
Uninstalling Visual RPG

Using Visual RPG
Starting Visual RPG and DataGate

Additional Resources
ASNA Developer Network (DevNet)
DataGate Studio Readme
Monarch Readme

Product Issues

Fixes in this Release

Please refer to the list of fixes in this release in the Release Notes on the Downloads page at https://docs.asna.com/downloads/Pages/ASNAVisualRPG140forVisualStudio2015.aspx

Getting Started

Components You Will Need

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

Visual Studio 2015 or the Visual Studio Shell (Microsoft .NET 4.0 Framework)
Visual Studio 2015 uses the .NET 4.0 Framework.
Visual RPG 14.0
ASNA Visual RPG is an RPG compiler that �snaps� into Microsoft�s Visual Studio 2015.
ASNA DataGate® for IBM i
If you are going to access the data on your IBM i, ASNA DataGate for IBM i will need to be installed and running on your system. You will need to be sure that your IBM i is at at least V5r1 or greater to install DataGate for IBM i.
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, click the Windows Icon/Start Button - Control Panel - Programs - Turn Windows Features on or off - Internet Information Services.
- If Internet Information Services is checked, IIS has been installed and added.
- If Internet Information Services is not checked, you will need to install IIS. (basic instructions)
  1. Click the check box next to Internet Information Services to place a check in it, then click OK.
  2. A wizard will run installing Internet Information Services and its components.
Administrative Privileges
When installing Visual RPG on Windows 7 or 8 (Pro) 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; you just cannot start the DataGate Service until you do.
Licensing Requirements
A new installation of Visual RPG 14.0 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 14.0 for Visual Studio 30-day temporary license. This allows you to access the IDE and create your AVR for .NET applications.
- DataGate 14.0 for Windows Servers and Desktops � a 5 user, 30-day trial license. This allows you to create databases that run on Windows NT and XP operatingsystems.
- DataGate 14.0 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.

System Requirements to run Visual RPG 14.0

Since Visual Studio 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 more information on Windows 7 System Requirements, see http://windows.microsoft.com/en-US/windows7/products/system-requirements

Minimum Requirements
Processor	For Development (all operating systems): Minimum – 1.6 GHz or faster processor Recommended � 1.6 GHz or faster quad core processor For Deployment: – 1 GHz (x86 Processor) or 1.4 GHz (x64 processor)
Operating System	Visual RPG 14.0 can be installed and deployed onto any of the following systems - Windows Server 2008 R2 Enterprise (x86 or x64) - Windows Server 2012 (x64) - Windows 7 (x86 or x64)) - Windows 8 Pro (x86 or x64) - Windows 10 Pro (x86 or x64)
Memory (Please see note above)*	Windows Server 2008 R2 Minimum: 2 GB of RAM Recommended: 4 GB of RAM Windows Server 2012 Minimum: 2 GB of RAM Recommended: 4 GB of RAM Windows 7 32 bits: – Minimum: 1 GB of RAM – Recommended: 2 GB of RAM 64 bits: – Minimum: 2 GB of RAM – Recommended: 4 GB of RAM Windows 8 32 bits: – Minimum: 1 GB of RAM – Recommended: 2 GB of RAM 64 bits: – Minimum: 2 GB of RAM – Recommended: 4 GB of RAM Windows 10 32 bits: – Minimum: 1 GB of RAM – Recommended: 2 GB of RAM 64 bits: – Minimum: 2 GB of RAM – Recommended: 4 GB of RAM
Hard Disk	Minimum: 20 GB hard drive, 5400 RPM with at least 15 GB of available space Recommended: 40 GB hard drive, 5400 RPM with at least 15 GB of available space
Graphics	Minimum: Support for DirectX 9 graphics with:
Drive	Minimum: CD-ROM Recommended: DVD-ROM drive
Display	1024 x 768 or higher-resolution display.
Service Packs	14.0 is optimized for the latest service packs available for all Operating Systems and Visual Studio.

Visual Studio 2015 minimum requirements:
Professional: http://www.microsoft.com/visualstudio/eng/products/visual-studio-professional-2015#product-edition-professional-requirements
Ultimate: http://www.microsoft.com/visualstudio/eng/products/visual-studio-ultimate-2015#product-edition-ultimate-requirements

Installation Issues

Installing Visual RPG

After Visual Studio has been installed, you need to install Visual RPG for the first time, or to install a newer version of Visual RPG. You can install Visual RPG from the Downloads page on ASNA�s Developer Network web site https://docs.asna.com.

Installing Visual RPG will also automatically install Release 14.0 of 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 Windows 7, Windows 8 Pro, or Windows 10:

When installing Visual RPG on Windows, 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, you just cannot start the DataGate Service until you do.

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

Go to https://docs.asna.com
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.
Once you are signed in, click on the Downloads link at the top.
Scroll down and select the product and version you wish to download.
On the next screen, the list of products in the product suite selected will display for you to select from.
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.

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

Silent Installation

Note: Like other installations, Silent Installations require that the user performing them have Administrator-level privileges.

To set up a silent installation, you must download the AVR package as listed above, or otherwise have them available on your Windows machine or network.

Then, in a command prompt, enter the path to the folder where the AVR installation package is saved followed by Setup.exe, using the following syntax:

ASNA.Setup.exe [options]

The following options are required for silent installation:

-s Run the installation with no user interface.

-a Accept the ASNA Software License Agreement (required to run in silent mode)

Other available installation options are:

-?        Displays the command line usage dialog.
-f        Full: Install all components.
-c        Core: Install required components.
-o        Optional: Install required and optional components.
-h        Help: Install required and help components.
-netfx35 .NET Fx 3.5: Install .NET Framework 3.5 Support if present on machine.
-np       Do not prompt the user to reboot if Reboot is required.

Note: Multiple installation options may be used.

Ex. \"ASNA.Setup.exe -s -a -o -netfx35\" will install the required components, optional components, and .NET 3.5 Support.

To repair an installation from the command line:

-r Repair the installation.

Will repair all features that are installed and have not previously been upgraded by another product.

To uninstall from the command line:

-u Uninstall the product.

Will remove all features that are part of the product package, are not permanent, and are not shared with other ASNA products that are currently installed on the machine.

Licensing ASNA Products

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

AVR 14.0 for Visual Studio � 30-day temporary license. This allows you to access the IDE and create your Visual RPG 14.0 applications.
DataGate 14.0 for Windows Servers and Desktops � a 5 user, 30-day trial license. This allows you to create databases that run on your system.
DataGate 14.0 WebPak � an 8 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 ASNA Products

The steps below will describe how to use ASNA Registration Assistant to register Visual RPG, DataGate for Windows Servers and Desktops, and DataGate WebPak. Please refer to the appropriate Readme for instructions on licensing other ASNA products.

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

Before the expiration of your temporary license, if applicable, contact ASNA to obtain a License Key(s) for the desired component(s) as described above.
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 for Visual Studio - ASNA Registration Assistant.

You can also select ASNA Registration Assistant.exe from the ..\Program Files\Common Files\Asna Shared folder.
Select the Product on the left that you are licensing.
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.
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.
Continue with these steps for each ASNA product you are licensing.

Uninstalling Visual RPG 14.0 for Visual Studio or other Components

When uninstalling Visual RPG 14.0, you only need to uninstall Visual RPG 14.0 for Visual Studio, which will also remove the DataGate for Windows and/or DataGate Web Server (if installed).

See Uninstalling Visual RPG 14.0 for Visual Studio for the instructions to remove Visual RPG

If you are removing all Visual RPG and Visual Studio components from a system, it is important that you uninstall them in a particular order. You remove the products in the reverse order in which they were installed. For example, you would first uninstall Visual RPG 14.0 then MSDN (if installed), Visual Studio, and lastly, the Microsoft .NET Framework.

Follow the steps below to remove Visual RPG. Use the same steps to remove MSDN, Visual Studio and the Microsoft .NET Framework 4.0, or refer to your Microsoft documentation.

Using Visual RPG

Starting Visual RPG and DataGate Studio

After you have completed the installation procedure, you can start Visual RPG at any time.

To Start Visual RPG

Start ASNA Visual RPG by selecting Start � Programs - ASNA Product Suite for Visual Studio 2015 - ASNA Visual RPG 14.0 - ASNA Visual RPG 14.0
The default start page in Visual Studio will display.
For help on using Visual Studio and Visual RPG .NET, select either Contents, Index or Search from the Help menu to display the help files for the installed Visual Studio products.

You can also open Visual Studio and create a new Visual RPG project by selecting File � New � Project � Visual RPG Projects.

After you have completed the installation procedure, you can start any of the products included with DataGate at any time.