Support Home Sales Website Technology Contact Us
RDP Support  


RDPWin KB Booking Engine - IRM.Net RDPWin4 & PCI Compliance Search

Mobile Suite Install/Configuration

Added 08/18/2013
Article ID:  KINet0057

Checklist for Mobile Suite Installation

This document covers installation and configuration for Mobile Suite, (IRM Mobile, Mobile HK, Mobile CI, Mobile WK, Mobile MM) on a 2008 server with IRM.Net version 3.0 or 3.1 already installed in production mode.

 

Item & Link

Completed

Verify IIS 7 is installed on the IRM Server  
Update RDPWin & IRM.Net to the latest revisions  
Verify .Net Framework 4.0 is installed  
Verify IRM.Net is working  
Install IRM Mobile  
Add .json handler support in IIS7  
Test IRM.Net  
Give IIS_IUSRS full rights to directories  
Preconfigure IRM Mobile  
Test IRM Mobile  
Test IRMCMS  
Configuration After Installation  
IRMCMS Utility
Content Management System  
Mobile Landing Page  
Troubleshooting  

Verify IIS 7 or higher is installed

The Mobile Suite is only supported on IIIS 7 which is available on Windows 2008/2012 servers.  Windows 2003 servers do not support IIS 7

 

Update RDPWin & IRM.Net to the latest revisions

Download and install the latest versions of RDPWin and IRM.Net from http://support.resortdata.com/Updates/downloadupdates.aspx

Verify that the IRM.Net works outside the building after updating.

 

If the customer is using CRMWeb, you will need to update and test it as well.

Verify .Net Framework 4.0 is installed

.Net Frame work 4.0 must be installed on the IRM.Net server.  The IRM Mobile install will not start unless .net 4.0 is installed. To determine the installed .Net Frame work versions do the following:

  1. Login to the IRMNet server as an user with full admin rights preferably the local or domain administrator
  2. On theStart menu, choose> Run
  3. In the Open box, enter regedit.exe. (You must have administrative credentials to run regedit.exe)
  4. In the Registry Editor, open the following subkey:
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP

The installed versions are listed under the NDP subkey. The version number is stored in the Version entry. For the .NET Framework 4 the Version entry is under the Client or Full subkey (under NDP), or under both subkeys.

 

If .Net Framework is not installed, it can be downloaded and installed from here.  http://www.microsoft.com/en-us/download/details.aspx?id=17851

Verify IRM.Net is working

Testing the customers IRM.Net from your lap top will determine the following:

  1. The IRM.Net is working prior to making changes to IIS.
  2. The customer has a static IP address.
  3. The customer has a SSL certificate installed and port 443 on their firewall is forwarded to the IRMNet server

Do the following to test the customer's IRM.Net:

  1. In Google Chrome go to Http:\\customersdomain\IRMNet
  2. Make a reservation
  3. Does the IRMNet change to secure mode on  the resentry.aspx page - For example https://irm.resortdata.com/IRMNet/Res/resentry.aspx
If the customer's IRM.Net is not working, you must fix it prior to continuing.

If you receive a HTTP Error 500.19 - Internal Server Error, view the troubleshooting section.

 

 

Install IRM Mobile

Download and install RDPMobileSuite3.0.0.XX from f:\masters\rdpmobile

 

The install will prompt for the UNC path to the RDP Data server.  \\RDPData\RDPNT\RDP\RDP01

 

.json handler support in IIS7

 by default IIS 7 or any of the IIS are not configure to handle .json extension.

 

  1. Open IIS
  2. Click the IIS Server
  3. Click MIME types
  4. Select Add in Actions
    1. File Name extension: .json
    2. MIME type: application/json
  5. Go back to the properties for IIS Server
  6. Click on Handler Mappings
    1. Add a script map
    2. Request path: *.json
    3. Executable: C:\WINDOWS\system32\inetsrv\asp.dll
    4. Name: JSON

Test IRM.Net

Test IRM.Net after installing IRM Mobile using the same steps in the Verify IRM.Net section.

 

If you receive a HTTP Error 500.19 - Internal Server Error, view the troubleshooting section.

 

 

Give IIS user rights to directories

The IIS user needs full rights to the following directories:

 

C:\Windows\Microsoft.NET\Framework\V4.0.XXXX\Temporary ASP.NET Files

  1. Open window's explorer
  2. Go to C:\Windows\Microsoft.NET\Framework\
  3. Open the V4.0.XXXX directory
  4. Right Click the Temporary ASP.NET Files directories
  5. Properties
  6. Security Tab
  7. Verify the IIS_IUSRS has modify and write permissions.  If not, assign the permissions.  If the IIS user does not display in the list of users, add the IIS user with the correct permissions

In order to save pictures, the IIS User needs rights to the C:\inetpub\wwwroot\IRMCMS\custom directory

  1. Open Window's explorer
  2. Go to C:\inetpub\wwwroot\IRMCMS\ directory
  3. Right Click the Custom directory
  4. Properties
  5. Security Tab
  6. Add the local IIS_IUSRS
  7. Give them Full Control of the Custom directory

Preconfigure IRM Mobile

Set up some initial configuration for the customer.

  1. Login to RDPWin
  2. Go to IRM.Net ->IRM Mobile Configuration
  3. Miscellaneous Tab
  4. Add the Property's name to the IRM Mobile Page Title Field
  5. Check Demo Mode
    1. This will allow IRM Mobile to be tested with out taking an actual credit card payment.
  6. Select a Theme that is close in appearance to the customers current IRM.Net
  7. Enter the Property's Contact Phone Number
  8. If the available rooms list will exceed 10 rooms enable paging.
  9. Save & Close

 

Install Google Chrome on the IRMNet Server

Download and Install Google Chrome on the IRMNet server from HERE for configuration and testing.

 

 

Testing IRM Mobile

Test the IRM Mobile with the following URL's.  This needs to be done after installation, but can also be done when troubleshooting an issue.

  1. Open Google Chrome on the customers server
    1. Type http://localhost/rdpdata/api/login
    2. Should return the path to the Database
      1. For Example
        [{"ServerPath":"\\\\rdpdata\\rdpnt\\rdp","ServerName":"RDPDATA","Resort":"37"}]
    3. Do the same from your computer with the customers external address.
      1. https://customerdomain/rdpdata/api/login
  2. Open Google Chrome on the customers server
    1. Type http://localhost/rdpdata/api/common
    2. Should return the MobileSuite Revision
      1. For Example
        [{"RDPCoreVersion":"3.0.000.59"}]
    3. Do the same from your computer using the customer's external address.

      1. http://customerdomain/rdpdata/api/common
       
  3. Open Google Chrome on your computer
    1. Type https:\\customerdomain\IRM
    2. This will display the IRM Mobile in tablet mode
    3. Click search availability
    4. Verify that Available Rooms display
    5. Complete the reservation
  4. Open Google Chrome on your computer
    1. Type: https://customdomain/IRM/irm.html?deviceType=Phone  (case sensitive)
    2. This will display the IRM Mobile in smart phone mode
    3. Click search availability
    4. Verify that available rooms display
    5. Complete the reservation.
  5. Open a browser on a tablet or smart phone
    1. type https:\\customerdomain\irm\irm.html
    2. This will display IRM Mobile in the correct mode for the device being used
    3. Click Search Availability
    4. Verify that available rooms display
    5. Complete the reservation
  6. Open Google Chrome on your computer
    1. type https:\\customerdomain\irm\irm.html
    2. IRM.Net should display

Remember to delete all advance deposit transactions and cancel all test reservations.

If errors display, see the troubleshooting section.

Test IRMCMS

Test the Content Management System with the steps below.

 

  1. Google Chrome on the customer's IRMNet server
    1. Type HTTP:\\customerdomain\IRMCMS
    2. Login as any RDP user
    3. Upload a photo
      1. Verify the photo was uploaded correctly by exploring to C:\inetpub\wwwroot\IRMCMS\custom\ServerName\RDP01\images
      2. There should be a copy of the image uploaded in the Images, Phone, Tablet and web directories.

Test Other Installed Mobile Products

Verify the Module is installed in RDPWin

 

Mobile Housekeeping - http:\\localhost\HK

Mobile Work Orders - Http:\\Localhost\WK

Mobile Check In - http:\\Localhost\CI

Mobile Management - http:\\Localhost\MM

Home Away CMS - TH module - http:\\localhost\IRMCMS\app.html

IRM Mobile Configuration After Installation

 

Mobile Landing Page

IRM mobile has a landing page view - for customers who don't yet have a mobile marketing site.  This is a temporary solution until the customer implements their mobile site. 

 

Here is an example:

or go to http://irm.resortdata.com/IRM/?resort=04 from a mobile device

 

To configure:

  1. IRM Mobile Configuration ->Customize Tab
  2. Landing Page
  3. Add Page Style:
    For example:
    background-color: #b8cdea
  4. Add HTML Code:
    For example:
     

    <img src="http://irm.resortdata.com/irmnet/custom/rdpdemo/rdp01/images/sunsetskye.jpg">

    </img>
    <div style="padding:20px 0 20px 0; text-align: center;">
    211 Eagle Road<br/>Avon, Colorado<br/>877-779-3717
    </div>

  5. Add code to the marketing wedsite to redirect mobile devices to Https://customerdomain/irm/index.html

Base Rate Component

Base Rate Component for IRM.Net, IRM Mobile, and API
The Base Rate Component is used to store a static set of room rates for display on the IRM.Net and IRM Mobile. The Base Rate helps speed up the display of rates in these products so the entire rate calculation is not needed. The list of rates are generated from an existing rate.  Only the lowest rate from each room type/number is stored. It is a "Rates Starting From" amount with no taxes, package components, weekend surcharges, etc.

To configure the base rate component:

  1. Go to the Reservations menu --> Reservation Configuration --> New Res tab
  2. Select the rate set for which to generate the base component from the Source Rate Set for Base Component drop down, such as Rack Rate.
  3. Click the Generate Base Component button. This creates the base component called ~BAS. The base rate can be updated at any time by clicking the button, which deletes and recreates all ~BAS records.

To display:

  1. Go to IRM.Net ->IRM Mobile Configuration
  2. Reservatios Tab
  3. Check Show base room rate
  4. Entering a label is not required but recommended - Rates From $
  5. The Base Rate will not display in the Availability List and the available rooms/room types will display much faster.

Google Analytics

Add Google Analytics in IRM Mobile

 

  1. Verify the SJ module is installed and being used
  2. Copy Trackpage.Js and Tracktransaction.htm from C:\inetpub\wwwroot\IRMNet\Custom\Common\GoogleAnalytics to C:\inetpub\wwwroot\IRM\Analytics\'DataServerName'\rdpXX               (You will need to create the folders below ..\irm\analytics, the install can't do that)
  3. Edit Tracktransaction.htm in Notepad
  4. Remove the starting <script> and ending  </script> Tags
  5. Save as trackTransaction.js

How Determine number of IRM Mobile Reservations

There are two options to determine how many reservations are being entered via IRM Mobile.  The first option requires no changes to the scripts.  The second option requres a change to the track transaction.js script and may not work for all customers depending on what fields are being used.

 

Option 1

With not changes to the script, Google Analytics allows reporting by a 'Secondary Dimension'.  There is a drop down for 'Secondary Dimension' on most of the eCommerce section screens.  After logging into the Google Analytics account, under 'Visitors', choose 'Device Category'.  The numbers will be broken down by desktop/Tablet/Mobile. 

Option 2

Populate the Product or Category fields in track transaction.js with a value that indicates the Reservation came from IRM Mobile.  Some customers may be using these fields for other purposes

 

 

Mobile-Optimized, (Reponsive) Marketing Website

Here are two examples of mobile marketing websites:

 

 

IRM CMS Import Utility

The IRM CMS Import utility serves two purposes.  First it imports photos, short descriptions and long descriptions from the IRM.Net and saves the information in the RDP database.  This allows the Content Management system to configure the IRM Mobile and/or the IRM.Net.  The import utility also formats the IRM.Net images and descriptions so that they are optimized for the IRM Mobile.

 

  1. After installing IRM Mobile on the IRM.Net server go to Start ->All Programs ->Resort Data Processing ->IRM CMS Utility
  2. Select the date Server and Resort
  3. Enter the path to the Customer IRM.Net files - C:\inetpub\wwwroot\IRMNet\Custom\'Server'\RDP01
  4. Leave the default for the IRM CMS folder
  5. Decide whether or not the customer wants to use the Content Management System to manage their IRM.Net.  If they are undecided, import into IRM.Net anyways.  They can turn on/off the CMS for IRM.Net in RDPWin
  6. If the utility is being run for a second time check Delete existing photo references from DB.  Otherwise, you will have duplicate photos.

Content Management System

  1. Start the CMS by opening up Google Chrome and entering http://localhost/irmcms/app.html on the IRM server or the properties domain name, i.e. http://irm.resortdata.com/irmcms/app.html if accessing the CMS from another computer.
  2. Login as a user with rights to the IRMCMS - need to be an administrator or a member of the CMS group in RDPWin

Troubleshooting

If you receive a dialogue message that Sessions.dat maybe missing use the following URL to trouble shoot.  The URL will test the existence and permission to basic items such as tablfile.dat, sessions.date, etc.  The URL must be used with localhost.

http://localhost/RDPData/api/ClientError  should display something similar to the following:

<DataTable xmlns="http://schemas.datacontract.org/2004/07/System.Data">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="TestConnection" msdata:UseCurrentLocale="true">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="TestConnection">
<xs:complexType>
<xs:sequence>
<xs:element name="RDPCoreVersion" type="xs:string" minOccurs="0"/>
<xs:element name="Reservations" type="xs:int" minOccurs="0"/>
<xs:element name="CanReadFromSession" type="xs:boolean" minOccurs="0"/>
<xs:element name="CanWriteToSession" type="xs:boolean" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<DocumentElement xmlns="">
<TestConnection diffgr:id="TestConnection1" msdata:rowOrder="0" diffgr:hasChanges="inserted">
<RDPCoreVersion>3.0.003.34</RDPCoreVersion>
<Reservations>410</Reservations>
<CanReadFromSession>true</CanReadFromSession>
<CanWriteToSession>true</CanWriteToSession>
</TestConnection>
</DocumentElement>
</diffgr:diffgram>
</DataTable>

 

HTTP Error 500.19 - Internal Server Error

HTTP Error 500.19 - Internal Server Error is generic but typically means there is something wrong with ASP.Net 4.0/4.5

 

Server 2008

  1. Start ->Programs ->Accessories
  2. Right Click Command Prompt
  3. Select Run as administrator
  4. Type "c:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i"

Server 2012

  1. Administrative Tools ->Server Manager
  2. Add roles and features
  3. Follow the prompts
  4. Under Server Roles Expand Web Server (iis)
  5. Expand Web Server
  6. Expand Application Developement
  7. Verify ASP.NET 4.5 is installed if not install it.
  8. Reboot the server

Mobile log files

Located in C:\ProgramData\ResortDataProcessing\LogFiles

 

Stat 12 in Log Files

If the IRM Mobile displays a blank screen and the following error is logged in the RDPData*.log, verfiy that ..\rdp\sessions.dat exists.  If not, copy your sessions.dat to the customers RDP directory

 

EXCEPTION:Pervasive.Data.SqlClient.Lna.k: [LNA][Pervasive][ODBC Engine Interface][Data Record Manager]The MicroKernel cannot find the specified file(Btrieve Error 12)
Method: SQLCommand()
SQL: INSERT INTO Sessions

 

Resorts List does not display in Mobile Suite, (Check In, Work Orders, Housekeeping)

Sometimes the browser will cache an old revision of Mobile Suites. 

 

Delete all your data (in Chrome)

1.       Click the Chrome menu  Chrome menu on the browser toolbar.

2.       Select Tools.

3.       Select Clear browsing data.

4.       In the dialog that appears, check “Empty the cache” and “Clear data from the hosted apps”

5.       Use the menu at the top to select the amount of data that you want to delete. Select beginning of time to delete everything.

6.       Click Clear browsing data.

 

If the above steps do not work try this URL replacing the address with the customers external address.

https://irm.resortdata.com/ci/index.html?id=789123654

Session is not valid

On our hosted server Tiki was getting this error when they tried to upload photos using IRM CMS “Session is not valid”

The confusion came because this was fixed in a previous version of RDP Mobile Suite and the hosted server has the fix installed.   

 

The RDP Mobile Suite log files are created in this location: C:\ProgramData\ResortDataProcessing\LogFiles

At the very top of the each log file it shows the version of RDPCore.dll (all the RDP Mobile Suite log file versions are kept in synch) and where the file is being used from.

 

At the top of the hosted server log file it showed this information

 

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-

File Path: C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files\irmcms\5f2bad38\506af5e0\assembly\dl3\de2bb6c2\00dba4aa_fb58cf01\RDPCore.dll

File Version: 3.0.0.715

Customer: The Tiki (3467)

-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-

 

This is the reason why this error was happening.  IIS was using a cached version that is 3 versions old!

 

Solution:

 

1)      Run IISReset from the console to unlock any files that were in use

2)      delete all the files under

a.       C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files

3)      For good measure also delete the ones under

a.       C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files

 

IRMCMS\app.html page does not display

http://support.resortdata.com/Customers/Knowledge/KB-IRMNET/KINet0059.htm

 

Support Home  RDPWin4 & PCI Compliance Enhancement Requests Open A Web Support Ticket
Training New Sales Website Old Sales Website Contact Us

 Facebook     Twitter      LinkedIn   TODF