Getting started with Formspider
1. Installation Overview
Formspider installation process consists of three steps:
- Prepare for installation:This overview describes issues to consider before you begin installing Formspider.
You may also want to refer to Formspider Q/A site, http://osqa.theformspider.com. This site may include issues that you may encounter while installing or using Formspider.
- Install software: Step by step guide of Formspider Installer is included with screenshots.
- Test run: You will find simple test run inside Formspider IDE.
2. Prepare for installation
Before downloading installer, you must make sure Java run-time is installed, and properly configured. required java specifications is:/p>
- Vendor: Sun/Oracle
- Version: minimum 1.6.0_10
- JAVA_HOME environment variable should be configured properly.
You can check JAVA_HOME variable by running this shell code snippet from Linux terminal: echo $JAVA_HOME
If java installation directory is printed, it means it is configured properly; otherwise, it is not.
Now let’s visit http://www.theformspider.com/download.php to download latest Formspider build.
When you visit the link above, the following screen will show up:
Please read the license agreement carefully and check the system requirements. Clicking “Accept” button will enable the Formspider installer download links.
Now, click the appropriate download link according to your operating system to start the download process.
2. Install software
To start the installation process, double-click downloaded installation executable file(e.g. FormspiderBeta4.exe). At first, you will see the following window:
Please click “Next” to continue. Later on, you will see the following component selection screen:
- Formspider Database Components
Formspider Database Components are the heart of Formspider, where all logic operations takes place. At least one is required to build a complete Formspider system.
- Formspider Middle-tier Components
Middle-tier components are required to establish connection between Database Components and Formspider Clients(e.g. Web Client, Java Client). If you have Apache Tomcat installation, you can use it as container to Formspider Middle-tier, otherwise installer will install anew one.
- Formspider IDE Database Components
Formspider IDE is required, if Formspider will be used for development. In production environment, you may not need IDE components, however, if you are planning to develop or maintain an existing application, installing IDE components will be a good idea.
- Formspider IDE Client
IDE Client is required to run applications as client side Java applications.
You should select components of which you need Formspider Installer to install and configure for you. If you are installing Formspider for the very first time, it is recommended to leave all components checked, and click “Next” to continue.
Specify database connection parameters: host, port, SID, username and password. After filling the parameters in, press “Test Connection” button to ensure they are correct.
After specifying database connection parameters, you will enter a schema and tablespece name for Formspider Database Components. The schema will be created during installation. The default tablespace is the “USERS” tablespace.
Press “Next” to continue to the installation settings of Formspider Middle-tier Components. You can install either a new Tomcat application server or you can use an existing one. First time installers should select “Install new Tomcat server”.
Press “Next” to continue. In the following screen, you will enter the Tomcat installation parameters.
Once you see this screen, enter the port number that Tomcat application server will work from; administrator username and password, which are required for further configuration; and the installation directory. After filling in the fields, you can move on by pressing “Next”.
Then, you should enter a context root name for the middle-tier. This will define a URL that specifies your middle-tier. By this URL, you will be able to connect Formspider applications.
After that, if Formspider IDE is selected to be installed, the following screen will show up. Specify an admin username and password, then press “Next” to continue. These username and passsword will be asked by Formspider IDE at logon.
You can now see the installation summary screen. Check your settings that you have made, and press “Start” to begin installation.
During the installation, if you’ve selected to install Formspider IDE Client, you will be prompted by another installer that will install Formspider Client to your computer. Just press the “Next” buttons to proceed as usual.
After the Formspider Client install, the installation should be finished successfully, and the following screen should appear:
You can now create desktop shortcuts and start Forspider IDE by pressing the “Finish” button.
3. Test run
You can now open the Formspider IDE by clicking the desktop shortcut created by the Formspider installer. Alternatively, you can start it by using your web browser. The URL is going to be the application server URL + context root name. In our example it is: http://127.0.0.1:8080/formspider/.
The following web page will appear after you visit the URL.
Clicking the “IDE” link, provided in this page, will lead you to the Formspider IDE.
For further information on Formspider IDE and Formspider application development, please visit Formspider Learning Center. You can find code samples, example applications and tutorials with screenshots and videos. If you have any questions, you can check other developers questions from the Formspider Q&A site, http://osqa.theformspider.com. If you are not able to find appropriate answers to your questions, please do not hesitate to contact us via email,blog, or the Formspider Q&A site.