Help Topics

Topic Details for Installation

Help - Installing the Base Application

Overview:

The application is distributed as a source archive file. For most platforms (including Linux), this is a "tar.gz" file. For MS-Windows, this is a "zip" file. The MS-Windows version has the special new-line character combination (CR-LF) required by that platform, but is otherwise identical to the standard version.

Installation:

Select or create a directory into which to extract the application files.
Extract the archive file into the desired location.
Several sub-directories will be created as part of the extraction process.
The application itself will now be installed. However, you cannot run it until you install the third party support software (see the help instructions on how to perform that step).

Application Directory Contents:

You should see the following items present in the application directory.

Application Directory Contents:

There will be a directory called "mblogic". It will contain a number of files with ".py" extensions. These are part of the application program itself. These files will be automatically compiled to ".pyc" files when the application first starts. There will also be several sub-directories with additional code files, as well as html web pages for the help system and the status monitorin system. There is nothing in these directories that you will need to change.

HMI Directory Contents:

There will be a directory called "hmipages". It will contain a number of files with ".xhtml", ".js", ".css", and ".png" extensions. These files constitute a sample HMI client (web page) that comes with the system. You will replace some of these files with your own versions later if you create your own HMI application.

Sample Soft Logic Program:

There will be several files which are provided as a sample soft logic application. This sample application works with the sample HMI client (web page). These files are:

"plcprog.txt". This is a sample soft logic program.
"mbserver.config". This is provided as a sample server communication configuration file. You will need this file to use the sample HMI demo. You will also need it to access the on-line help functions and system status functions until you replace it with your own configuration.
"mbclient.config". This is provided as a sample client communication configuration file. You will need this file to use the sample HMI demo.
"mblogic.config". This is provided as a sample soft logic IO configuration file. You will need this file to run the sample soft logic program and to use the HMI demo.
"mbhmi.config". This is provided as a sample HMI server configuration file. You will need this file to use the HMI demo.

Shell Script to Start the System:

There will also be a shell script which is used to start the system. For the Linux version, this is called "mblogic.sh". For the MS-Windows version, this is called "mblogic.bat". This file simply calls the main program file in the "mblogic" directory.