User:Emanuele/guide/How to create an install from repo: Difference between revisions From Online Manual

Jump to: navigation, search
(Created page with "{{TOCright}} 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/SimpleMa...")
 
 
(5 intermediate revisions by the same user not shown)
Line 4: Line 4:


==File structure of the repo==
==File structure of the repo==
Once downloaded and extracted the package you will find the following files:
Once you have downloaded and extracted the package, you will find the following files:
{{code|1=<nowiki>root
{{code|1=<nowiki>root
  |- attachments
  |- attachments
Line 27: Line 27:


==Missing files==
==Missing files==
Compared to a normal install package you don't have some files, namely:
Compared to a normal install package, you don't have some files, namely:
* Settings.php
* Settings.php
* Settings_bak.php
* Settings_bak.php
Line 34: Line 34:
* install_2-1_postgresql.sql
* install_2-1_postgresql.sql
* install_2-1_sqlite.sql
* install_2-1_sqlite.sql
You can find these files into the directory <code>other</code> except for Settings_bak.php, so first thing enter the <code>other</code> directory and copy those files to the root directory. When this is done, make a copy of <code>Settings.php</code> and rename it to <code>Settings_bak.php</code>
You can find these files in the directory <code>other</code> except for Settings_bak.php, so first thing enter the <code>other</code> directory and copy those files to the root directory. When this is done, make a copy of <code>Settings.php</code> and rename it to <code>Settings_bak.php</code>


==Useless files==
==Useless files==
Delete the following files and directories since are not necessary:
Delete the following files and directories since they are not necessary:
* other
* other
* changelog.txt
* changelog.txt
Line 44: Line 44:


==Congratulations!==
==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.
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==
==Upgrade package==
{{ambox
{{ambox
|type=notice
|type=notice
|text='''Please remember as usual that there is no easy way back: once upgraded the most reliable way to come back is to use a backup and restore a previous state'''}}
|text='''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 obtain also an upgrade package, the differences are minimal.
From the same starting zip, you can also obtain an upgrade package as the differences are minimal.
Instead of copy the files specified in the [[#Missing files]] section copy the following:
Instead of copying the files specified in the [[#Missing files]] section, copy the following:
* upgrade.php
* upgrade.php
* upgrade_1-0.sql
* upgrade_1-0.sql

Latest revision as of 14:06, 19 November 2012

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

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.



Advertisement: