{"_id":"54c672d7f2ab9319008e8164","__v":6,"version":{"_id":"54c670dbf2ab9319008e8153","forked_from":"54c66cdf2b94bb19003d3427","project":"54c66cdf2b94bb19003d3424","__v":3,"createdAt":"2015-01-26T16:52:43.765Z","releaseDate":"2015-01-26T16:52:43.765Z","categories":["54c670dcf2ab9319008e8154","54c6779d2b94bb19003d345e","54c67bfe2b94bb19003d3466"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.7.0","version":"0.7"},"category":{"_id":"54c670dcf2ab9319008e8154","pages":["54c670dcf2ab9319008e8155","54c672d7f2ab9319008e8164","54c67409f2ab9319008e816e","54c6771cf0320f0d00ac9be2","54c677412b94bb19003d345b","54c98fd569c3390d00033a26","54c9900d69c3390d00033a28","54c9904c7a11f60d0022a9cb","54d6ad1811e31f0d001b8903","551460b7e74c1c2300f9b387"],"project":"54c66cdf2b94bb19003d3424","version":"54c670dbf2ab9319008e8153","__v":10,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-01-26T16:35:44.174Z","from_sync":false,"order":0,"slug":"documentation","title":"Documentation"},"user":"54c66cc52b94bb19003d3423","project":"54c66cdf2b94bb19003d3424","updates":["54f42ae35bc4e91700f9fec2"],"next":{"pages":[],"description":""},"createdAt":"2015-01-26T17:01:11.564Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Updating from v0.7 and onward\"\n}\n[/block]\n**Make sure to backup your SQL database before any update!**\n\nPut the Solder application into maintenance mode.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php artisan down\",\n      \"language\": \"shell\",\n      \"name\": \"Maintenance mode on\"\n    }\n  ]\n}\n[/block]\nAnd then run a pull to get the latest changes from the GitHub repository.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"git pull\",\n      \"language\": \"shell\",\n      \"name\": \"Pull new files/changes\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"If `git pull` fails with: \\n```\\nerror: The following untracked working tree files would be overwritten by merge:\\nPlease move or remove them before you can merge.\\nAborting\\n```\\n\\nReset the repo to the latest version before the update\\n`git reset --hard <version>`\",\n  \"title\": \"Note:\"\n}\n[/block]\nThe next step will update existing or new dependencies\n\n- If you installed composer locally: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php composer.phar update --no-dev --no-interaction\",\n      \"language\": \"shell\",\n      \"name\": \"Local composer\"\n    }\n  ]\n}\n[/block]\n- If you installed it globally:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"composer update --no-dev --no-interaction\",\n      \"language\": \"shell\",\n      \"name\": \"Global composer\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"This command will fail if Solder is not put into maintenance mode\",\n  \"title\": \"Note:\"\n}\n[/block]\nRegardless of whether or not there are changes to the database migrations, back up your database, and run a migrate to be sure.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php artisan migrate\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nBring the Solder application out maintenance mode.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php artisan up\",\n      \"language\": \"shell\",\n      \"name\": \"Maintenance mode off\"\n    }\n  ]\n}\n[/block]\n**If you installed Solder using composer create-project, please reinstall solder again using the most recent info on the Getting Started guide.**\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Updating from pre-v0.7\"\n}\n[/block]\n**Make sure to backup your SQL database and Modpack resources (images) before attempting**\n\nWhen updating your Solder install, you will be doing a complete wipe of the application. Just completely delete the entire solder installation and follow the Installation steps laid out in the [Getting Started](https://github.com/TechnicPack/TechnicSolder/wiki/Getting-Started) page. Once installed, follow the Laravel DB migration steps below.\n\n### Laravel DB migration changes\n\nLaravel changes the way it handles DB migrations which will cause problems when trying to migrate the new DB migrations in v0.7. \n\nThe old table name was set as 'laravel_migrations'. The new table name that tracks your migrations is set in `app/config/database.php` under the key-value pair `migrations`. Because of this, when you try to migrate the new changes, it will attempt to start from the beginning. \n\n- Old structure is as follows: 3 columns (bundle, name, batch).\n- New structure is as follows: 2 columns (migration, batch).\n\nThe `bundle` column can be deleted and the `name` column renamed to `migration`.\n\nOnce you have done that and renamed the table as well with `RENAME TABLE` `laravel_migrations` TO `migrations`.\n\nYou should be able to execute `php artisan migrate` without any more issues.","excerpt":"","slug":"updating-solder","type":"basic","title":"Updating Solder"}
[block:api-header] { "type": "basic", "title": "Updating from v0.7 and onward" } [/block] **Make sure to backup your SQL database before any update!** Put the Solder application into maintenance mode. [block:code] { "codes": [ { "code": "php artisan down", "language": "shell", "name": "Maintenance mode on" } ] } [/block] And then run a pull to get the latest changes from the GitHub repository. [block:code] { "codes": [ { "code": "git pull", "language": "shell", "name": "Pull new files/changes" } ] } [/block] [block:callout] { "type": "warning", "body": "If `git pull` fails with: \n```\nerror: The following untracked working tree files would be overwritten by merge:\nPlease move or remove them before you can merge.\nAborting\n```\n\nReset the repo to the latest version before the update\n`git reset --hard <version>`", "title": "Note:" } [/block] The next step will update existing or new dependencies - If you installed composer locally: [block:code] { "codes": [ { "code": "php composer.phar update --no-dev --no-interaction", "language": "shell", "name": "Local composer" } ] } [/block] - If you installed it globally: [block:code] { "codes": [ { "code": "composer update --no-dev --no-interaction", "language": "shell", "name": "Global composer" } ] } [/block] [block:callout] { "type": "warning", "body": "This command will fail if Solder is not put into maintenance mode", "title": "Note:" } [/block] Regardless of whether or not there are changes to the database migrations, back up your database, and run a migrate to be sure. [block:code] { "codes": [ { "code": "php artisan migrate", "language": "shell" } ] } [/block] Bring the Solder application out maintenance mode. [block:code] { "codes": [ { "code": "php artisan up", "language": "shell", "name": "Maintenance mode off" } ] } [/block] **If you installed Solder using composer create-project, please reinstall solder again using the most recent info on the Getting Started guide.** [block:api-header] { "type": "basic", "title": "Updating from pre-v0.7" } [/block] **Make sure to backup your SQL database and Modpack resources (images) before attempting** When updating your Solder install, you will be doing a complete wipe of the application. Just completely delete the entire solder installation and follow the Installation steps laid out in the [Getting Started](https://github.com/TechnicPack/TechnicSolder/wiki/Getting-Started) page. Once installed, follow the Laravel DB migration steps below. ### Laravel DB migration changes Laravel changes the way it handles DB migrations which will cause problems when trying to migrate the new DB migrations in v0.7. The old table name was set as 'laravel_migrations'. The new table name that tracks your migrations is set in `app/config/database.php` under the key-value pair `migrations`. Because of this, when you try to migrate the new changes, it will attempt to start from the beginning. - Old structure is as follows: 3 columns (bundle, name, batch). - New structure is as follows: 2 columns (migration, batch). The `bundle` column can be deleted and the `name` column renamed to `migration`. Once you have done that and renamed the table as well with `RENAME TABLE` `laravel_migrations` TO `migrations`. You should be able to execute `php artisan migrate` without any more issues.