Installation

From Askozia Handbook
Jump to: navigation, search

AskoziaPBX is distributed as a firmware image which needs to be installed on storage media readable by your telephone system. It is not a standalone piece of software but rather a complete operating system for your hardware. This chapter describes step by step how to install AskoziaPBX on different platforms.

There are multiple ways to get your system up and running:

  • Using the Live CD .iso file for installing and running AskoziaPBX on a PC, server or virtual machine
  • Using the Live USB Drive .bin file for installing and running AskoziaPBX on a PC or server
  • Using the .img file for direct installation on a boot media that can be read by your target system


Contents

Virtual Machine

AskoziaPBX can be installed on a virtual machine (VM) by means of the .iso image file included in the .zip archive obtained after purchasing AskoziaPBX.


Oracle VirtualBox

Follow the steps described in the video below to install AskoziaPBX in VirtualBox.


VMware

To install AskoziaPBX in VMware, follow the steps shown in the video below.


Microsoft Hyper-V

Hyper-V is a Server virtualization environment created by Microsoft with the intent of running Multiple Virtual Servers on a single server platform. Hyper-V is an Enterprise Virtual Environment, allowing to run AskoziaPBX in a virtual environment, as long as sufficiently dimensioned hardware is used.


Requirements

AskoziaPBX requirements:

  • Firmware version 2.2 and up


Server requirements:

  • Operating System:
    • Windows Server 2008 R2 (Standard, Enterprise, or Datacenter)
    • Windows Server 2012 (Standard or Datacenter)
    • Server 2008 R2 and 2012 are only available in 64-bit versions. (Server 2008 R1 is not recommended, as latency was known to be an issue in this version.)
    • Windows 8 Pro may be an alternative as it is the first client OS to come with Hyper-V. However, note that it is not designed to be a server and may not handle other processes simultaneously.
    • For Optimal performance, server hardware is recommended. In the following scenario, we are using Server 2008 R2 Standard.


  • Hardware:
    • Server-grade motherboard such as by Dell, HP, IBM or Cisco. (Desktop motherboards are intended for single terminal communication and may not provide the stability needed to run AskoziaPBX in a virtual environment.)
    • A Dell Poweredge server was used for a test period of 8 months with no complications.
    • If using desktop hardware, it is recommended that you stick with Intel systems. Dell OptiPlex would be an alternative.
    • If the server is custom build, it is recommended to stick with Intel and Asus brand motherboards for best performance.


  • CPU:
    • Intel Xeon processor with 64-Bit architecture. (Other Intel CPUs may work but virtual Askozia has only been tested with an Intel Xeon CPU.)
    • AMD CPUs are not recommended as they tend to have a timing lag which can affect call quality and possibly PBX stability.
    • If a Xeon processor is not available, the Intel i5 and i7 will work as an alternative. Intel i3 are not designed for optimal virtualization performance.
    • Make sure that Virtualization is turned on in the Server BIOS.


  • Memory:
    • At least 512 MB of RAM available for each AskoziaPBX.


  • Network adapter:
    • Intel or Broadcom GB Server-grade network adapter. Single Port minimal. As an alternative, any Intel or Broadcom network cards should be fine.
    • Realtek network cards are not recommended, as they are typically emulated processes and cause latency issues which could affect the quality and stability of the PBX.


  • Hard drives:
    • In a server environment, it is recommended that your server operating system (OS) and data store are located on different drives or arrays.
    • For optimal performance, your virtual machines should run on the data drive or array.
    • Recommended hard drive configurations:
      • Dedicated hard drive or array (RAID 1) for host OS.
      • Secondary Drive or Array (RAID 1,5,10) for guest OS or, in this case, AskoziaPBX.


Test environment

AskoziaPBX has been tested for a period of 8 months under the following conditions.

  • Dell Poweredge T-310 (Intel motherboard)
  • Windows Server 2008 R2
  • Intel Xeon 2.9 GHz quad core CPU
  • 2 Raid 1 arrays
    • 1st array for Host OS
    • 2nd array for data to store a guest OS or AskoziaPBX
  • 16GB DDR3 server-grade hardware
  • Dual port gigabit Broadcom NIC


Preparing VM storage location

In virtual environments, it is good practice to run your virtual machine and other shared network resources on a different drive or array than the one your operating system runs on. This allows for better performance, but also reduces the risk of local OS processes effecting the quality and performance of your virtual machines. In this step, a folder will be created on the data drive where the virtual machines will be stored and the VM files for AskoziaPBX will be saved.

1.1 Klick on Start and select Computer to open Windows Explorer.

1.2 Identify and open the data drive. In this example, the data drive is drive "F".

1.3 If you don’t already have a place to store VM files on the data drive, create and name a new folder in the root directory. In this case, the folder is named "Virtual Machines".

1.4 Open the folder where the VM files are to be stored.

1.5 In this folder, create a new sub-folder where the VM files for AskoziaPBX will be saved. Name the folder according to what the VM is used for. In this case, the folder will be named "Askozia".


Launch Hyper-V Manager

Next, you need to open the Hyper-V Manager that is located in the Control Panel, under Administrative Tools (Control Panel\Administrative Tools\Hyper-V Manager).

If the Hyper-V Manager is not available in Administrative Tools, the Hyper-V Role may need to be installed. To install the Hyper-V Role, follow the next steps.

2.1. Open the Server Manager located in Administrative Tools in the Control Panel.

2.2. In the Server Manager, right-click on Roles and select Add Roles. The Add Roles Wizard will open.

2.3. Select Next to see a list of Roles to install.

2.4. Activate the check box next to Hyper-V and select Next to continue. Continue to click Next in all following menus until you are prompted to Install.

2.5. Click Install to begin install the Hyper-V Role. Once Installed, a reboot will be required.


Create virtual network

In the Hyper-V Manager, a virtual network is first to be created to interface with your physical network.

3.1. In the Actions panel, select Virtual Network Manager

Create virtual network


3.2. In the Virtual Network Manager, select External as the virtual network type. Then, click on Add.

Choose network type


3.3. Follow the following steps in the New Virtual Network Wizard.

  1. Name the virtual network. In this example, it is named "Virtual Network".
  2. Select the network card you want this virtual network to connect to. Make sure to check the box Allow management operating system to share this network adapter.
  3. Select Apply to save your settings.
Name network and choose connection type

Now, your virtual network will be completed.


Create virtual machine

Now, the virtual machine needs to be created to host AskoziaPBX. Follow each step to ensure optimal performance.

4.1. In The Hyper-V Manager, go to the Actions. Click on New and select Virtual Machine.

Create virtual machine


4.2. The New Virtual Machine wizard will open. Select Next to continue.

New Virtual Machine wizard


4.3. Specify name and location section of the New Virtual Machine wizard

  1. Name the virtual machine. In this example, the VM is named "Askozia".
  2. Activate the check box Store the virtual machine in a different Location to enable the location field. Click on "Browse" and select where to save the virtual machine.
  3. Once done, click on Next to continue.
Specify VM name and location


4.4. In the Assign Memory section of the wizard, specify the amount of physical memory from your server to be dedicated to this virtual machine. Set the memory at least to 512 MB and select Next to continue.

Assign memory


4.5. In the Configure Networking section of the wizard, leave the connection as Not Connected and select Next to continue.

Configure networking


4.6. Connect Virtual Hard Disk section of New Virtual Machine wizard

The first virtual drive is to be created to store the AskoziaPBX firmware. In a later step, a second virtual drive will be created to store media data such as voicemail, fax and hold music.

  1. Select the radio button Create a Virtual Hard Disk. The name and location should reflect the name and location of the virtual machine specified in previous steps.
  2. Behind the name of the virtual drive, add an identifier to clarify that this will be used for the AskoziaPBX firmware. In this example, the virtual machine is named "AskoziaOS.vhd".
  3. Specify the Size of this virtual drive. In this example, the size is set to 16GB.
  4. Once the settings are completed, select Next to continue.
Connect virtual drive


4.7. In the Installations Options, the media will be selected from which AskoziaPBX is to be installed. In this example, the ISO image included in the ZIP archive of the PBX is used.

  1. Select the radio button Install an operating system from boot CD/DVD-ROM.
  2. Select the radio button Image File (.iso). Click on Browse to locate the location of the saved ISO image file. Please note that you can also use physical media.
  3. Once you have selected your installation media, select Next to continue.
Select installation media


4.8. In the Completing the New Virtual Machine wizard, now a review of the options is shown, that you have chosen for the VM.

  • If something still needs to be changed, select Previous to go back.
  • If everything looks correct, select Finish.
Completing the "New Virtual Machine" wizard


4.9. There are still more options to be configured for the VM in its settings. In the Hyper-V Manager console, click on the VM you just created. Then, select Settings in the Actions panel on the right side.

More settings in Hyper-V Manager console


4.10. The second virtual drive is to be installed that is required to store the media data such as voicemail, fax and hold music).

  1. Select IDE Controller 0 in the hardware panel on the left side.
  2. In the right column, select Hard Drive and click on Add.
Create second virtual drive - select type


4.11. In the Hard Drive panel on the right, select New to create a new virtual drive.

Create second virtual drive - add HDD


4.12. The New Virtual Hard Disk wizard” will open. Select Next to continue.

New Virtual Hard Disk wizard


4.13. In the Choose Disk Type section of the wizard, keep the default setting Fixed Size and select Next to continue.

Choose disk type


4.14. Specify Name and Location section of the New Virtual Hard Disk wizard

  1. Assign a meaningful name to the new virtual drive. In this exercise, it is named “AskoziaMedia.vhd.”
  2. Click on Browse and specify where to save the new virtual drive.
  3. Select Next to continue.
Specify name and storage location


4.15. In the Configure Disk section of the wizard, specify the size of the new virtual drive. In this example, we set the size to 16 GB. Once size has been specified, click on Next to continue.

Configure disk


4.16. Review the settings you have chosen for the new virtual drive.

  • If something still needs to be changed, select Previous to go back.
  • If everything looks correct, select Finish.
Finish "New Virtual Hard Drive" wizard


4.17. The virtual network adapter included in the virtual machine by default is intended for Microsoft Windows virtual machines. In the next few steps, the default network adapter intended for Windows is replaced by legacy adapter intended for Linux operating systems as required by AskoziaPBX to run in a Hyper-V environment.

  1. In the Settings menu for the new virtual machine, go to the Hardware panel on the left side and select Network Adapter.
  2. In the Network Adapter panel on the right side, select Remove.
Remove virtual network adapter for Microsoft Windows


4.18. Now, the legacy network adapter for Linux operating systems is to be added.

  1. In the Settings menu for the new virtual machine, go to the Hardware panel on the left side and select Add Hardware.
  2. In the Add Hardware panel on the right side, select Legacy Network Adapter and click on Add.
Add virtual network adapter for Linux


4.19. The previously created virtual network needs to be selected for the legacy network adapter.

  1. In the Settings menu for the new virtual machine, go to the Hardware panel on the left side and select Legacy Network Adapter.
  2. In the Legacy Network Adapter panel on the right side, go to the Network drop-down menu and select the virtual network you created earlier.
Select previously created virtual network


4.20. Select OK to complete configuring the new virtual machine.


Installing AskoziaPBX on virtual drive

5.1. The new virtual machine is now to be started and AskoziaPBX to be installed. In the Hyper-V Manager console, select the virtual machine. Then, go to the Actions panel on the right side and click on Start followed by Connect.

Starting the virtual machine


5.2. The virtual machine will now start up and load the installation media. In the AskoziaPBX console, select 8) Install on Hard Drive followed by pressing Enter on your keyboard.

Starting installation of AskoziaPBX on virtual drive


5.3. Now, the virtual drive has to be selected where AskoziaPBX is to be installed. We use the first drive in the list, which is intended for the OS, by hda followed by pressing Enter on the keyboard.

Choosing the virtual drive


5.4. A warning message will appear and explain the actions that will take place hereafter, as well as the option to reboot after installation. Enter Y and confirm by pressing Enter on your keyboard to continue and reboot. AskoziaPBX will now be installed on the OS virtual drive and reboot afterwards.

Confirming choice of hard drive


5.5. After AskoziaPBX has been installed, the installation media has to be removed. In this example, an ISO image file was used and AskoziaPBX can boot from the OS hard drive.

  1. Select Media from the menu, followed by Eject under DVD Drive.
  2. Enter 5 in the AskoziaPBX console, followed by pressing Enter to reboot from the virtual drive.
Removing installation media


Now, AskoziaPBX is installed in Hyper-V with the best optimal configuration. From this point on, the rest of the installation will be the same as any installation on hardware. Continue with the chapter Getting Started with AskoziaPBX to set the IP address of AskoziaPBX and access the web interface.


Preparing Target Drive using Mac OS X

For both Live USB and direct media installation, a target drive needs to be prepared first. This section explains how to do it using Mac OS X. For Linux or Microsoft Windows, please check the subsections of the Live USB or direct media installation section.

We assume that you already have purchased the correct firmware image for your system and saved it to your desktop. Before you connect the target device to your computer, open the Terminal. To open the Terminal, first press cmd+space to open the Spotlight application. In Spotlight, enter Terminal and confirm by pressing enter. The Terminal should now open.

Now, execute the following command in the terminal.

ls /dev/disk*

This command shows which disks are recognized by the operating system, in this case "disk0" with the partitions "disk0s1" and "disk0s2". It is important to know this before attaching the disk in order to enable you to easily identify the disk to install the firmware on, which will be added in the next step. For now, the Terminal should show something like the output below.

macbook:myMac$ ls /dev/disk*
/dev/disk0  /dev/disk0s1   /dev/disk0s2 
macbook:myMac$

Now, attach the disk you would like to install AskoziaPBX onto and re-execute the command used before in the Terminal.

ls /dev/disk*

At this point, one additional device should show up in the overview.

macbook:myMac$ ls /dev/disk*
/dev/disk0  /dev/disk0s1   /dev/disk0s2   /dev/disk2   /dev/disk2s1
macbook:myMac$

Now, open the program "Disk Utility". To open Disk Utility, press "cmd+space". This again opens the program "Spotlight". In Spotlight, enter Disk Utility and confirm by pressing enter. The Disk Utility window should now open.

In Disk Utility, locate your target disk for the installation and unmount all partitions.

Unmount Recognized Partitions

The target device for the AskoziaPBX installation (in this case "disk2") is unmounted and its name is known. We can now install the firmware. Depending on the hardware used, this may take some time.


Live Mode

Live Mode allows both testing as well as installing AskoziaPBX on a new system. The phone system is to be started from an external boot medium which can be a Live CD or Live USB drive. After booting the system and entering valid license keys, the full feature-set of the PBX can be accessed. However, as the system is booted from a Live CD or Live USB drive, all changes in its configuration are lost after a restart or shut-down. To start installing AskoziaPBX, first download its .zip archive file. The .zip archive includes different image files such as an .iso image file and a .bin file.

For installing AskoziaPBX by means of a Live CD, burn the .iso image file to a CD using your favorite disk burning software. This is the easiest method if the target system is a PC or server with a monitor and keyboard being connected. After inserting the Live CD into your CD drive and booting the system, you can install AskoziaPBX as explained in Live Mode: Installing AskoziaPBX.

Alternatively, AskoziaPBX can be installed by means of a Live USB drive. For this purpose, the .bin file first needs to be written to an USB drive as explained below for Mac OS X users and Microsoft Windows users. Please note that the USB drive has to have a minimum size of 512MB. After writing the image file to the Live USB drive, it can be connected to your system and the system can be booted. After booting the system, install AskoziaPBX as explained in Live Mode: Installing AskoziaPBX.


Live USB: Writing Image using Mac OS X

After you have prepared the target device, you can enter the following commands.

sudo bash - requires the admin password of the Mac

dd if=desktop/askozia-pbx-generic-pc-x86-i486-uclibc-x.x.bin of=/dev/disk1 bs=1m

The finished writing process will be confirmed with the following output. The required time to write the image to the drive depends on the writing speed of the used USB drive.


53481+0 records in<br/>
53481+0 records out<br/>
27382272 bytes transferred in 28.288661 secs (967959 bytes/sec)<br/>
macbook:myMac$

After writing the image file to the Live USB drive, it can be connected to your system and the system can be booted. After booting the system, install AskoziaPBX as explained in Live Mode: Installing AskoziaPBX.


Live USB: Writing Image using Windows

To create a bootable USB drive for AskoziaPBX, first download the askozia-pbx-generic-pc-x86-i486-uclibc-x.x.zip, and unpack the archive on your desktop.

To write AskoziaPBX to the USB drive, we recommend to use the application imageUSB. It can be downloaded here, for free.

After downloading and installing the program, the USB drive can be created using the following steps.

Open imageUSB and connect the USB drive to your PC. Using Refresh drives the list of drives gets refreshed.

Mounting the USB drive


Choose the USB drive as the target drive. Further select the .bin file to write it to the USB drive.

Select USB drive


Click Write to UFD to start the copy.

Start writing the image


After finishing, there will be a confirmation message.

Writing successful


After writing the image file to the Live USB drive, it can be connected to your system and the system can be booted. After booting the system, install AskoziaPBX as explained in Live Mode: Installing AskoziaPBX.


Live Mode: Installing AskoziaPBX

If you are using a Live CD, boot it in the system you wish to install AskoziaPBX on. Accordingly, if you are using a Live USB drive, connect it to the system you wish to install AskoziaPBX on. Once a monitor and keyboard are connected and the system is booted, Askozia's console menu appears.

***This is AskoziaPBX, version x.x
built on Mon xxx xx xx:xx:xx CET xxxx for Generic
AskoziaPBX is Copyright (C) 2015 plaintel GmbH. All rights reserved.
m0n0wall base Copyright (C) 2002-2007 Manuel Kasper. All rights reserved.

LAN IP address assigned via DHCP: xxx.xxx.xxx.xxx


PBX console setup
*****************
1) Interfaces: assign network port
2) set up LAN IP address
3) Reset webGUI password
4) Reset to factory defaults
5) Reboot system
6) Ping host
7) Asterisk Console
8) Install on Hard Drive

Enter a number: _

Select option 8 to start the installation. All available target hard drives are listed. In this example it is only one drive called "hda".

Valid disks are:

hda: 2097152 sectors (1073 MB) w/32KIB Cache, CHS=2080/16/63

Enter the device name you wish to install onto: hda

Enter the desired target hard drive, in this case hda, to install AskoziaPBX there.

Presentation for your system might be different. It does not necessarily have to be "hda", depending on how many devices your system has recognised. Note that the installation will delete everything on the target hard drive. Please choose carefully.

********************************************************
* WARNING!											  
* The PBX is about to be installed onto the hda device.
* - everything on this device will be erased!          
* - this cannot be undone!							   
********************************************************

The PBX will reboot after installation. 

Do you want to proceed? (y/n) y

Confirm again with y.

Installing...done
Copying configuration...done

Once the installation is finished, the system will reboot. Please make sure the boot devices are set in the correct order or simply remove the Live USB drive or Live CD for the system to boot from the hard disk.


Direct Media Installation

If your target system is an embedded system or does not have an attached CD drive, you will need to install the firmware directly on to its media. This boot media could be a CompactFlash card, an SD card, a hard drive or a USB flash drive. Anything your target system can boot from will work.

First, you need to purchase the appropriate image for your hardware from the Askozia shop.


Linux

This section was written using Ubuntu as a reference. Nevertheless, the utilization of the command prompt should make it uniform for other Linux distributions as well.

Let us assume that you have purchased the correct firmware image for your system from the Askozia shop and saved it to your desktop. Before you attach your target system's boot media to your system, open the Terminal.

After opening the Terminal, change into the desktop directory where you have downloaded the firmware.

ubuntu@ubuntu:~$ cd Desktop

Now, before attaching target drive we need to know which disks are present and how they are named. The following command lists all drives recognized by the system.

sudo fdisk -l 

The Terminal should look like this:

ubuntu@ubuntu:~/Desktop$ sudo fdisk -l | grep "Disk /dev/"
Disk /dev/sda: 21.5 GB, 21474836480 bytes

Attach the target drive you wish to install the firmware onto and re-execute the previous command:

sudo fdisk -l | grep "Disk /dev/"

The command reveals the target's drives name:

ubuntu@ubuntu:~/Desktop$ sudo fdisk -l | grep "Disk /dev/"
Disk /dev/sda: 21.5 GB, 21474836480 bytes
Disk /dev/sdb: 1999 MB, 1999568384 bytes

In this case it is /dev/sdb, which has a size of 1999MB.

If the drive was recognized by the system it has probably already been automatically mounted. The firmware cannot be installed on a mounted disk. Execute the following command to find out where the disk is mounted.

df | grep "/dev/sdb"

In the Terminal you see the following:

ubuntu@ubuntu:~/Desktop$ df | grep "/dev/sdb"
/dev/sdb1 1952192 1600 1950592 1% /media/KINGSTON

In this case the disk has only one partition. The partition which needs to be unmounted is /dev/sdb1. To unmount this partition, execute the following command:

sudo umount /dev/sdb1

In the Terminal you see the following:

ubuntu@ubuntu:~/Desktop$ sudo umount /dev/sdb1

Now, that the system is no longer directly using the target disk, we can install the firmware on to it. The following command decompresses the image and installs it onto the target disk. The warning about "trailing garbage" is due to the digital signature on AskoziaPBX firmwares.

sudo gunzip -c askozia-pbx-myplatform-myversion.img | sudo dd of=/dev/sdb bs=1m

ubuntu@ubuntu:~/Desktop$ sudo gunzip -c
askozia-pbx-myplatform.myversion.img | sudo dd of=/dev/sdb bs=1m

gzip: askozia-pbx-myversion.myplatform.img: decompression OK,
trailing garbage ignored
63825+0 records in
63825+0 records out
32678400 bytes (33 MB) copied, 7.54102 s, 4.3 MB/s
ubuntu@ubuntu:~/Desktop$

To check if the firmware was written correctly, detach and reattach it to your Linux system and check if there are two partitions on the disk.

The installation is finished and AskoziaPBX can now be used.


Mac OS X

After you have prepared the target device, you can use the following command to decompress the image file and install it on the target device.

gzcat Desktop/askozia-pbx-myplatform-myversion.img | dd of=/dev/disk2 bs=1m

Please note that it takes a couple of seconds to write the image to the disk after you've entered the password. Depending on the Mac OS X version you are using, the Terminal should look like this afterwards:

macbook:myMac$ sudo bash
Password:
gzcat Desktop/askozia-pbx-myplatform-myversion.img | dd of=/dev/disk2 bs=1m
53481+0 records in
53481+0 records out
27382272 bytes transferred in 28.288661 secs (967959 bytes/sec)
macbook:myMac$

or

macbook:myMac$ sudo gzcat Desktop/askozia-pbx-myplatform-myversion.img | dd of=/dev/disk2 bs=1m
Password:
53481+0 records in
53481+0 records out
27382272 bytes transferred in 28.288661 secs (967959 bytes/sec)
macbook:myMac$

Once writing is finished, you can see in Disk Utility that the disk has two new partitions. Use the Eject button to this disk from the system.

The installation is finished and AskoziaPBX can now be used.


Windows Vista, Windows 7 and 8

Let us assume that you have purchased the correct firmware image for your system from the Askozia shop and saved it to your desktop. Also, attach the target device, on which you wish to install AskoziaPBX, to your PC.

To write the firmware to the target drive you need the program "physdiskwrite". You can download this free of charge from the m0n0wall webpages. Download the version without PhysGUI (Graphical User Interface). Unzip the file with your favorite tool and save it to your desktop.

First, we need to format the target drive because existing data and partitions might influence the installation. In order to do this you need to open the command prompt.

You need to execute the command prompt as the administrator. Signing in as the administrator is not enough. To open the command prompt click on Start, enter cmd in the text box below and confirm with enter. Click right-click on "command prompt" in the appearing list. Then choose Run as administrator.

Enter diskpart in the window of the command prompt. The command opens the windows program "Diskpart". You can format the target drive using Diskpart. After executing the command you will see this:

C:\Windows\system32\diskpart

Microsoft DiskPart version 6.1.7600
Copyright (C) 1999-2008 Microsoft Corporation.
On computer: My-PC

Enter list disk to list all devices Windows has recognized.

DISKPART> list disk

  Disk ###  Status         Size     Free     Dyn  Gpt
  --------  -------------  -------  -------  ---  ---
  Disk 0    Online          149 GB  1024 KB
  Disk 1    Online          247 MB   214 MB

Choose the drive you would like to format by entering the command select disk x. Replace the x in the example with the drive number of the target drive. Make absolutely sure you have chosen the correct drive.

DISKPART> select disk 1
Disk 1 is now the selected disk.

The command clean formats the target drive. Make absolutely sure you have chosen the correct drive.

DISKPART> clean

Enter exit to quit Diskpart.

DISKPART> exit

After formatting the target drive we can now install AskoziaPBX.

We will assume that you have saved physdiskwrite to your desktop. You need to enter cd Desktop to change in to the installation directory. Enter the following command to start the installation:

physdiskwrite.exe -u askozia-pbx-myplatform.myversion.img
C:\Users\MyUsername\Desktop>physdiskwrite.exe 
askozia-pbx-myplatform-myversion.img	

physdiskwrite v0.5.2 by Manuel Kasper <![CDATA[<mk@neon1.net>]]>

Searching for physical drives...

Information for \\.\PhysicalDrive0:
   Windows:       cyl: 19452
                  tpc: 255
                  spt: 63
   C/H/S:         16383/16/63
   Model:         ST3160815AS
   Serial number: 9RX4H316
   Firmware rev.: 3.ADA

Information for \\.\PhysicalDrive1:
   Windows:       cyl: 31
                  tpc: 255
                  spt: 63

Which disk do you want to write? (0..1) x

You choose the target drive for the installation by entering its number. Replace the x in the example with the appropriate drive number of the target drive. Make absolutely sure you have chosen the correct drive.

In this example PhysicalDrive0 is the hard disk of the system. PhysicalDrive1 is the target drive for the AskoziaPBX installation. Here we choose 1.

About to overwrite the contents of disk 1 with new data. Proceed? (y/n) y

Enter y to write the firmware to the disk. This might, depending on the hardware used, take some time. Once it has finished writing, you will see something similar to this:

Found signed compressed image file
33554432/33554432 bytes written in total

The installation is finished and AskoziaPBX can now be used.


Windows XP

Let us assume that you have purchased the correct firmware image for your system from the Askozia shop and saved it to your desktop. Also, attach the target device, on which you wish to install AskoziaPBX, to your PC.

To write the firmware to the target drive you need the program "physdiskwrite". You can download this free of charge from the m0n0wall webpages. Download the version without PhysGUI (Graphical User Interface). Unzip the file with your favorite tool and save it to your desktop.

First, we need to format the target drive because existing data and partitions might influence the installation. Right-click on My Computer and choose Manage.

Open Disk Management

Then click on Disk Management.

Then right-click on the target drive for the installation. Choose Format. Make absolutely sure you have chosen the correct drive.

Format Target Disk

In case your target drive has more than one partition, you need to delete these. Skip this part if there is only one partition on your installation disk.

To delete a partition right-click on the partition and then on Delete Volume. A warning shows up before the partition is deleted. Confirm with OK to delete the partition. Repeat this for all partitions on the target drive.

Delete Volume

After formatting, we can now install AskoziaPBX. We will assume that you have saved physdiskwrite to your desktop.

Open the windows command prompt to install the firmware on the target drive using physdiskwrite. Click on Start/Programs/Accessories to open the command prompt.

You need to enter cd Desktop to change into the installation directory. Now, enter the following command to start the installation:

physdiskwrite.exe -u askozia-pbx-myplatform.myversion.img
C:\Users\Documents and Settings\MyUsername\Desktop>
physdiskwrite.exe askozia-pbx-myplatform-myversion.img	

physdiskwrite v0.5.2 by Manuel Kasper <![CDATA[<mk@neon1.net>]]>

Searching for physical drives...

Information for \\.\PhysicalDrive0:
	Windows:       cyl: 19452
	               tpc: 255
	               spt: 63
	C/H/S:         16383/16/63
 	Model:         ST3160815AS
	Serial number: 9RX4H316
	Firmware rev.: 3.ADA

Information for \\.\PhysicalDrive1:
	Windows:       cyl: 31
	               tpc: 255
	               spt: 63

Which disk do you want to write? (0..1) x

You choose the target drive for the installation by entering its number. Replace the x in the example with the according drive number of the target drive. Make absolutely sure you have chosen the correct drive.

In this example PhysicalDrive0 is the hard disk of the system. PhysicalDrive1 is the target drive for the AskoziaPBX installation. Here we choose 1.

About to overwrite the contents of disk x with new data. Proceed? (y/n) y

Enter y to write the firmware to the disk. This might, depending on the hardware used, take some time. Once it has finished writing, you see something similar to this:

Found signed compressed image file
33554432/33554432 bytes written in total

The installation is finished and AskoziaPBX can now be used.


Starting up your telephone system

The storage medium on which you installed AskoziaPBX either needs to be build into the telephone system or plugged in the card slot and remain there permanently.

Connect your telephones to the PBX and connect it via its primary network ports to your network. This is necessary so your telephone system can get an IP address assigned which you need to know in order to get access to the web interface. The automatic assigning of the IP address is done by a DHCP server (Dynamic Host Configuration Protocol). Most routers have this functionality. Connect your PBX with a router, or a switch which is connected to a router in order to assign an IP address to your PBX.

Switch on your telephone system and boot it with the storage medium on which you installed AskoziaPBX.

The next step is to find out the IP address of your telephone system in order to log into the web interface of AskoziaPBX. Follow the instructions in the Getting Started with AskoziaPBX chapter to find Askozia's IP address, and to set it up and make your first call.

Personal tools
Namespaces

Variants
Actions
Navigation
Getting Started
AskoziaPBX
Call Flow Editor
UC Client
PRI
CTI
Tools