Graphical Installer

Graphical Installer

There are several options presented when the graphical installer is opened. We will focus on the "Deploy new mobile server" option in this guide.

• When the installer is opened, the first option presented in the list is to deploy a new mobile server.
  • Selecting this radio button causes a line to appear requesting you to enter the tomcat path.
  • Choose browse, and navigate to the home directory for tomcat. This is the directory which contains the bin, lib, webapps, etc subdirectories.
    • If you have run the installer before, it will remember your last choice.
  • Choose open to enter that path into the window. Then choose Next to move on to the next step.
  • The next screen will ask you for your war file.
    • This file should have been received from iEnterprises. Its name will be similar to MEXX9.0.0.war.
    • Navigate to its path, and click Open. The installer will extract your war file.
    • Click Next to move to the next step.
  • Enter your MySQL details.
    • The simplest MySQL setup is on the local server (localhost, port 3306), using the root MySQL user and password.
    • Any user which can create a new database can be used here.
    • Once you've entered in the server, port, username and password, click the + to create a new schema.
    • The schema's name should be all one word. For example, you might choose the schema name mobileserver.
    • Your new schema name should now appear in the line next to Schemas.
    • Click Test Connection to ensure that the mysql setup is working as intended. If it is correct, the Next button will now be clickable.
    • Click Next to continue.
  • In the next screen, you may choose to add an additional user to MySQL in order to not use the root MySQL user for continued access to the Swift MEAP server's database.
    • Click the button next to the user list field to create a new user for your Swift MEAP installation, if desired.
    • This new user or the MySQL root user may be used to access the database. Ensuring the user you want to use, that user's password, and the correct schema is listed.
    • Choose Test Connection to proceed.
    • The next button will be clickable if the connection test succeeded.
    • Click next to continue.
    • Note that the above screen can also be used to assign various privileges to different users and different schema. Click the "Set Privilege" button next to the "Refresh" button next to the Schema list.
  • The next screen shows the database being created and various tables being set up. 
    • Any errors will be displayed.
    • Assuming there are no errors, click next to proceed.
  • Set the path for the Swift MEAP log files that you created earlier in the Linux or Windows installation section of the document. 
    • The default logging level should be left at "info" . It is possible to change it later on the server on the fly. Please see How to change the server logging level for more information on changing the logging.
    • The Mobile Server Name you enter here will be the context in the URL that is accessed later. It is often advisable to make this name the same as the database schema name. For example, mobileserver, as above.
    • You can choose to run the administrative console and the server servlets on different ports. 
      • This would be done in the case where you want to open your firewall only to specific IP addresses to use the administrative console. 
      • Your firewall must be open to all IPs from which your users would log in to Swift MEAP from their devices. Typically this is all IPs. 
      • In this basic installation guide, we will assume both are running on the same port, 8080, which is tomcat's default. 
    • Press Deploy Mobile Server to proceed. 
  • Any errors which occurred will be displayed in the window which follows. 
    • If deploying on Windows, tomcat will be automatically restarted by the installer.
    • Linux users will get a reminder to restart tomcat. 
      • However, Linux users need to do one more step before restarting tomcat. 
        • The directory $TOMCAT_HOME/webapps/mobileserver is owned by root, and must be owned by the tomcat user. 
        • Please change ownership of this directory before restarting tomcat. (i.e., chown -R tomcat7.tomcat7 /var/lib/tomcat7/webapps/mobileserver) 
        • Once the directory's ownership has changed, restart tomcat. 

If all has worked, your Swift MEAP server is now available at 

http://yourhost.com:8080/mobileserver

• You can log in to the Swift MEAP server using admin/admin as the username and password. 
  • It will immediately ask for a new password.

At this point, it will present to you the license screen. Please see our /wiki/spaces/SMSAGV/pages/213922 for further information.