How to manually upgrade a YACS server?
If you cannot benefit from the semi-automated upgrade facility, you will have to do it by hand. It is not so complicated, however, if you take care of some important things.
[title]When does this apply?[/title] You could ask yourself: "Since we do have these extraordinary scripts that have been specifically developed to perform smooth upgrades, why bother?" Well, actually, there are very good reasons to not use all of these scripts:
[*] The server has been screwed up, and the automatic scripts don't work for some reason.
[*] You would like to achieve a customized set of files, maybe to prepare a reference server of your own. The automatic upgrade could kill your setup. In all cases we recommend you to pass through following steps, which are similar to those supported by the automatic assistant, except for files staging.
[*] Your ISP prevents your server to establish network connections with external hosts, and YACS is just unable to fetch something from the reference server.
[title]How to proceed?[/title] [*] Authenticate as an associate and switch the server off from the Control Panel (use the 'Switch' link that appears in the menu below the title). Do not close the browser window to preserve session state.
[*] Upload and change any script that has to be updated. If you are handling the YACS archive, you will have to push every file to the server.
[*] Switch back to the browser window and, from the Control Panel, click on the Extensions link. Accept the scan and check scan results. If some scripts require new tables, this will be made available to subsequent scripts, including the database setup.
[*] Then, from the Control Panel, click on the Optimization link. Then click on the large button to adapt the database stucture. This will ensure that fields and indexes are declared to MySQL as expected.
[*] Apply any run-once script, if any. To achieve this, from the Control Panel click on the Scripts link. On the following page, if a 'Run once' link appears below page title, click on it to finalize the installation.
[*] Go back to the Control Panel and hit the 'Purge' link to clear the cache.
[*] As a final step do not forget to switch the server on again.
[*] The server has been screwed up, and the automatic scripts don't work for some reason.
[*] You would like to achieve a customized set of files, maybe to prepare a reference server of your own. The automatic upgrade could kill your setup. In all cases we recommend you to pass through following steps, which are similar to those supported by the automatic assistant, except for files staging.
[*] Your ISP prevents your server to establish network connections with external hosts, and YACS is just unable to fetch something from the reference server.
[title]How to proceed?[/title] [*] Authenticate as an associate and switch the server off from the Control Panel (use the 'Switch' link that appears in the menu below the title). Do not close the browser window to preserve session state.
[*] Upload and change any script that has to be updated. If you are handling the YACS archive, you will have to push every file to the server.
[*] Switch back to the browser window and, from the Control Panel, click on the Extensions link. Accept the scan and check scan results. If some scripts require new tables, this will be made available to subsequent scripts, including the database setup.
[*] Then, from the Control Panel, click on the Optimization link. Then click on the large button to adapt the database stucture. This will ensure that fields and indexes are declared to MySQL as expected.
[*] Apply any run-once script, if any. To achieve this, from the Control Panel click on the Scripts link. On the following page, if a 'Run once' link appears below page title, click on it to finalize the installation.
[*] Go back to the Control Panel and hit the 'Purge' link to clear the cache.
[*] As a final step do not forget to switch the server on again.