New Installation

Starting with Astlinux 0.6.3 a new simple installation method is available that performs many steps from a web interface.

1. Download the appropriate astlinux-XXX.img.gz file from the AstLinux website. ¹⁾
2. On Linux or *BSD use dd to transfer the image to the CF card. (gunzip the image, then dd if=astlinux-XXX.img of=/dev/sdX where sdX is your compact flash card).
   On Windows boxes, you'll want to use physdiskwrite (0.5.1 or later).
3. Boot your system.
4. Continue the installation below using the web interface

Astlinux supports two methods of persistent storage. You must use unionfs for some settings (such as passwords and changes to the root system), but you can optionally use an additional 'keydisk' partition. The 'keydisk' contains key information about your system such as the Asterisk configuration files, system settings and voicemail messages. Using a single unionfs partition contains all persistent information and is recommended for new installations.

Using a computer on your network, open your favorite browser type the following.
https://pbx.local/admin/setup.php (pbx.local is the IP address of your PBX).
Please be sure that you really use https (http will NOT work).
The default user is admin with a password of astlinux


Now you will see the following screen:



Here you can choose how you want to configure your persistent storage. The drop-down box shows the proposed installation device. Read the instructions carefully and do as it says. Choose wisely!
Then click Continue, the screen below will be displayed.



The “System is Rebooting…” will disappear when the reboot is complete, then click Finish, after a short delay the system will reboot once again.
Note: Since reboot times can vary, your browser may fail to automatically reload, don't worry, wait a minute and manually reload your browser to continue.
Normally you will not see the screen below, your browser should be redirected to the Status page, but if you reload the browser to /admin/setup.php after a successful installation, you will see the screen below. If so, click Continue, to view the Status page.



You can confirm that the setup was successful by logging into your pbx.
https://pbx.local (pbx.local is the IP address of your PBX).
You will get the following screen. (Note: This is only part of the full screen.)



The /dev/sda1 partition is your original partition created by installing the Astlinux-XXX.img. /dev/sda2 is the combined keydisk + UnionFS partition. If you selected seperate partitions, the UnionFS partition would be /dev/sda2 while the key disk would be /dev/sda3.

The same procedure as above can also be done on the command line, e.g. when your NIC isn't working right from the start (/dev/sda is an example, it can be different on your box):

$ initial-setup status
ok-format /dev/sda

$ initial-setup format combined /dev/sda  (or for a separate partition: format separate /dev/sda 128)

$ reboot

$ initial-setup configure /dev/sda

$ reboot

1. Click the System tab, change the “admin” password.
   
   after which you will be asked to login with your new password.
2. If you are using AstLinux 0.7.1 or later, continue in the System tab to the Asterisk Sounds Packages section.
   
   Select the package values (ex. core-english-ulaw), then select the action (ex. Upgrade/Install), then click on the Sounds Package button to perform the action. Usually a 'core' and 'moh' sound package using your native codec is all that is necessary, or at least a good start.
   Note: The default “Sounds Pkg URL” currently supports English, Spanish and French. But you can set a different “Sounds Pkg URL” in the Prefs Tab at “System & Staff Tab Options” to install other (or your own) sounds.
3. Your system is ready to use!