<< Click to Display Table of Contents >> Navigation: Network & Remote Installation > MBI - optional minimal browser interface > Step #2: MBI Configuration |
Configuration of MBI differs depending on the operating system in use.
Below are first the steps if using older OS such as Windows XP Pro or Windows 2003; and than second after that are the steps if using Windows 7 and newer.
Steps to perform if using older OS such as Windows XP Pro or Windows 2003
A. Open the IIS Manager and confirm that AyaNovaMBI is present as an application site under Default Web Site
B. Confirm what the external static IP address is for your router/firewall (as your remote users will use that ip address, not a private internal ip)
C.1 If you have a Static IP: (see C.2 below if you have a dynamic IP)
Configure your router to forward outside Internet requests to the IIS server
Every model router is different so we can not provide specific directions here.
You will need to check your router documentation manual on how to configure forwarding
Basically, with most models you would bring up the software configuration for the router by connecting to the router via your web browser, go into Advanced settings, go into Forwarding settings, enter the internal IP address of the MBI IIS server, enter the Port number outside Internet users would enter to be redirected to the MBI IIS server (same port number the Default Web Site is set to use in Computer Management)
For example:
1. Your router's static Internet IP address is 333.222.101.12
2. The Default Web Site TCP Port is set to 6969
3. The MBI server's internal IP address is 192.168.1.100
4. You install and configure MBI to this computer
5. You configure your router to forward port 6969 to 192.168.1.100
6. Remote Internet users would enter the URL of http://333.222.101.12:8989/AyaNovaMBI/ to bring up the login page for accessing via MBI. If the port number is 80 (the default web server port) then it can be left off of the URL in the browser.
•in our example screenshot below for our example LinkSys router - the forwarding port we have set is 6969 for the database server’s internal IP address of 192.168.1.100
C.2 If you only have dynamic IP
You can certainly use a dynamic IP address for your public router/firewall, but of course as dynamic ip changes constantly, you and your staff would need to know what the changed IP address is every time it changes.
OR
If your company is unable to obtain a static IP address, a possible suggestion may be to follow https://forum.ayanova.com/t/yes-you-can-use-dns-and-your-dynamic-ip-address-to-set-up-remote-access/2311
D. Confirm that the Default Web Site in IIS is configured for this same port #
•In our example, we have the TCP Port as 6969 for the Default Web Site because as the above example, we want to have remote users forwarded to port 6969 onto the server.
•You do not have to use 6969 as the TCP Port and you can leave it at it's default of 80 - this is just an example.
E. Replace the sample config.txt installed by the MBI setup with the same config.txt that your AyaNova program uses to connect to the networked database.
•a. Again confirm that the latest version of AyaNova is already installed and working connected to the networked AyaNova database (you can login and see your data) on this computer prior to installing MBI. Check your version by select menu Help -> About AyaNova Once confirmed AyaNova and MBI are the latest, then continue.
•b. Use Windows Explorer to open C:\Program Files (x86)\Ground Zero Tech-Works Inc\AyaNova folder, and copy the config.txt file
•c. Move to the C:\Program Files (x86)\Ground Zero Tech-Works Inc\AyaNovaMBI\bin directory and paste the config.txt there
•d. You will be asked to confirm overwriting the existing config.txt, click Yes.
•e. If you do not get asked, this may mean you are pasting to the wrong folder - check your steps and redo.
F. Confirm that both the Default Web Site and the AyaNovaMBI site are using Microsoft.NET Framework 4
Click on the ASP.NET tab of this Default Web Site and make sure the .NET Framework selected is 4
Right-click on the AyaNovaMBI site, and select Properties
View the ASP.NET tab and make sure the .NET Framework selected is 4
G. View the Documents tab and make sure default.aspx is set
H. If using an older OS such as Windows 2003 or Windows XP 64 bit , select the Web Service Extensions and make sure is set to Allowed (if not set to Allowed, will get 404 error Page Not Found when performing step N)
NOTE: If you do not see this extension listed, it may be because your ASP.NET needs to be re-registered to work with IIS again by running "%windir%\Microsoft.NET\Framework\version\aspnet_regiis.exe" -i where %winver% is the Windows directory for your operating system, and version represents the version number of the .NET Framework that you installed on your server. You must replace this placeholder with the actual version number when you type the command.
I. The following are additional rights settings you may want to set so that external users can not view the contents of the config.txt file
1. Open the IIS Manager or Computer Management
2. Right-click on config.txt that is within the folder of the AyaNovaMBI site
3. Select Properties
4. Un-check the Read right, and save.
I. Stop and Start the default web site
J. Continue to the User settings for MBI
Steps to perform if Windows 7 and newer
A. After installation has completed, open the IIS Manager and confirm that AyaNovaMBI is present
image above shows all optional remote access applications installed. your Default Web Site layout may be different.
B. Confirm what the external static IP address is for your router/firewall (as your remote users will use that ip address, not a private internal ip)
C.1 If you have a Static IP: (see C.2 below if you have a dynamic IP)
Configure your router to forward outside Internet requests to the IIS server
Every model router is different so we can not provide specific directions here.
You will need to check your router documentation manual on how to configure forwarding
Basically, with most models you would bring up the software configuration for the router by connecting to the router via your web browser, go into Advanced settings, go into Forwarding settings, enter the internal IP address of the MBI IIS server, enter the Port number outside Internet users would enter to be redirected to the MBI IIS server (same port number the Default Web Site is set to use in Computer Management)
For example:
1. Your router's static Internet IP address is 333.222.101.12
2. The Default Web Site TCP Port is set to 6969
3. The MBI server's internal IP address is 192.168.1.100
4. You install and configure MBI to this computer
5. You configure your router to forward port 6969 to 192.168.1.100
6. Remote Internet users would enter the URL of http://333.222.101.12:8989/AyaNovaMBI/ to bring up the login page for accessing via MBI. If the port number is 80 (the default web server port) then it can be left off of the URL in the browser.
•in our example screenshot below for our example LinkSys router - the forwarding port we have set is 6969 for the database server’s internal IP address of 192.168.1.100
C.2 If you only have dynamic IP
You can certainly use a dynamic IP address for your public router/firewall, but of course as dynamic ip changes constantly, you and your staff would need to know what the changed IP address is every time it changes.
OR
If your company is unable to obtain a static IP address, a possible suggestion may be to follow https://forum.ayanova.com/t/yes-you-can-use-dns-and-your-dynamic-ip-address-to-set-up-remote-access/2311
D. Confirm that IIS is configured for this same port #
•In our example screenshot below, the Port is 80 for the Default Web Site.
•So would need to edit the port for the Default Web Site to 6969 to match that set for the router if using that port number of 6969.
E. Replace the sample config.txt installed by the MBI setup with the same config.txt that your AyaNova program uses to connect to the networked database.
•a. Again confirm that the latest version of AyaNova is already installed and working connected to the networked AyaNova database (you can login and see your data) on this computer prior to installing MBI. Check your version by select menu Help -> About AyaNova Once confirmed AyaNova and MBI are the latest, then continue.
•b. Use Windows Explorer to open C:\Program Files (x86)\Ground Zero Tech-Works Inc\AyaNova folder, and copy the config.txt file
•c. Move to the C:\Program Files (x86)\Ground Zero Tech-Works Inc\AyaNovaMBI\bin directory and paste the config.txt there
•d. You will be asked to confirm overwriting the existing config.txt, click Yes.
•e. If you do not get asked, this may mean you are pasting to the wrong folder - check your steps and redo.
F. Confirm that your Default Web Site and the AyaNova remote access application(s) just installed are associated with an application pool that uses the managed piped mode Integrated (not Classic) and uses .NET v4.0 (later versions may say version 4.2, 4.3, 4.5 etc)
•This .NET v4.x application pools are created automatically for you when you installed the IIS components in Step #1 - MBI Installation with .NET 4 installed
• Your version of Windows may have named the application pool ASP.NET v4.0 or it may have been named some other name such as DefaultAppPool or some other name.
•The name doesn't matter - what matters is that the application pool is associated with your Default Web Site and the AyaNova remote access components has:
•managed pipeline mode of Integrated
•.NET 4 Framework
•If your Application Pools via your IIS does not show an application pool with managed pipeline mode of Integrated and framework version of 4.x (x being whatever the latest version 4 that is available) then you need to reinstall (or check to make sure even is installed) the required IIS components as outlined in Step#1. A and redo your steps.
G. Check that IIS_Users has permissions
Right-click on Default Web Site -> Select Edit Permissions... -> Select the Security tab
If IIS_Users is not listed, do add.
Example screenshots taken such as click on Edit -> than Add... -> Advanced -> Find Now -> scroll down and click on IIS_USERS and OK till now showing.
H. View the Default Documents setting and make sure default.aspx is set
I. The following are additional rights settings you may want to set so that external users can not view the contents of the config.txt file
1. Switch to Content View for AyaNovaMBI
3. Right-click on the config.txt file and edit permissions
4. Check-mark Hidden
I. Restart the default web site
J. Continue to User settings