NineChime forum

NOTE:  These directions are for Wax Poteto only.
They are current as of version 5.5.11.

---

1) MySQL DATABASE

How the database is set up varies considerably from host to host.  Usually, the database is hosted by the same computer as the web page.  If this is the case, login to your web-based server control panel, and you'll be presented with an option to set up and administrate various parts of your account, such as error logs, subdomains, redirects, databases, e-mail accounts, and so on.  Go to the section on databases or MySQL (MySQL must be used, as Wax does not support PostgreSQL).  You'll need to create a database, and a username and password for the database.  Unless you cannot choose your own database username, the database name and password should not be the same as your account login, for security reasons.

Important: when creating a database and username, the server may prefix your server login to the names.  For example, if you login to your server with the name "bob", and you create a database "oekaki", the end result may be "bob_oekaki".  Keep note of this, as the full name must be typed exactly into the Wax Poteto installer.

2) UPLOAD FILES

Once you have the database set up, choose where you want to upload the files to the server.  Normally, people create a folder and upload the files into it.  This folder may have any name, though you should not use spaces.  Copy all the Wax files from the "oekaki" folder of your distribution to your server (do not copy the documentation folder).  You then have to CHMOD certain files appropriately using the numbers found in the installation instructions.  For Wax Poteto, the CHMOD numbers are in the file "readme.txt".

CHMOD means to change the access permissions of a file.  When uploading files with an FTP client, you can usually change permissions by right-clicking on a file, and select "CHMOD" or "Change Permissions" or "Properties" from the context menu.  Then, just select the checkboxes or type in the appropriate number.  The reason for doing this is so the BBS can write files to certain files and folders, as by default, web servers make uploaded files and folders read-only.

All you really need to do is make the files and folders writable, so if you have checkboxes, make sure Group Write permissions are added.  On most servers, this results in a CHMOD number of 664 for files or 775 for folders.  Sometimes, servers don't like the execute bits, so 660 or 770 is required, but this is rare.  Make sure you CHMOD only the files that need to be writable.  All the other files should be left alone.

If you accidently CHMOD a file that shouldn't be changed, delete it from the server and re-upload it.

You usually don't have to CHMOD files that are created automatically by the installer.  Some servers do not evn allow you to CHMOD files that are created by the installer.  However, if you have to move these files manually, you must CHMOD them after they are moved..  So, if you have the need to move "config.php", for example, you must CHMOD it with Group Write permissions after you FTP it back to the server.  To "fix" permissions of a file, copy it to your computer, delete the file from the server, re-upload it, and CHMOD it.

3) RUN INSTALLER

View the board in a web browser, and you will be redirected to the installer.

The "Database Hostname" in the installer will almost always be "localhost" (all lower-case).  If it is not, the host name should be somewhere in your server's FAQ.  If you're really stuck, ask your system administrator what it is.  If "localhost" is wrong, it will usually be something like "sql1.servername.com", or "sql.servernamedb.com".

Most information in the installer is set to the default, but make sure you specify a registration e-mail, the URL to OekakiPoteto is correct, and you set a proper admin login at the bottom.  Most information can be changed after installation.