In this page I would like to explain how to create an SMF install package starting from the zip downloaded from the github repository at https://github.com/SimpleMachines/SMF2.1/zipball/release-2.1 (this link immediately starts the download of the most recent revision of the "release-2.1" branch that is the code intended to become SMF 2.1).
File structure of the repo
Once you have downloaded and extracted the package, you will find the following files:
root |- attachments |- avatars |- cache |- other |- Packages |- Smileys |- Sources |- Themes |- agreement.txt |- changelog.txt |- DCO.txt |- favicon.ico |- index.php |- README.md |- SSI.php |- ssi_examples.php |- ssi_examples.shtml |- subscriptions.php
Missing files
Compared to a normal install package, you don't have some files, namely:
- Settings.php
- Settings_bak.php
- install.php
- install_2-1_mysql.sql
- install_2-1_postgresql.sql
- install_2-1_sqlite.sql
You can find these files in the directory other
except for Settings_bak.php, so first thing enter the other
directory and copy those files to the root directory. When this is done, make a copy of Settings.php
and rename it to Settings_bak.php
Useless files
Delete the following files and directories since they are not necessary:
- other
- changelog.txt
- DCO.txt
- README.md
Congratulations!
And that's all. You now have all that you need to properly install SMF. Move all that you have in the directory to your server (remote or local) and point your browser as usual.
Upgrade package
Please remember, as usual, that there is no easy way back. Once upgraded, the most reliable way to go back is to use a backup to restore a previous state. |
From the same starting zip, you can also obtain an upgrade package as the differences are minimal. Instead of copying the files specified in the #Missing files section, copy the following:
- upgrade.php
- upgrade_1-0.sql
- upgrade_1-1.sql
- upgrade_2-0_mysql.sql
- upgrade_2-0_postgresql.sql
- upgrade_2-0_sqlite.sql
- upgrade_2-1_mysql.sql
- upgrade_2-1_postgresql.sql
- upgrade_2-1_sqlite.sql
All the other steps are exactly the same.