Deployment Options

You can freely download the Application Suite from Imagicle web site. The creation of an account with a valid email address might be required.

There are two deployment options:

  1. Through Imagicle Virtual Appliance, which is easier and faster
  2. Downloading the setup package and installing it on a Windows server

Both the Virtual appliance and the Setup package include SQL Server Express edition, which is free and suitable for small and medum business deployments. To deploy using an external SQL server database, see below.

Deploying ApplicationSuite through Virtual Appliance

The Imagicle Virtual Appliance (VAI) is a fully functional and ready-to-go VMware OVA including both Windows Server 2016 Standard or Windows Server 2012 R2 Standard OS and Imagicle ApplicationSuite, together with MS-SQL Server 2017 Express Edition.

Windows OS runs in evaluation mode for 180 days. A suitable Windows Server license, not provided by Imagicle, must be bought and activated on the server within that time.

To setup the VAI, follow these steps:

All Imagicle applications run with full features for 30 days.

After the VAI deployment, you must go through the AppSuite common configuration steps, then configure the single applications, as described in the product configuration guides.

Imagicle OVA profiles

Note: preset profiles do not apply to a deployment within VMware Workstation.

AX Server

Details:

BX Server

Details:

CX Server

Details:

DX Server

Details:

Virtual Hardware Considerations

If you install Imagicle applications on a Virtual Machine, you must allocate the amount of RAM, CPU power and disk space stated in the section above. The virtual hardware resources (CPU and RAM) must be reserved, that is, they must not be shared with other virtual machines and CPU Limit must never be set (see image below).

No overprovisioning. Required HD provisioning is Thick Provisioned - Eager Zeroed.

Mass-deployment of multiple Imagicle instances

If you are a Service Provider or if you need to deploy multiple Imagicle nodes in your datacenter, we recommend to save the Imagicle instance as a template, to avoid downloading again the Virtual Appliance and without losing 30 days evaluation period.

Moreover, cloning or creating a template from a VM that has been already booted, brings to licensing problems for the newly created virtual machine. 

The template must be created at the end of deployment wizard, before booting up the server. In this way, you can easily deploy another Imagicle VM in few minutes and correctly assign it to a new IP address/FQDN.

Cloning an existing VM is newer allowed.

Deploying ApplicationSuite through the Setup Package

Download the latest package released for your telephony system from Imagicle web site, and run the installer.

Setup Wizard Details

This section describes the operations performed by the setup utility and the information you'll be asked.

Network installation is supported, meaning that you can execute the setup program from a network share.

When the package starts, you are prompted to choose a language. The language of the Setup user interface is always English. The language selection dictates default web portal language.

Prerequisites Verification and Installation

The operating system requirements and prerequisites verification is automatically executed before the main installation wizard starts. Compatibility with other Imagicle Products installed on the machine is also checked. Should a requirement fail, the setup package will try to install it automatically.

Warning: please reboot the server each time the setup asks you to do so!

License Agreement

You are required to accept the terms of the License Agreement to install the Application Suite. The main License Agreement for the package covers the entire IAS version being installed.

Information about Antiviral Software

If an antivirus is installed on the target machine, it must be disabled at least for the duration of the Application Suite installation. When the installation is finished, we recommend configuring the antivirus to exclude the folder where IAS has been installed to. More info are available here.

More over:

Backup Data

This page is displayed only when you are reinstalling over an existing IAS installation. Click the button to launch the Backup and Restore utility of the installed IAS version. If the Backup and Restore utility does not start, see the troubleshooting section below.

Select Destination Location

If you are installing the IAS for the first time on the target machine, you may select any folder you wish.

Note - The file system of the volume you are installing the IAS on must be NTFS. You cannot install the IAS on FAT file systems.

If you uninstalled the IAS from the target machine previously, you should install the IAS in the same folder where the previous package was installed.

Create Imagicle Web Administration Account

This page allows you to modify the default username and password that the Imagicle Application Suite administrator will use to log on to the IAS web interface. This page also allows you to recover from a lost username or password because it will overwrite existing credentials.

The IAS administrator is a super user which always has full permissions on all the applications, and is allowed to configure the system and create other users with limited or extended permissions. This user cannot be deleted.

If you choose to accept the default value, the administrator will be able to access the IAS using the following default credentials:

Username: admin

Password: admin

These credentials may be modified later from within the IAS web interface.

Choose between clean setup and upgrade

If you are making a fresh installation, select "start with a new configuration". If you are performing an upgrade or a migration, select the other option. In this case the Setup program will launch the Restore tool when appropriate, asking for the location of the backup files.

Begin installation

Review the information and press the "Install" button to start copying files and installing services.

Installing 2020.Spring.1 release or newer

Starting from Spring 2020 release, the installation package embeds MS-SQL Server 2017 Express Edition, including Full-Text Search Service. This optional SQL service (mandatory from Spring 2021 release and above) allows a much quicker contact search across multiple Speedy directories, even involving millions of contact, without having to wait several seconds to get a response. You can also decide to avoid the installation of this service at a later wizard stage, even if it's not recommended.

Installation package prompts you to proceed with SQL 2017 installation. If you are going to leverage an existing, external SQL Server instance, you can uncheck relevant installation. See below sample:

Post-copy installation steps

Once the application files are installed, additional configuration is required.

Local Area Code and Other Location Information

The following message is displayed when installing StoneFax.

Choose your country and your local area code. Press OK. twice to close the control panel windows. Setup will resume when you press ok.

Driver installation

The following alert is displayed when installing StoneFax. Press Yes / Install this Driver Anyway.

Database connection

When installing the ApplicationSuite for the first time, by default, the IAS setup package installs a Microsoft SQL Express 2017 instance on the machine, to store configuration and data. 

Here are the default settings for the local SQL server:

Accessing the database through Windows Authentication is supported, see this page for the required configurations to enable it.

Optionally, you can use a secure connection to an external, trusted, SQL Server.

You may test the connection by pressing the "Connection test" button.

On Imagicle 2020.Spring.1 release and above, when you press "Next", the installation package prompts you to confirm the installation of Full-Text Search SQL indexing service (mandatory from Spring 2021 release and above). See below screenshot:

This windows also appears if you have chosen another external SQL Server 2017 instance. If the alternative instance is from a different SQL version, then you are prompted to manually install Full-Text service by running relevant SQL Server setup.

When you hit "Next", the IAS database will be added or updated (if already existing).

Using an external SQL Server

As mentioned above, the Imagicle Application Suite can install a SQL Express 2017 instance to store configuration and data. However, you can leverage your own SQL Server instance, which can be installed on the same server or running on an external server.

In this case:

During the setup, in the setup DB wizard form, provide:

When you press "Next", the IAS database will be added or updated.

High availability notes

If leveraging an external SQL server, both the AlwaysOn Failover Cluster Instances and the AlwaysOn Availability Groups SQL server configurations are supported for high availability scopes.
If the AlwaysOn Availability Group configuration is used, a limitation applies to the restore mechanism: in such case, please, contact Imagicle to obtain the procedure needed to restore an Imagicle backup.

Server Restart

Restart may be required when installing StoneFax. After restart you will have to wait while virtual hardware (modem) is created. This step might take some minutes to complete. After that, if required by the setup program, reboot a second time.

Setup Imagicle Billing (Billy Blue's or Blue's Enterprise)

You'll be asked if you want to configure Billing call acquisition at the end of setup. You can safely skip this operation if you do not plan to evaluate or use that application. Blue's configuration wizard can be run later, if needed, from the start menu.

Evaluation grace period

When the IAS is installed for the first time on a server appliance, all the applications are available in evaluation mode and they will expire after 30 days, if not registered.



Article ID: 8
Last updated: 29 May, 2020
Revision: 38
Imagicle AppSuite Cross Platform -> AppSuite Deployment -> Deployment -> Deployment Options
https://kbp.imagicle.com/kb/entry/8/