~~NOTOC~~
====== Upgrade from 0.7.x to 1.0.x ======

Please read [[http://svn.code.sf.net/p/astlinux/code/tags/1.0.0/docs/ChangeLog.txt|1.0.x ChangeLog.txt]] before you start.

It is very important to understand that while AstLinux 0.7.x uses the runnix-0.3 bootloader, AstLinux 1.0.x requires the runnix-0.4 bootloader.  This change is required since the Linux Kernel differences require different //squashfs// image formats.

If you ever use the Web Interface, follow the Web Interface instructions here so the Prefs Tab gets changed properly.

Follow the steps below, should an error occur, **don't reboot** until you have resolved the error.
===== Using the Web Interface: =====

!!Note: AstLinux 0.7.x can't upgrade to runnix-0.4 via the Web Interface, the CLI must be used to finish.!!\\
You must have either console or SSH access to your AstLinux box to perform this upgrade.

First, browse to the Prefs Tab {{:userdoc:up10-prefs-tab.png?nolink|Prefs Tab}}\\
(assuming your Astlinux device is called pbx)

  https://pbx/admin/prefs.php

For Asterisk 1.8 define: //(Replace ''ast18'' with ''ast11'' in URL for Asterisk 11)//\\
{{:userdoc:up10-ast18-repo-prefs.png?nolink|Asterisk 1.8}}

Or, if you are still using Asterisk 1.4 define:\\
{{:userdoc:up10-ast14-repo-prefs.png?nolink|Asterisk 1.4}}

save changes by clicking {{:userdoc:up10-save-prefs.png?nolink|Save/Apply}}


Next, browse to the System Tab {{:userdoc:up10-system-tab.png?nolink|System Tab}}\\

  https://pbx/admin/system.php

Check for new firmware:\\
{{:userdoc:up10-check-firmware.png?nolink|Check for Firmware}}

If new firmware is available, upgrade firmware:\\
{{:userdoc:up10-upgrade-firmware.png?nolink|Upgrade Firmware}}

If successful, !!don't reboot!! yet, **from the Command Line Interface**, upgrade RUNNIX:

  upgrade-RUNNIX-image check http://mirror.astlinux-project.org/runnix4
    (should respond... Newest available version is: runnix-0.4-xxxx)
    
  upgrade-RUNNIX-image upgrade http://mirror.astlinux-project.org/runnix4

Finally, if successful, Reboot, either from the Web Interface or CLI:\\
{{:userdoc:up10-reboot.png?nolink|Reboot}}

Or

  reboot

===== Command Line Interface (CLI): =====

First, upgrade AstLinux Firmware (Replace ''ast18'' with ''ast11'' in URL for Asterisk 11)

  upgrade-run-image check http://mirror.astlinux-project.org/ast18-firmware-1.x
    (should respond... Newest available version is: astlinux-1.0.x)
  
  upgrade-run-image upgrade http://mirror.astlinux-project.org/ast18-firmware-1.x

Next, upgrade RUNNIX:

  upgrade-RUNNIX-image check http://mirror.astlinux-project.org/runnix4
    (should respond... Newest available version is: runnix-0.4-xxxx)
    
  upgrade-RUNNIX-image upgrade http://mirror.astlinux-project.org/runnix4

Finally, if successful, Reboot:

  reboot

\\ 
----
\\ 
In case something went wrong, you can find help **[[userdoc:runnix_astlinux_mismatch|here]]**, but you will need serial/video console access.