From ProjectDiaStar

Contents 1 Manual Installation 2 Automated Installation - Introduction 3 Getting and Preparing the ISO file 4 Pre-Installation 5 Installing from the CD 6 Installing from a PXE Server 7 Post-Installation 8 Verifying the Installation 8.1 IP-Only Systems (No DNI Board) 8.2 Systems With a DNI Board 8.3 Test Client 9 Completing the DiaStar Server Configuration

Manual Installation

In some cases, DiaStar™ must be installed on an existing system, so it is possible to manually install all the components required to run a DiaStar server. The manual installation process begins here.

Automated Installation - Introduction

The quickest and easiest way to install a DiaStar server is by using the .ISO image which creates a standard DiaStar server "appliance". This is the recommended way of installing a DiaStar server and is covered in this guide.

Installation steps:

• Download a single .ISO file which contains CentOS and DiaStar server packages
• Burn the .ISO image onto a CD
• If a Dialogic® DNI board is being used, install it in the system
• Ensure the system is connected to yournetwork
• Boot a system from the DiaStar CD.
• Important!!! **** Please note the DiaStar installation will reformat the HDD of your system ****
• The CD will install the CentOS 5.45 operating system and everything needed for the DiaStar server
• Finish licensing and configuration

Getting and Preparing the ISO file

The .ISO file should be downloaded from the Project DiaStar™ Download page.

Once the download is complete, use a CD drive that has write capabilities, along with the appropriate CD burning software. Note that a bootable ISO image must be created from the downloaded file rather than simply copying the file to the CD.

DiaStar™ client software is also included in the ISO file. These will be found in the extras directory on the CD made from the ISO and may be used for installation on the client system when desired.

Pre-Installation

PSTN Systems Only:

If a system with PSTN connectivity is being built, the Dialogic® DNI board should now be installed in a full-length PCI or PCI express slot in the system.
If more than one board is being used in a system, make sure that all boards are connected together using a CTBus cable across the top end of the cards opposite the T1/E1 jacks.
Problems with network clocking or audio may occur if the cable is not installed.

General Notes and Warnings:

• The DiaStar Media Engine will not operate in a 32-bit system with more than 4GB of memory.
• DiaStar may encounter problems on a laptop system due to power management issues

Installing from the CD

Put the bootable CD in the drive on the system on which the installation will be done and boot the system from the CD.

** Important Note: This install will overwrite everything on the system's hard drive! **

At the boot prompt, simply hit "Enter". Do not use any other possible boot options or the automatic DiaStar™ Server installation will not take place.

The installation requires little interaction. The main task is setting up the IP characteristics for the system. Here are some guidelines for doing this:

• Edit eth0 disable IPv4 and enable IPv4 support. The interface used for DiaStar must be eth0. DHCP can be used, but a static IP address is better on a system acting as a server
• The system name defaults to "diastar", but may be changed
• Set Gateway and DNS server addresses if desired

Once this is done, the remainder of the installation is "hands off". Be sure to remove the installation CD when the final reboot is done.

Installing from a PXE Server

This procedure is only recommended for developers working with multiple versions of DiaStar from its nightly build. Most DiaStar users will only need to occasionally update their systems and should install using the bootable CD as describe above.

Post-Installation

• For post-OS installation configuration tasks, access the system either by the terminal used during installation or by secure shell (ssh) access.
  
• All post-installation work should be done as user "root".
  
• The default root password is "opendialogic". If you wish to change this, do so before proceeding.

Verifying the Installation

After the system has rebooted after the installation, there are several things that you may first do to check that the installation was successful:

• /usr/dialogic exists and has a number of subdirectories
• Anaconda, the CentOS system installer, creates its logs in the /root directory
• Dialogic system processes are running. A "ps ax | grep dialogic" done at the system prompt will show 11 dialogic processes up and running

To try out your DiaStar installation, a SIP video phone is needed. For a SIP phone that has been verified to work with DiaStar, check SIP Video Phones and DiaStar. Most conveniently, there is a Windows-based Kapanga SIP video phone download directly from the DiaStar download page.

IP-Only Systems (No DNI Board)

Once the installed system is rebooted, DiaStar is running and includes a license for a single port of non-transcoded multimedia via a SIP call. Here, "non-transcoded" means that the video codec and format used by your SIP video phone must match one of the video files played by DiaStar. Here are the supported video files and formats:

• H.263, CIF
• H.263, QCIF
• MPEG4, CIF
• MPEG4, QCIF
• H.264, CIF
• H.264, QCIF

With the verification license, an error may be seen in the DiaStar log if codec specified in in the file /etc/diastar/diastar.conf does not match the codec used by the SIP phone. By default the [woomera] entry in /etc/diastar/diastar.conf is set to h.264:

[woomera]
video_format = h.264

But it can be reset to h.263 or mp4v-es (MPEG4) if the SIP phone is requesting either codec. Note that most free SIP phones will only handle H.263.

Systems With a DNI Board

The pre-installed verification license mentioned above will only work on a system with no DNI board in it. If you have installed a DNI board, you must activate the license you have obtained for DiaStar that is tied to the board's serial number. If that license includes SIP/IP, you may then try the test client with a SIP call. If your system is only licensed for PSTN calls on the DNI board, you will not be able to run the verification test.

Test Client

A Woomera client, written in the Python scripting language, is included with the ISO distribution.
This allows a test of the DiaStar server after installation but before an Asterisk or other client is activated.

Start the Python test client as follows:

# python verification.py

or more simply

# verification.py

You should see the text 'Listener enabled' when it is ready.

The verification demo responds to two SIP usernames/extensions:

• 101 - the DiaStar verification demo. This will answer the call and offer a menu that allows the caller to test multimedia playback or multimedia recording
• 102 - a multi-media echo test

A SIP URL for dialing into the verification demo would look like this:

sip:101@192.168.100.100

Note that the verification license available on installation can only be used with the Python client. It will not work with Asterisk or FreeSWITCH clients. A free DiaStar trial license must be obtained for use with these clients.

Completing the DiaStar Server Configuration

Once you have verified the basic operation of the system with the Python client , the DiaStar Server may be fully configured. Full instructions for configuration and use are found here.