Deployment to VMWare Workstation Pro
To deploy the Phonexia Speech Platform 4 Virtual Appliance, you need these two
ZIP files, downloaded from Phonexia:
– Virtual Appliance ZIP file
– Licensed models ZIP file
Step 1: Import Virtual Appliance
- Extract the contents of the Speech Platform Virtual Appliance ZIP file
- In VMWare Workstation Pro, select File / Open... and open the
extracted
speech-platform.vmware.ovf
file - In the Import Virtual Machine dialog, type the name of the virtual appliance and select the location where the virtual appliance will be imported
- Click on the Import button and wait for the import to finish
After finishing the import, it is strongly recommended to open the virtual machine settings and check the following:
-
On the Hardware tab
- make sure that the Memory default size 32768 MB is below the Maximum recommended memory blue marker; if not, you need a computer with more RAM
- check that the number of Processors is at least 4
- set the Network Adapter to Bridged
-
On the Options tab
-
in the Advanced settings
- set the Disable side channel mitigtations for Hyper-V enabled hosts check box (this is applicable to a Windows host with "Windows Hypervisor Platform" feature installed)
-
Using the bridged networking has the advantage of assigning a separate IP address to the virtual appliance using your DHCP server, thus saving you from a hassle with additional port forwarding rules configuration.
Step 2: Run Virtual Appliance
After you have imported and configured the setting of the virtual appliance, you can finally start it.
The console displays the boot log with various messages as startup tasks are completed. This typically takes several minutes.
When the system is fully up and running, the console shows a screen similar to this:
Rocky Linux 9.5 (Blue Onyx)
Kernel 5.14.0-503.14.1.e19_5-x86_64 on an x86_64
Welcome to Phonexia Speech Platform 3.7.0
.
.
.
speech-platform login:
Step 3: Upload licensed models and configure the platform
The virtual appliance distribution contains only the bare Speech Platform system. To actually breathe life into the system it's necessary to upload the licensed models to the appliance and configure the technologies.
These steps can be done either semi-automatically via the platform GUI, or manually via SSH access to the platform console.
- GUI (preferred)
- Console
The Virtual Appliance contains a Filebrowser tool, which simplifies some
management tasks like uploading the models and accessing and editing the
appliance configuration files.
The Filebrowser is accessible at
http://<virtual appliance IP address>/filebrowser
.
Open the Filebrowser and click on the upload icon in the top right corner, then
click on the "File" option, browse for the licensed models ZIP file
(licensed-models.zip
). A small pop-up window in the bottom right corner will
show the upload progress. You can also click on the up arrow to show the
graphical progress bar.
When the upload is finished (progress is at 100 %), Filebrowser automatically starts extracting the uploaded ZIP file and then runs the automatic configuration script. While these processes are executed, the upload progress pop-up remains visible at 100%, seemingly doing nothing — don't worry, this indicates that background tasks are still running.
When the progress pop-up disappears, it means that the extraction and configuration is finished and the system is ready for use.
The automatic configuration detects which models and licenses were extracted from the ZIP file and automatically turns on the corresponding technologies and configures them to use the provided models.
Upload the licensed models to the appliance and configure the technologies from
the command line terminal using the following steps.
Use the default password InVoiceWeTrust
when asked.
- Upload the licensed models ZIP file from your host/client computer to the
virtual appliance via scp. (default SSH port is
22
when using bridged networking, or usually2222
when using NAT):scp -P <virtual-appliance-port> licensed-models.zip root@<virtual-appliance-ip>:/data/
- Connect to the virtual appliance via SSH and change directory to
/data
:ssh root@<virtual-appliance-ip> -p <virtual-appliance-port>
cd /data - Extract the licensed models ZIP file. The included directory structure
ensures that all files are extracted to their proper locations.
unzip licensed-models.zip
- Finally, run the automatic configuration script:
/root/scripts/configure-speech-platform.sh --auto-configure
The automatic configuration detects which models and licenses were extracted from the ZIP file and automatically turns on the corresponding technologies and configures them to use the provided models.
After the configuration script finishes, depending on the provided technologies and models it may take up to several minutes to load the new configuration.