Installing the ActiveGrid StudioThis chapter explains how to install the ActiveGrid Studio. It contains the following sections:This section specifies operating system requirements and hardware recommendations for the ActiveGrid Studio.ActiveGrid recommends the following minimum configuration for the ActiveGrid Studio:When you install the ActiveGrid Studio, the installation wizard prompts you to enter the following configuration information:
• Installation Directory: The installer puts all the files and sub-directories for the ActiveGrid Studio in the directory you specify.
• File Associations: The file types that you want the system to associate with the ActiveGrid Studio. File types that you select here open by default in the ActiveGrid Studio.All third party components are installed as part of the ActiveGrid installation. They do not interfere or interact with the system binaries (such as /usr/bin/python for example).If you need to use the system Python, rather than the Python installed with the ActiveGrid Studio, then change the start script to point to the correct Python executable. Make sure that the required Python extensions are installed in the system Python directory.The file structure for the ActiveGrid Studio installation depends on the operating system you’re using. The exception is the demo and log configuration files, which are always installed in a folder called ActiveGrid in your home directory:
• 3rdparty: The 3rdparty directory contains third-party software required by the ActiveGrid Studio.
• bin: Contains log files and executables.
•
• python: Contains files used by the ActiveGrid components, including the ActiveGrid Studio executable, ActiveGridAppBuilder.exe.
• demos: Contains various demo projects packaged with the ActiveGrid Studio, some of which are available through the Welcome Wizard in the ActiveGrid Studio.
• wsdl: Contains ActiveGridKeyService.wsdl which is a WSDL document used for automatic key generation feature in ActiveGrid Applications.
• docs: Contains the the release notes, as well as sub-directories for the product documentation.The top directory, ActiveGrid Studio/, by default is installed in the Windows Program Files/ directory, but you can specify where to put it during installation.The ActiveGrid Studio/ directory contains the uninstall script, as well as the start.desktop and stop.desktop scripts (these are mapped to desktop icons). The ActiveGrid Studio/ directory also contains the following sub-directories:
• 3rdparty: The 3rdparty directory contains third-party software required by the ActiveGrid Studio. This directory is organized into the following sub-directories:
• python2.4: Python binary and libraries. A full python distribution that's used by the IDE itself as well as the application at runtime.
• php: PHP binary and libraries
• pywin32: Holds the file pywin32api.pyd used by the debugger.
• prod: Includes subdirectories for Python, PHP and WSDL:
• python: Contains the full product source code.
• activegrid: Contains ActiveGrid source files.
• static: Contains ActiveGrid source files.
• demos: Contains various demo projects packaged with the ActiveGrid Studio.
• wsdl: Contains ActiveGridKeyService.wsdl which is a WSDL document used for automatic key generation feature in ActiveGrid Applications.
• docs: Contains the release notes, as well as sub-directories for the product documentation.The first time you run the ActiveGrid Studio, it creates an ActiveGrid directory in your home directory. The ActiveGrid Studio creates this directory in the home directory of each user that runs the product. The ActiveGrid directory contains two subdirectories:
• demos: The project files for all the demo applications are installed here. You can access all ActiveGrid demos from the Welcome Dialog (Tools > Welcome Dialog...). For a description of the available demos, see “The Demo Applications” on page 21.
• logs: The configuration files for all the loggers are installed here. See the Appendix on Logs in the ActiveGrid Application Developer’s Guide for information on using these configuration files.The ActiveGrid directory also contains the PHP configuration file, called php.ini. See the Appendix on Logs in the ActiveGrid Application Developer’s Guide for information on the php.ini file.
• MySQL-python 1.2.0 (Python - MySQL integration supporting MySQL 4.0 and 4.1)The installer puts the Python extensions in the site-packages subdirectory of your Python installation.This section explains how to set up your databases to work with ActiveGrid. The ActiveGrid Studio supports the following databases:SQLite is automatically installed with the ActiveGrid Studio. No additional configuration is needed.The ActiveGrid Studio supports MySQL versions 4.1.7 - 4.1.14. Python support for MySQL is automatically enabled. To enable PHP support for MySQL, you need to add a line to the php.ini file.Note: The php.ini file is installed in the ActiveGrid directory in your home directory (Your ActiveGrid Directory).This section explains how to enable support of Oracle on Python (“Python Support”) and PHP (“PHP Support”).The ActiveGrid Studio supports the cx_Oracle Python extension module for Oracle access from Python. The specific driver you use depends on the version of Oracle you’re using. By default, the 10g version of cx_Oracle is enabled. The 10g cx_Oracle version also works with both Oracle 10g and Oracle 9i. To use Oracle 8i, follow these steps:
1.
2.
3. Copy the appropriate version of the file over the existing cx_Oracle.so file.
1. Open the INSTALL_DIR/3rdparty/python24 directory (typically c:/Program Files/ActiveGrid Studio/prod).
2.
3. Copy the appropriate version of the file over the existing cx_Oracle.so file.If you have problems with these steps on either platform, you might need to download and install a cx_Oracle from the following site:To enable PHP support of Oracle, first install the client-side software from Oracle. You also need to add a line to the php.ini file:The php.ini file is installed in the ActiveGrid directory in your home directory (Your ActiveGrid Directory).The ActiveGrid Studio installation includes the database driver for PostgreSQL (PyGreSQL 3.6.2). This is a Python library that allows the ActiveGrid Studio to communicate with a PostgreSQL database. In addition to this library, you need to install the PostgreSQL database, as well as the native client libraries that you need in order to communicate with PostgreSQL.The php.ini file is installed in the ActiveGrid directory in your home directory (Your ActiveGrid Directory).Python support for DB2 is included through the PyDB2 Python library (version 1.2). This library is available at:To enable PHP support of DB2, first install the DB2 client-side support from IBM. Then you need to add a line to the php.ini file:The php.ini file is installed in the ActiveGrid directory in your home directory (Your ActiveGrid Directory).ActiveGrid uses the pymssql (0.7.3 or higher) python module to connect to MS SQL Server. This module is not bundled with ActiveGrid. Download it from:On Windows, pymssql requires Microsoft's ntwdblib.dll. You can get a compatible version of this dll from MS SQL Server 2000 (yes, 2000) service pack 4.On Linux systems, pymssql uses FreeTDS (0.6 or higher) as communication layer. FreeTDS is not bundled with ActiveGrid. Download it from:You also need to configure FreeTDS. A simple .freetds.conf entry looks like this:The php.ini file is installed in the ActiveGrid directory in your home directory (Your ActiveGrid Directory).
ActiveGrid |
Installation and Deployment Guide |
Version 2.0 |