Webman-framework

Lightweight, Component-based, and Database-oriented Web Application Framework

About | Overview | Documentation

 

Documentation > Installation > 4. Web-based Support Tools Activation

4. Web-based Support Tools Activation

Inside the URL path http://127.0.0.1/wmapps/cgi-bin/webman/ there are two pre-existing sub directories (appAdmin and appDev). These two sub directories hosted framework's web-based support tools as briefly described below:

  • appAdmin - Framework's application administration tool mainly used for web application maintenance. Maintenance activities are involving user and group entities management, and access control of these entities to other application entities (link nodes, component-type modules, and database items).

  • appDev - Framework's application development tool that provides core development facilities. One of the development tasks supported by this tool is to manage application main link hierarchy structure. It will involves link node's operations such as adding new nodes, updating node's attributes, deletion of an existing nodes, and node reference manipulation.

 

4.1 Application Administration Tool (AAT)

Open the AAT page by pointing the browser to the URL http://127.0.0.1/wmapps/cgi-bin/webman/appAdmin/index.cgi. With no luck, the Perl's JSON module might not included inside the current XAMPP distribution installed and the browser might display an error as follows:

 

Some of the framework modules have dependency on this particular module thus need to install the JSON support module for Perl manually. Luckily, this task can conveniently be done by using the Perl Package Manager (PPM). At the command prompt type ppm to open the PPM. Type help command at the interactive shell to list all available commands in PPM.

 

Install JSON module by typing the install JSON command at the PPM's interactive shell. Make sure that the target machine has live internet connection since the PPM need to download the module from the CPAN site.

 

Continue with PPM by typing the install DBD::mysql command in case to update the Perl's MySQL database driver. Reload the AAT URL ( http://127.0.0.1/wmapps/cgi-bin/webman/appAdmin/) inside the browser. The browser should now display the AAT login page as below:

 

The AAT is actually one of the applications developed using the framework so it's a database-oriented web application. As a database-oriented web application as imposed by the framework implementations, the main link structure and some logical parts of AAT are stored inside database tables following the schemas proposed by the framework. To activate the AAT web application, all of the related database table schemas and contents must be first created and loaded into the system. For that purpose, at the command prompt, go to E:\wmbase\webman directory path, run the perl app_dbt_logic_load.pl command, and enter the required inputs as follows:

 

The script will create and load all related database tables and contents based on the backup date given. A series of backup tables for AAT are available from inside the E:\wmbase\webman\app_rsc\appAdmin\db directory path.

 

Go back to AAT login page and enter both the login and password fields with the value: admin and then click the submit button. The AAT main page should be displayed with the AAT itself ("appAdmin") becomes one of the application could be selected and managed.

 

Select the "appAdmin" link to manage AAT using the AAT itself. By default the "User" main link is selected and there is currently a single user with login name admin already registered with the application. This is the user account that previously used to login into the AAT web application.

 

The combination of "User", "Groups", "Link Access Control", "Component Access Control", and "DB Item Access Control" provide various aspects of application maintenance and management in term of security and access control to applications resources. The "Login Info." link provides the facilities to analyze users' access log and activities for current selected web application.

 

4.2 Application Development Tool (ADT)

Open the ADT page by pointing the browser to the URL http://127.0.0.1/wmapps/cgi-bin/webman/appDev/index.cgi.

 

At the ADT login page enter the same login name and password information used previously when login into AAT. The authentication service for ADT use the same admin user account registered for AAT. Since the AAT (registered with the application name "appAdmin") is one of the applications developed using the framework, it will become one which under the control of ADT as shown in the ADT's main page below:

 

For application name "appAdmin", clicking the "Run" link will open the AAT web application that already explained in the previous sub section (section 4.1). Clicking the "Develop" link will open the ADT's main development page for "appAdmin"/AAT as follows:

 

The "Link Structure/Reference" main link is by default selected and this is the main section of ADT that provides the core development facilities to manage the main link structure and link's attributes/references of the current selected web application ("appAdmin"/AAT). Do try to browse other main links of the ADT but it's advisable to not change any existing configurations or settings since the AAT web application is currently selected. Any changes on default AAT structure/reference settings without really knowing their functionality might cause the AAT becomes unusable.