MBI installation and configuration steps

Top  Previous  Next

It is always recommend to read through all instructions first before proceeding.

 

 

There are eight distinctive steps of the MBI setup

 

1. Ensure MBI requirements are met before proceeding
2. Installation of MBI setup file
3. Configure database connection for MBI
4. Determine the port used by IIS and check that .NET is compatible version
5. Determine the internal IP address of the IIS server
6. Configure your router to forward outside Internet requests to the IIS server
7. Test MBI
8. Additional config.txt settings
9. Use MBI

 

 

 

 

1. Requirements before proceeding:

 

The AyaNova MBI (Mobile Browser Interface) works with Microsoft Internet Information Server (IIS) to provide web browser access to small screen devices

 

The MBI Server requirements are as follows:

 

Operating system (with all latest patches) for where MBI is installed:

       

Windows 2000
Windows XP
Windows 2003
Windows Vista

 

Additional software on this computer:

 

IIS 5 or higher installed
Microsoft.NET Framework 2 or higher installed

 

Minimum Hardware for this computer:

 

As with the AyaNova database server, the higher the hardware specifications, the better the performance. If you are encountering slow response, you will want to upgrade your hardware. Minimum hardware requirements would be that for IIS

 

The AyaNova MBI server files takes approximately 6.5MB of hard drive space

 

Full high-speed internet / network connection between remote user and network where database resides

 

Static external Internet IP address for your Internet router/firewall

 

Your router/firewall has a static external IP address (you can not use a dynamic IP address as that means it constantly changes, and therefore your remote users won't be able to connect as won't know what IP address to use)

 

Your router/firewall configured for port forwarding for the IIS computer.

 

 

Security:

 

Security configuration is beyond the scope of support we provide, however it is extremely important.  If you are not comfortable with configuring IIS / firewall / router securely, it is recommended that you call in a professional to do so.

 

 

AyaNova related:

 

MBI is not a replacement for the AyaNova program, MBI is an extension of the AyaNova program.

 

MBI needs to access a database server due to the nature of IIS - you can not use MBI  with a stand-alone default installation of AyaNova.  Do refer to the network configuration section to configure AyaNova for one of the network configurations before setting up MBI.

 

MBI should be installed on a computer within the same LAN as the computer where the AyaNova database and AyaNova database server reside

 

For initial setup and configuration, the latest version of AyaNova must be installed and operational on  the IIS server (check the AyaNova Support Forum for the latest version update instructions) before and must be configured for network use before installing MBI on this computer

 

 

Mobile device requirements:

 

Wireless data services from a mobile service provider

 

A device with a web browser that supports XHTML Basic or XHTML MP or WML 2.x or greater. (the legacy WAP / WML 1.x are *NOT* supported)

 

Some devices come with a less than ideal web browser.  Opera makes a popular free web browser for wireless devices called Opera MINI that can be installed on many devices, more information can be found here: http://www.operamini.com/

 

 

 

 

 

2. MBI installation and configuration

 

1. Download the AyaNovaMBISetup.exe installation file from http://www.ayanova.com/download.htm and install MBI

 

2. The installation will install MBI by default to C:\Program Files\Ground Zero Tech-Works Inc\AyaNovaMBI and set up a AyaNovaMBI site under the Default Web Site as shown in your IIS Manager

 

 

NOTE: If you can not use a web site off of Default Web Site as per the default installation above, you can manually create a new virtual web site pointing to the AyaNovaMBI folder.

 

1.Install the AyaNovaMBISetup.exe
2.In IIS Manager, delete the installed web site AyaNovaMBI under Default Web Site (this should not remove the installed files)
3.In IIS Manager, create a new web site pointing to the C:\Program Files\Ground Zero Tech-Works Inc\AyaNovaMBI folder with its own port #
Allow anonymous access to the web site
The web site access permissions must be at minimum Read, Run scripts and Execute
Make sure .NET 2 is selected in the ASP.NET tab for this new site
You may or may not have to set the IP Address property of your new website to the computer's actual internal ip address instead of (All Unassigned)
you may have to add the default.aspx Document if not already there
4.Stop and Start this new web site that you just created
5.As the site is not under Default Web Site, note of course that the internal URL would be http://xxx.xxx.xxx.xxx:XXXX  where xxx.xxx.xxx.xxx is the server's internal IP address and XXXX is the port number

 

 

 

3. Configuring the database connection for AyaNova MBI

 

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, than continue.

 

b. Use Windows Explorer to open C:\Program Files\Ground Zero Tech-Works Inc\AyaNova folder, and copy the config.txt file

 

c. Move to the C:\Program Files\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.

 

 

 

 

 

4. Determine the port used by IIS and check that .NET is compatible version:

 

a. Right-click on My Computer and select Manage to bring up the Computer Management window

 

b. Expand Services and Applications

 

c. Expand (IIS) Internet Information Services

 

d. Expand Default Web Site

 

e. Right-click on Default Web Site and select Properties

 

f. Identify the TCP Port used by IIS - you will need this port number when you configure your router as well as to provide to remote users

 

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.

 

MBIconfig1

 

g. Click on the ASP.NET tab of this Default Web Site and make sure the .NET Framework selected is 2.0.50727 or higher

 

MBIconfig2

 

h. Right-click on the AyaNovaMBI site, and select Properties

 

MBIconfig3

 

i. View the ASP.NET tab and make sure the .NET Framework selected is 2.0.50727 or higher

 

MBIconfig4

 

j.View the Documents tab and make sure default.aspx is set

 

MBIconfig5

 

 

 

 

 

5. Determine the internal IP address of the IIS server:

 

a. On the MBI server, open a DOS command prompt by selecting Start -> Run and typing in the following cmd and selecting OK

 

Config1

 

b. Type in the following ipconfig at the DOS prompt that appears

 

Config2

 

c. This will now display the Local Area Connection's IP Address as well as the Subnet Mask and Default Gateway.

 

d. Note down this IP Address as you will need this to perform internal  testing and to identify which internal IP address to forward to via your router. In the screenshot below, the IP Address is 192.168.1.100  Your's will likely be different.

 

Config3

 

 

 

 

 

6. 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 WBI server, enter the Port number outside Internet users would enter to be redirected to the WBI 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 8989

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 8989 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.

 

 

 

 

7. Test the MBI connection

 

1. First: test MBI at the IIS server:

Open up a web browser on the MBI server itself and enter the URL to the AyaNovaMBI login page

Enter in the path http://localhost/AyaNovaMBI/ if you have not specified a port or http://localhost:XXXX/AyaNovaMBI where XXXX is the TCP Port number of your Default Web Site on this WBI server if you have specified a port other than the default of 80

Confirm you can bring up the MBI login screen

Confirm you can log in using a valid AyaNova schedulable user username and password

If the MBI login screen does not display, enter in this local computer's IP address instead of localhost, in the event localhost is disabled on this computer.

For example, if the local area IP address is 192.168.1.100 and the TCP Port number of your Default Web Site of IIS is 9632, you would enter in the URL address line in the web browser on the WBI server itself http://192.168.1.100:9632/AyaNovaMBI

If the MBI login screen does not display, you need to double-check all previous steps right from the beginning.

 

2. Second: test on a local network computer:

Open up a web browser on a computer on the same internal network as the MBI server

Enter in the path http://xxx.xxx.xxx.xxx:XXXX/AyaNovaMBI where xxx.xxx.xxx.xxx is the local area connection IP address of the MBI server and XXXX is the TCP Port number of the Default Web Site on the WBI server

If the MBI login screen does not display, but it did in the first two tests above, you may be entering an incorrect local IP address for the MBI server; or the MBI server's operating system may have a firewall enabled that is preventing access.

For example, if I installed MBI to a computer on my network that has an internal IP address of 192.168.1.100, and the TCP Port of the Default Web Site on this computer is 9632, I would enter in http://192.168.1.100:9632/AyaNovaMBI as the URL address.

 

3. Third: test via a remote mobile Internet connection:

On a remote device that is connected to the Internet, open up a compatible web browser

Enter in the path http://xxx.xxx.xxx.xxx:XXXX/AyaNovaMBI where xxx.xxx.xxx.xxx is the IP address of your router and XXXX is the forward port you have configured on your router (which is also the same as the TCP Port number of the Default Web Site on the WBI server)

For example, if the router's static IP address is 222.333.777.12 and the forwarded port configured for the IP address 192.168.1.100 that I set up in the router's configuration is (and that is also the TCP Port for the Default Web Site) is 9632, I would enter http://222.333.777.12:9632/AyaNovaMBI into the web browser URL address.

If the MBI login screen does not display, but it did in the first three tests above, you may not have configured your router correctly. Review and edit your configuration - don't forget to reset after.

 

8. Additional config.txt settings

The following is 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 bin folder of the AyaNovaMBI site

3. Select Properties

4. Un-check the Read right, and save.

MBIconfigtxt1

 

MBIconfigtxt2

 

9. Use MBI remotely

 

MBI is for use by schedulable users only. Its function is to provide the schedulable user on the road with information on the status of their scheduled workorder items, and allow them to edit their scheduled workorder items status

As every mobile device is different in how to use, we can not provide step by step use instructions. Below is an overview of the available features.

 

For use by schedulable users only
MBI will only accept login by an AyaNova user if type Schedulable User

MBILogin_Setup

First screen after log in defaults to showing scheduled items for the schedulable user, with the items within the present hour listed first

MBISchedulescreen

Provides ability for the schedulable user on the road to easily and quickly check what and where and when they are scheduled
Easily see the scheduled start and start time
Easily select the client if need to view address or contact information

MBIclient1 MBIclient2

If mobile device has the ability, automatically call the phone number selected or email the email address selected.
Provides ability for the schedulable user to easily change the status of a workorder item so that those back at the office know what is occurring
For example, when work is completed at one site, change the status to Completed, and change the status on the next workorder item to On Route To, or if just on site, change status to On Site  (note  that these are just example Workorder Statuses, as you can create your own)

MBIchangestatus1 MBIchangestatus2 MBIchangestatus3

MBIchangestatus4 MBIchangestatus5 MBIchangestatus6

Provides ability for the schedulable user to easily add billable labor information to the scheduled workorder item
Can select to convert the Scheduled Start and Stop automatically to Labor saving time on re-entry

MBIconvertscheduledtolabor1

Can view and edit existing Labor items if had previously entered

MBILabor1 MBILabor2

MBILabor3 MBILabor4

Can add new Labor item

MBInewlabor1 MBInewlabor2

New created Labor item by default enters Stop date/time of the date/time of entry, and Start date/time an hour earlier, saving entry time for the user, as well as providing a basis for where the user can easily edit.

MBInewlabor3

 

User can view, reply, create new, and send internal AyaNova memos. Useful to receive information from the office while on the road, as well as to send information to other AyaNova users while out on the road.

MBIMemos1

MBIMemos2 MBIMemo4

MBIMemos3

View text of existing Schedule Markers

MBIScheduleMarker

Users can view most recently viewed objects, saving time by being able to go directly to the object they were recently working on.

MBIRecent1