Language | Bondware Installation |
This document covers installing Bondware on Linux only. We highly recommend the Linux platform for running Bondware and EASE. This documents assume expert level knowledge of Linux and should not be attempted otherwise. Installing Bondware is simple, providing that you have installed the easesvr and easechat rpm packages. The distributions for easesvr and easechat are available in the Files section of this site. Once these are installed, you should now have the directory /usr/local/ease. As root, cd to this directory and add the directory apps. So, as a result, you will have the directory /usr/local/ease/apps. Download the Bondware distribution from the Files section of this site. Copy the Bondware tarball into this directory and unpack it using #>tar -xzvf bw-x.x.x-x.tar.gz Where x.x.x-x is the version number of the Bondware package that you downloaded. Due to a bug in the Solaris tar program that doesn't allow it to deal with gzipped files, if you are installing on a Solaris machine, you will need to use gtar instead of tar. Once this is done, you are ready to spawn your first site. To do this, cd to the bondware directory (/usr/local/ease/apps/bondware). There you will find several scripts. The ones that concern us are spawn.sh and despawn.sh. The rest of them are there for other platforms such as WindowsNT. Edit these files and make sure that the paths are setup correctly. These are currently configured for a standard RedHat installation. Pay particular attention to these as they establish the paths to system utilities and directories that are required to spawn a new site. Here is a quick description of the variables defined in this section. PROJECT=templates TEMPLATE_DIR=/usr/local/ease/apps/bondware/$PROJECT These are for script portability so that it can be used for several different ease applications. DO NOT EDIT THESE UNLESS INSTRUCTED TO BY EDGENET TECH SUPPORT. MYSQL_BIN_DIR=/usr/bin MYSQL_DATA_DIR=/var/lib/mysql These tell us where to find your mysql binaries (ie. mysql, mysqladmin, etc.) and data files. If you are running Linux with a MySQL rpm installed, you probably won't need to edit this line. If you are running Solaris or a custom build of MySQL, you will want to edit these lines to point to the appropriate paths for your MySQL installation. HOME_PARTITION=/home This tells us where the user directories live. If you intend on allowing ~(tilda) expansion to get to a site, this will need to be the same directory that useradd creates user directories in. This is for accessing sites via addresses like http://www.myhost.com/~myusername. HTML_DIR=public_html The name of the directory which is appended onto a user's home directory if a ~user request is received. This should be the same as the UserDir directive in your httpd.conf file. HTML_SUB_DIR=community WHOAMI=/usr/bin/whoami These last two should be fine as they are. DO NOT EDIT THESE LINES UNLESS INSTRUCTED TO BY EDGENET TECH SUPPORT!!! Once you have verified that these are correct, save the file and exit your editor. Now we can spawn our first site. To do this, we issue the command; #>./spawn.sh newsitename Where newsitename is the username of the site that you wish to spawn. It is NOT the www address, but simply a local user that this community will run as. This will start the spawn process and you will be prompted to answer several questions. We will now cover each of these questions as some can be somewhat vague. Please enter MySQL password. This is the mysql admin password that you established when you installed MySQL. Create new user? ([y]/n/q) This will add the new account to the system using useradd. If you are spawning a site for an existing user, say no here. Creating community for user: newsitename Continue? ([y]/n) This verifies that we really do want to create a Bondware community for this user. Create directories ~newsitename/templates, ~newsitename/logs, ~newsitename/data? ([y]/n/q) This will create the directories required for the new community. You should always answer yes to this question. Make links in ~newsitename/templates to /usr/local/ease/apps/bondware/templates? ([y]/n/q) This is basically defining this site as a standard Bondware site. Unless you intend on doing ALOT of customization to this site, it is best to answer yes to this question. If you answer no, there will be a considerable amount of work to do when you upgrade to newer versions of bondware. Answering yes will insure that this site will be upgraded automatically when you upgrade bondware. Make link ~newsitename/public_html pointing to ~newsitename/templates and run chown on ~newsitename? ([y]/n/q) This is setting the new site up to interact with your web server. You will want to answer yes to this question. Is this server: U) Unsecure only S) Secure only B) Both This question is to tell Bondware where it should process unsecure and secure transactions. If you are spawning this site on an unsecure server and intend for secure transactions to happen on a different server, you will answer U here. If you are spawning this site on a secure server and intend for insecure transactions to happen on a different server, you will answer S here. If this server is to handle both secure and unsecure transactions, you will answer B here. Create ~newsitename/templates/Access.ez and set permissions? ([y]/n/q) ALWAYS, ALWAYS, ALWAYS answer yes to this question. If you do not, your site will not run. Initialize new MySQL database? ([y]/n/q) Once again, answer yes to this question. This will initialized the MySQL database for this site. Edit MySQL permissions? ([y]/n/q) Answer yes to this question as well. This will grant database access to the machines that you have defined as related to this site. Move db from MySQL directory into user's directory for disk quoatas by moving /var/lib/mysql/newsitename and replacing with link? ([y]/n/q) This actually moves the database for this site into the user directory. This is useful if you have instituted disk quotas and want the database included in the disk quota for this site. And that is it. You should now have a working Bondware site. The first time you use easesvr, you will be given instructions on how to register and obtain an unlock code. |
Printer-friendly format |
