Anodyne Productions

							Anodyne Productions
SIMM Management System (SMS) 2.5.4
Installation Instructions
Last Updated October 3, 2007

Caution

Please read this document in its entirety before attempting to install SMS. If you do not understand a
part of this document or have any questions, please ask them in the Anodyne Productions Help & Support
forum at http://forums.anodyne-productions.com/ before attempting the installation.

Requirements

SMS is a server-based system operated through dynamic web pages. The files in the sms-2.5.4.zip file
you just downloaded cannot be run on your local (client) computer, but must be uploaded, installed, and
hosted on an Internet server; most likely by a hosting provider. Additionally, your hosting provider’s
server must meet several requirements for you to properly install and use SMS.

       Linux, UNIX, or Mac OS X Server operating system
        (Windows Server is neither recommended nor supported)

       Apache HTTP Server is recommended, but any PHP supported web server software should work
        (the latest is 2.0.61, the latest legacy is 1.3.39)

       PHP 4.0.0+
        (the latest is 5.2.4, the latest legacy is 4.4.7)

       MySQL 3.23+
        (the latest is 5.0.45, the latest legacy is 4.1.22)

       Using SMS itself requires Internet Explorer 7, Firefox 1.5+ (the latest is 2.0.0.7),
        or Safari 2 (the latest is 2.0.4).

Troubleshooting

If while using SMS you come to a page that does not display anything even though it should, open the
page referenced in the URL. If you were having this issue with a reports page, open the file
reports.php in the admin directory with WordPad, save it, then re-upload it. The same issue has been
reported with the install page as well. This is due to an inherent flaw in how Windows handles line
breaks. We apologize for this, but unfortunately, there is nothing we can do about it.

Installation

SMS uses a user-friendly, web-based installation script. Once the files are correctly copied to your
hosting provider’s server the majority of the work is handled by the system itself. Below are two
separate sets of installation instructions depending on whether you are doing a brand new (clean/fresh)
installation or if you are updating a previous version of SMS. In the instructions, what are called folders
on your local (client) computer are referred to as directories on the hosting provider’s server.
Fresh Install Guide

1. Note your website address i.e. http://<your site>/ and what directory you want SMS to reside in
i.e. http://<your site>/<path to SMS>/.

2. Make sure you have a database set up within MySQL to house the SMS tables. Note the database
name, username, password, and error message. If you are unsure about the details, please contact your
hosting provider. They should have provided you with this information when you signed up, possibly by
email. There may be further information on your provider’s website regarding MySQL connections, or
they may provide you with a web host management page such as cPanel e.g. http://<your
site>/cpanel/.

3. Upload all the files in the sms-2.5.4.zip file to directory on your hosting provider’s server where you
want SMS to reside. Generally this is done with a File Transfer Protocol (FTP) client program connecting
your local (client) computer to your hosting provider’s server.

4. Open your web browser and go to http://<your site>/<path to SMS>/install.php.

5. Read the instructions, and then click the Fresh Install banner.

6. Read the instructions, and then fill out the fields on the page:
Web Location: http://<your site>/<path to SMS>/
Database Server: localhost
Database Table: <your MySQL database name>
Database User: <your MySQL database username>
Database Password: <your MySQL database password>
Database Error Message: <your MySQL database error message>

7. Click the Next Step >> button.

8. If the variables file was written successfully, then it will display a success message. On some servers,
however, for security reasons, some of the necessary PHP functions are disabled. If this is the case for
your server, it will display the code that you will need to copy and paste into the file variables.php located
in the framework directory (http://<your site>/<path to SMS>/framework/variables.php).

9. Once the file is written or you are done copying, pasting and saving, click the Next Step >> link.

10. Read the instructions, and then supply the account information for the character in the SIMM you will
use to administer SMS. Note the username and password you choose then click the Next Step >> link.

11. Read the instructions, and then supply the information for your ship’s prefix, name, and registry then
click the Next Step >> link.

12. Once the installation is complete, read the instructions, and then click the Login to your SMS site
now » link and log in with the username and password you supplied for your character.

13. After installation, delete the file install.php and the install directory as running it multiple times can
cause problems with your SMS installation, but do not delete update.php or the update directory, as
they will be used in future versions.

14. Congratulations, SMS 2.5.4 has been installed and is ready to use.
Update Install Guide

We are constantly developing the SMS, adding new features and capabilities as well as making changes
to lay out the framework for future revisions to come and make future updates easier. Unfortunately, if
you are updating from an older version this may mean a lot more work, we apologize for the
inconvenience.

1. Do a full backup of your database and existing SMS source files in case you run into trouble and
need to restore. If you are unsure how to do this, please contact your hosting provider.

2. Login to your current SMS, click Control Panel, under Reports click Version History and note the
current version. If you are running SMS 2.3.0+ then proceed to the next step. If you are running SMS
2.2.1 or prior you will need to download the installers for all the versions between yours and SMS 2.3.0 at
http://www.anodyne-productions.com/ and run them sequentially. This will update your SMS version by
version until it reaches 2.3.0 at which point you can run this installer you just downloaded and update to
2.5.4.

3. Open the pages folder on your computer as well as the corresponding pages directory on your server
and upload all the files from your computer folder to the server directory.

4. Repeat this for each folder/directory pair. Once one folder finishes updating, move on to the next
folder, moving through all the folders until you have updated all the files. The only exception is the file
variables.php in the framework directory, do not copy over this file.

5. If you are already running SMS 2.5.0+ you can skip this step. We have standardized the use of ranks
across the system in the hopes of adding a more robust control system for skins and ranks in future
versions of SMS. This release lays the initial groundwork and as such, you will need to re-download all
your rank sets from the extras section of the Anodyne site (http://www.anodyne-productions.com/) and
upload them to your server again.

6. If you are already running SMS 2.5.0+ you can skip this step. Because of various changes to the
skinning system used by SMS and the addition of more graphical elements, all your skins will have to be
converted before they can properly be used. A skin conversion guide is available through Anodyne's
online documentation at http://docs.anodyne-productions.com/. The update will reset all user and
system preferences for skins and ranks. They can be reset again once you have updated successfully.

7. If you are already running SMS 2.5.0+ login to your SMS and click the update notification link to run
the rest of the update.

8. If you are running SMS 2.4.4.1 or prior login to your SMS and you will be bumped over to the install
page. Click the Update banner to run the rest of the update.

9. After installation, delete the file install.php and the install directory as running it multiple times can
cause problems with your SMS installation, but do not delete update.php or the update directory, as
they will be used in future versions.

10. Congratulations, SMS 2.5.4 has been installed and is ready to use.