Active Server Pages Bulletin Board 0.5 Readme ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ 1 Setup 1.1 Unpack 1.2 Check components 1.3 Set up database 1.4 Configure forum 1.5 Run Install 2 Update 2.1 Manual changes 2.2 Run Update ------------------------------------------------------------------------------------------------------------------------ 1. Setup 1.1 Unpack ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ Unpack the rar or zip file to the catalog where you have set up IIS to run your forum. If your forum is on a remote server unpack the files to a temoporary directory on your local computer and the use your ftp client to upload all files to the webserver. 1.2 Check components ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ Before you can begin to install ASPBB you need to check that the webserver that you are installing the forum on has the required components. ASPBB has been tested on IIS 5 and 6 (windows 2000 and windows xp/2003), running ASPBB on Linux with chilisoft or other similar is not supported. There are three important things that you must have to set up ASPBB: 1.) Mail component (jmail, CDONTS and CDOSYS are currently supported by ASPBB) 2.) Upload component (aspsmartupload, aspupload are supported but you can also use ASPBBfsoupload if anything else fails) 3.) A database (mysql and access is supported but MSSQL should work but is not included in setup and we dont provied any support for this at least until version 0.6) If you are unsure of the available components on your server you can run http://youraddresstoaspbb.com/checkcomponents.asp 1.3 Set up database ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ ASPBB comes with two chooices of database MysQL och Access. To set up ASPBB with Access all you need to do is make sure that the IUSR_computername account on your server has write access to the path were the .mdb file exist (db/aspbb.mdb is the default location). If your forum resides on a webhost you may want to check with the provider were to put your Access files since this can differs between hosts. For security issues you may want to change the name of the .mdb file so noone can download the whole database just by typing the url to the file. If (and you really should) you change the file name remeber to change the db_path variable in the config file described in 1.4 later If you want to use ASPBB with MySQL you need to create a empty database where the setup of ASPBB can create it's tables. This is usually done by using PhpMyAdmin if your MySQL server resides on a webhost or by using the MySQL Administrator tool that can be downloaded from www.mysql.com . You don't need to create anything else than just the empty database and you can give the database any name that you wan't NOTICE: If you have your forum on a webhost there is often no need to create a new database since your provider most certain has already created this for you. Please check with the provider what name your provided database(s) has and use one of thoose. 1.4 Configure the forum ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ There are some important settings that you have to change before you can run the setupfiles. Open the config.asp file in any texteditor you want and change the following lines const db_type = 1 ' 1 = MySQL, 2 = Access If you plan to run ASPBB with access change the db_type to 2 const db_Server = "" ' MySQL This is the ip or dns name of the MySQL server. "127.0.0.1" or "localhost" will often do if the webserver and MySQL server is located on the same machine. const db_Password = "" ' Not required for Access This is used by MySQL but is optional on Access const db_Username = "" ' Not required for Access This is used by MySQL but is optional on Access const db_Database = "" ' MySQL The name of the database that you created in step 1.3. This is only used by MySQL const db_path = "db/aspbb.mdb" ' Only if running Access Be sure to change both this and the name of the database as described in 1.3 const path = "/" 'path to the forum If your forum is'nt located in the root of the website you need to specify where it is in relations to the root directory. For example you installed all files in a directory called forum the the path should be "/forum" Under email settings choose the component that the webserver uses to send email check under 1.2 if you are'nt sure and remeber that many mailservers don't accept sending mails if the sender address does'nt exist on the server in other words the const strReplyAdress = "" should be set to a real emailaddress that resides on the server. Upload settings choose a component for avataruploads and fileattachments. FSO will work on almost any server but remeber that a real activeX component will be much faster and less CPU consuming than our pure aspupload class. The rest of the settings are quite selfexplaining and you can't really go wrong. But after the install is complete you can toggle some of the values under Customize forum settings to see what settings that will suite you best. 1.4 Install ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ Go to http://youraddresstoaspbb.com/setup.asp and follow the instructions there and then you're all set to go. Note: Make sure you delete the following files: "setup.asp" and "runsetup.asp" after you have installed the forum. If you have choosen to run ASPBB with Access you don't need to do anything else just popup your browser and head to http://youraddresstoaspbb.com/default.asp and check out your new forum. 2. Update 2.1 Manual changes ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ If you are upgrading from version 0.4 then unpack the new files in the same directory that the old forum is installed and choose to overwrite all existing files. You need to change the settings in config.asp as describe in 1.3 since there could be chganges in this file too. Make sure to do a full database backup before proceeding to the next step 2.2 ------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------------------------------ Upgrading is simple the only thing you need to do is to navigate with your browser to http://youraddresstoaspbb.com/update.asp and the script will take care of all changes that needs to be done to the database and other files. Enjoy ASPBB Developers Team info@aspbb.org