Before using the Lucity Mobile app the Lucity Mobile Server must be installed.
The Lucity Mobile Server Installation must be performed at the server where the application will reside. Installation instructions may vary slightly depending on which database is being used (Oracle or SQL Server). It is recommended to close all Windows applications before running the Lucity software setup.
Installation Prerequisites: The Lucity Mobile Server Install requires that (if using Windows Server 2003) .NET 3.5 service pack 1 and .NET 4.0, IIS 6.0, and ASP .NET be installed. For Windows Server 2008 OS, WCF Activation must be installed.
Note: The Lucity Mobile Server is used in conjunction with the Lucity Mobile application. Only licensed users of Lucity Mobile (an android app) will be able to access the functionality within the Lucity Mobile Server.
Important: The Lucity Mobile Server MUST be installed in the Web Server's DMZ or be accessible through a VPN connection from the android device to the web server.
How To
In the downloaded Install Media folder run the Setup.exe
Select the Lucity Mobile Server option on the menu. The following window will appear:
Read the Welcome screen.
Click Next to continue. The Database Connection Information dialog will appear:
Note: Depending on which type of database is being used (Oracle or SQL Server), select the appropriate radio button. Then, enter the appropriate DB connection information based on the database type. Note that this needs to be an existing database as the installation will not be creating a database.
SQL Server Users: Enter the Instance Name and User Database Name (GBAUser). The latter must be the user database; change the name if the database is named something other than GBAUser.
Oracle Users: Enter the Instance Name only. The User Database Name field will be inaccessible.
Oracle Users: The following versions/components are required: 10gR2 (version 10.2.0.1) and ODP.NET 2.0 (version 10.2.0.2.20). Checks are performed for these components. If any fail, an error message stating the particular problem will appear. If a problem is found, the installation will be terminated.
Click to Next Continue. The Existing Site dialog will appear:
Select an existing web site where the virtual directory for Mobile API will be located.
Note: This screen will appear only if more than one site is defined in IIS.
Click Next to continue. The Virtual Directory Dialog will appear:
It is recommended that the default settings be used. The Physical Directory defaults to the root of the existing web site.
Write down the virtual directory name. This will be used as the Rest Application Path when configuring the Lucity Mobile app.
Click Next to continue. The Web Gateway User dialog will appear:
Read the information on the screen. Enter the Username and Password for the Lucity_Gateway (or gbams_web_gateway) user here. This is the same user that the web product uses and is created when running Client Maintenance. The Lucity Mobile Server will use this user to connect to the databases.
Click Next to continue. The DBA Admin Login dialog will appear;
DBA Credentials are required to create or update the previously specified user account. Depending on the type of database being used (SQL Server or Oracle), enter the following:
SQL Server Users: Provide sa credentials or some other DB admin
Oracle Users: Provide the gba_admin account or another DB admin account
Note: If the credentials entered aren't sufficient, an error message will appear.
Click OK to continue. The Ready window will appear:
Note: IIS will be restarted during the installation
Note: The Virtual Directory creation may take up to 1 minute depending on the speed of the web server. Please wait while this process completes.
Click Next to begin the installation. This process may take a few minutes. The following window will appear when the installation is complete:
