4. Website Installation
- Running the Installer
- Multiple AGR instances on the same server
- Modifying Default Settings
- AGR App Service
After the databases have been created you can run the AGR Installer to install the client and the api. This can either be done on the same server as the databases are held or on a different server…
Running the Installer
Time to install the website and the scheduling service. Run the AGRInstaller_6.x-rx.exe installer on the webservice machine! When installing a new instance of AGR check the “Web Client”, “Web API” and “AppService” components.
Once all necessary components have been selected, click Next
Here the user is prompted for the location of the installation files, the default can be seen in the image above, but the user can enter any valid file location. Click install once the file location has been selected and the installer will install AGR.
Click Next, and the user will be taken to a screen which requires the following input:
All the settings are required for the installation to be successful:
- SQL Server name: The instance of the SQL server where the AGR database is to be installed. It can either be an IP address or the machine name. If using a named instance the syntax is the following : MACHINE_NAME_OR_IP\INSTANCE_NAME.
- Production Database name: The name of the AGR production database, recommended name is agr_prod. This must match the prod name that’s already been created in the previous step.
- IIS - Web site name: The name that the website will be given in the IIS after the installation.
- IIS - Web site port: To be able to create the web site in the installer a port number is needed, if using the default port please enter 8080.
- IIS - User name: The IIS user, the domain needs to be included.
- The user must have all the necessary permissions to run an IIS App Pool.
- IIS - Password: The password for the IIS user.
- Make sure that the password does not expire
- AppService - User Name: The user running the AppService
- The user must have the “Log on as a batch job” and “Log on as a Service” rights.
- AppService - Password: The password for the AppService user
- Make sure that the password does not expire
- AppService - Port: The port number for the AppService. You need to change this number if you want to have more than one instance of the AppService on the server.
- Skip user validation: Select this if you want to skip user name and password validation for the IIS and AppService users.
Click Next
If “Skip user validation” is left unchecked the installer will try to validate the IIS and ForecastService user.
Click Install
The installer will prompt you with the “IIS URL Rewrite Module 2” setup. This is a necessary IIS module for the AGR Client. Go through with the install.
If you get this dialog, “Change, repair, or remove installation”. The URL Rewrite module has already been installed and you can click “Cancel”.
If you see “Completed” in the installer window then the installation has been successfully completed
Multiple AGR instances on the same server
When installing multiple instances of the AGR system on the same server you have to have few things in mind.
Choose an unused folder for the installation
The Web site name has to be unique. Also both web site port and App Service port need to be unused.
Modifying default settings
After installing the AGR web application, the Application pool can be configured to get a better response time.
- Open Internet Information Service Manager (IIS)
- Click on Application Pools.
- Select the Application Pool for the web application (usually named AGR5).
- Right click on the Application pool for the web app and click “Advanced settings”.
- Modify the following settings:
- (General) Enable 32-Bit Applications: False (For releases 6.2-r12 and older this setting should be true)
- (General) Start Mode: AlwaysRunning
- (Process Model) Idle Time-out (minutes): 0
- (Process Model) Ping Enabled: False
- (Recycling) Regular Time Interval (Minutes): 0
- (Recycling) Specific Times: Add the time 00:10:00 (or any other time that is acceptable to experience a brief lapse in the application while it is restarts).
- Under sites, right click the application (AGR) and select Manage Website | Advanced settings.
- Set property “Preload Enabled” to true.
AGR App Service
After install the AGR app service should be visible like this in Windows Services:
Startup type “Automatic (Delayed start)” is commonly used to improve server boot performance. Right click on the “AgrAppService”, select Properties and change Startup type to “Automatic (Delayed start)”
