~~NOTOC~~
====== Upgrade from 0.6.x ======

Please read [[http://astlinux.svn.sourceforge.net/viewvc/astlinux/branches/0.7/UPGRADE.txt|UPGRADE.txt]] and [[changes-0.7]] before you start.\\ If you are using mISDN with PCI cards please also read **[[misdn|this]]**. 

===== Automated Process =====

(new after 0.6.2)

Most normal users should use this process.  You can upgrade now from the web interface OR from the CLI

=== Using the web interface: === 

  - Browse to the System tab (assuming your Astlinux device is called pbx)
  - https://pbx/admin/system.php
  - The default repository is http://mirror.astlinux.org/firmware
  - If you want to test Asterisk 1.8 you need to change the "Repository URL" in the Prefs Tab to\\ http://mirror.astlinux.org/ast18-firmware
  - Select "check for new", check the confirm checkbox, then click the firmware button.

If a new version is found, you'll see a message at the top of the page after a short delay.

Next, change the dropdown to "upgrade with new", check the confirm checkbox, then click the firmware button.  The new firmware will be downloaded.  At that point, you will be prompted to reboot to use the new firmware.

If you used the firewall in the web GUI in 0.6, you will need to upgrade Arno's firewall:

  - Network tab > Firewall sub-tab > Save Settings
  - Firewall sub-tab > Restart Firewall
  - A message is displayed saying that the firewall supporting files need upgrading
  - Firewall sub-tab > Upgrade/Restart Firewall (check the Confirm box)

=== Command line interface: ===

On the command line, the commands are similar:

  - ''%%upgrade-run-image check http://mirror.astlinux.org/firmware%%''
  - ''%%upgrade-run-image upgrade http://mirror.astlinux.org/firmware%%''
  - Reboot when prompted

//or the URL from above for Asterisk 1.8.//

If you used the firewall in the web GUI in 0.6, you will need to upgrade Arno's firewall:

  - ''%%upgrade-arno-firewall upgrade%%'' or hand edit, copy and patch the ''%%/mnt/kd/arno-iptables-firewall/%%'' directory
  - ''$ vi /mnt/kd/rc.conf''
  - ''$ gen-rc-conf''
  - ''$ arno-iptables-firewall restart''

===== Manual Process =====

(Not required for most users)

Follow these steps to upgrade an existing Astlinux 0.5 or later installation.  You no longer need to transfer a completely new image using dd or physdiskwrite.  You don't even need to remove the media from your existing AstLinux device!  With AstLinux running, perform the following steps.

  - ''mount -o remount,rw /oldroot/cdrom''
  - Download the new files.  The upgrade files would be astlinux-XXX.tar.gz. For example, if the release is 0.6.0, the files will be distributed as astlinux-0.6.0-<ARCH>.tar.gz.  You could download these files onto a client PC or on your AstLinux device (in an area with enough free space)
  - Expand the archive:  tar -xzvf astlinux-0.6.0-<ARCH>.tar.gz
  - ''cd astlinux-0.6.0-<ARCH>; cp * /oldroot/cdrom/os'' (if downloaded and decompressed on your client PC, you'll want to use a tool to scp the files to the AstLinux device.

**NOTE:** AstLinux supports retaining multiple versions in the %%'%%''os''%%'%% directory.  To determine which revision is booted, a %%'%%''ver''%%'%% file is used.  This ''ver'' file should contain a single line that lists the version to boot (for example: astlinux-0.6.1)  If no ''ver'' file is present, the boot loader will load the 'highest revision', determined alphabetically (so 0.6-2011 would be newer than 0.6.2).  So be careful if upgrading from an SVN version!
===== Possible Issues =====

=== NICs ===
If your existing 0.6 installation has NICs of more than one type (different chipsets/drivers), there is the possibility that the numbering of these NICs under 0.6 (eg ''eth0'', ''eth1'', etc) will change once upgraded to 0.7. Please bear this in mind, especially if attempting a remote upgrade. For an explanation, see [[userdoc:tt_change_net_hardware|Changing Network Hardware]].

=== Asterisk CLI commands ===
You may also need to change the Active Channels, Voicemail and Reload Asterisk Commands, in the Prefs tab:

  * Active Channels Command: ''core show channels''
  * Voicemail Users Command: ''voicemail show users''
  * Reload Voicemail Command: ''module reload app_voicemail.so''
  * Reload Asterisk Command: ''module reload''