Directory Structure
Written by Administrator   
Wednesday, 05 July 2006
All directories mentioned in this document are sub directories of the main ast installation. For example, /etc refers to /var/www/locahost/htdocs/ast/etc not /etc in your filesystem.

/etc

Stores configuration files for ast. The only file currently in here is awf.conf, which stores configuration settings. It is written by the System Settings page.

/images

Stores all of images used by ast. Images are served directly from this directory and not through ast like some other files such as javascript. There is a .htaccess file in this directory to make it usable by apache.

/share

Stores static files used by ast. If any file in this directory is lost, it can be recovered from the installation tarball. You may wish to modify some of the files in this directory to customize your installation.

/share/defaults

Stores defaults for most datafiles in ast. These files can be created by modifying an ast installation and then backing up the datafile. AST will look in this directory when it encounters a blank database.

/share/doc

Stores copies of the documentation available on the website, for reference later.

/share/example

Stores example configurations or other examples for systems external to AST. The only notable file in this directory is crontab, which is a sample crontab file.

/share/script

Stores javascript files used by ast. These files are loading by the javascript process. If the file does not have a .js extension, it is treated as a template and normal $ variables are replaced inside it.

/share/style

Stores CSS stylesheets used by AST. The user will have the option to choose any file in this directory that ends with .css as thier style in the user preferences. The default.css style is used when there is no user logged in. These files are read by the stylesheet process.

/share/symbols

Contains symbol lists used by ast. These should be in the format <SYMBOL><SPACE><COMPANY NAME><NEWLINE>. The files MUST be ordered alphabetically by symbol. These files are critical to the operation of reports and the stock screener. They are also used to lookup company names from symbols. If you are adding a new market, you will need to place your symbol list into this directory before creating the market in AST as the Add Market page gives a list of all files in this directory.

/share/templates

Stores template files used for generating HTML. See HOWTO: Modify HTML generated by AST for more information.

/share/tools

Stores tools for developers. There are tools in here to generate symbol lists by parsing Yahoo's web page.

/src

Stores the source code for ast.

/var

Stores non-static data. This data is automatically generated by ast. If you delete anything in here, it will be regenerated, however you may want it!

/var/backup

Stores backups of ast, if they are not set to be copied to FTP server or other location.

/var/cache

Stores caches of web pages, quotes, RSS feeds, etc. This directory may be large and does not need to be backed up. If you are having problems with information being incorrect, it may help to delete this directory and see if that fixes it. This is particularily true if you internet connection goes down and AST thinks there is no data available.

/var/crash

Stores crash logs. If ast crashes, it will write a log file into this directory. The user should get the name of the file. You can look in here to find out more information about the crash.

/var/data

Stores the actual ast data, such as portfolios, worksheets, markets, etc. User data is stored in a directory with the user's userid. Common files, such as markets are stored right in this directory. This is the only directory you need to backup. All other directories can be retrieved from the installation tarball or automatically generated.

/var/data/currency_data

Stores historical information for foriegn exchange rates.

/var/log

Stores program logs for gnuplot. If gnuplot is not working for you, you may want to look in here for errors with gnuplot.

Last Updated ( Wednesday, 05 July 2006 )