Voiceware
- Aaron Bailey
- Josh Roberson (Unlicensed)
Below is some basic info about Voiceware and setup. Page links to the left will provide more information about each section and feature of Voiceware.
Information on exporting Voiceware data for import to ConnectWare can now be found under the Voiceware Upgrade section below.
Current Version: 4.3.0.6
Release Date: 6/13/2024
New features: Added ability to change GUI password from command line.
Changes to CentOS in June 2024 might cause problems preforming a Voiceware upgrade. See the upgrade section below for more information.
General Info
Calling to emergency numbers is something that all Phonesuite systems must do. This must be tested during installation and any time trunks are changed.
A video covering both Kari's Law and the Ray Baum's Act can be found here: Voiceware Compliance with Kari's Law & Ray Baum's Act.
Kari's Law
This law requires that all PBX systems allow both 9-1-1 and 9-9-1-1 to be dialed from any phone. It also requires a notification of a “location likely to be staffed”, in a hotel this is likely the front desk.
Voiceware is preprogrammed with 911, 8911 and 9911 in the outbound routes.
Make sure to set the default outbound route trunk in the Settings page and test 911 before leaving the site.
Ray Baums Act
This act in part reads:
(Sec. 506) The FCC must conclude a proceeding to consider adopting rules to ensure that dispatchable location is conveyed with 9-1-1 calls, including calls from multi-line telephone systems, regardless of the technological platform used. "Dispatchable location" means the street address of the calling party and additional information necessary to adequately identify the location of the calling party.
See https://www.congress.gov/bill/115th-congress/house-bill/4986.
Phonesuite had decided that the term "Dispatchable location" means the exact room number, the most exact location we are capable of providing. This is done in Voiceware by adding an emergency CNAM to either the room or device. Note that devices might need this if they are remote devices not at the main building at the physical address.
There is a 60 character limit on dispatchable location, this is imposed by the carriers.
Emergency Alerts
When a phone makes a call to 911 an alert box is displayed on the Browser Console. This warning displays the room number, name, and call length. As seen below it will display the room name of non-guest rooms, such as the Lobby in this example.
In addition there is a red banner at the top of the Browser Console that will remain as long as the call is in progress and can not be dismissed.
SIP Trunk Setup
SIP trunks must always be setup with 99 channels. Even if the provider only allows 10 channels for example you still setup the Voiceware side for 99 channels. Doing this ensures that Voiceware will not block any calls to the SIP trunk provider and places the burden of routing calls on the SIP trunk provider. Most SIP trunk providers should route a 911 call even if it exceeds the channel limit for the account.
Ray Baum’s Act requires that the dispatchable location (i.e. room number or location of phone) be sent to the 911 dispatch center on all 911 calls made from PBX systems. To comply with this requirement without needing a DID for each guest room a new feature has been added to Voiceware. This feature allows the dispatchable location (i.e. Room 101) to be dynamically passed when an emergency call is made, thus eliminating the need for a unique DID for every guest room and admin station.
There are currently two providers supported by Voiceware for Enhanced Dynamic Location Routing (hereafter referred to as "DLR"), http://Bandwidth.com and http://Bulkvs.com . This document will walk you through the provisioning of DLR entries for each service and the required information within Voiceware.
Process & Feature Overview:
There are four components to the enhanced DLR feature of Voiceware 4.2. They are:
An account with an approved SIP trunk vendor capable of passing the dispatchable location dynamically. Note that a compatible provider need only be used for emergency calls. Thus an existing provider can continue to be used for all normal inbound and outbound calling.
Dispatchable location settings in the Settings page. These differ depending on what SIP trunk provider you are using.
Dispatchable location information for Devices and Rooms. Each room and device entry must have a dispatchable location added to it. This is a simple line of text (60 characters max) that describes where the phone is (i.e. Room 101, back office 204, etc). This information must be added to the system and should be approved by the phone system owner (i.e. the hotel GM).
Pool of emergency call back numbers. Part of the emergency call requirements is that the 911 operator must be able to call back a number and have it ring directly to the phone that dialed 911. To comply with this requirement a small pool of DIDs (5-10) should be purchased on the compatible SIP trunk provider, not the existing provider.
Below are the setup instructions starting with the two approved SIP trunk vendors, note you only need to use one vender. Next is the Voiceware setup instructions and testing process. Lastly is a list of approved abbreviations for use in the Dispatchable location field and a SIP trace of a successful call.
Bulkvs.com
This guide assumes you have an account already set up with Bulk Solutions, and have e911 enabled on the account. Setting up the account and enabling the e911 service is outside the scope of this document. It is also assumed that you have purchased DIDs for the emergency call back pool, this is also outside the scope of this document.
Log in to your portal account at bulkvs.com .
On the left-hand side, click on “E911”.
Select “Add Endpoint”.
On the Add Endpoint screen, Fill out the required information. The Telephone Number is the TN you are setting up for 911 (ex. 13035551212).
The Subscriber Name should be the Site Name (ex. Hill Valley Mariott).
The Street Address will be the actual street address of the property (ex. 123 Maple St NW)
Enter “ng911” without quotes into the “Suite/Floor/Other” Field.
Then enter the City, State, and Zip code of the property in the appropriate fields.
DO NOT ENTER ANYTHING IN THE SMS NOTIFY FIELD.
Click “Validate & Provision”. Wait for the system to give a result. Correct any errors if present and repeat this step. If there are none, repeat steps 3-5 for each TN the site has (i.e. each DID in the emergency call back pool).
Go to the “Voiceware Provisioning” section and begin there.
Bandwidth.com
This guide assumes that there already exists a DLR account set up with Bandwidth.com; setting up such an account with Bandwidth is outside the scope of this document. Bandwidth is by far the more complex option currently and if you need help getting a special DLR account you much reach out to Bandwidth directly, Phonesuite will not be able to offer any help with the Bandwidth account.
Log into the Bandwidth portal and select (if not the primary) the account activated for DLR.
Click on the “Emergency” link at the top of the page.
Click on “+ ADD” under the “GEOLOCATIONS” section.
Enter the information for the site, using the site code as the “Geolocation ID”. Leave Address Line 2 blank. This is the CIVIC address or base address for the site.
Click “ADD GEOLOCATION” and wait for it to save. Correct any errors if any are detected and repeat this step, otherwise go on.
Click “ENDPOINTS”.
Click “+ ADD” under the ENDPOINTS section.
The Endpoint ID will be the full TN including the 1. (ex. 13035551212)
The Caller Name should be the Site Name (ie, Hill Valley Mariott)
The Callback Number will be the TN minus the 1 (ex. 3035551212).
Click the “SEARCH GEOLOCATIONS” button, and type in the site code and click “SEARCH”.
Next to the Geolocation ID click “SELECT”.
Click “ADD ENDPOINT” and wait for it to save. Correct any errors if there are any, and repeat this step. Otherwise, repeat steps 7-13 for each TN the site has.
Once this step is completed, Make a note of the Account ID (it’s in brackets [] after the account name on the Overview section, and the Site Code. You will need these to provision Voiceware.
Go to the “Voiceware Provisioning” section and begin there.
Voiceware Provisioning
NOTE: you must finish the SIP provider section above before proceeding with the Voiceware setup.
Dispatchable location settings in the Settings page
Log into the Voiceware system as Installer (or another admin user).
In the “System” section, click on “Settings”
Scroll down to “Emergency Calling Settings”
Option 34: Select an extension to notify in the event of an emergency call. This will usually be the front desk or operator extension.
Option 35: Enter an Email address to send emergency notifications to. These emails will tell the recipient the number dialed, and the extension that dialed them, along with the date and time the call was placed. If you leave this field blank, no such emails will be generated.
Option 36: Ray Baum’s Act requires the ability to call back the emergency caller for an allotted time after a disconnect of the emergency call. By default, the TN selected by the system will be reserved for 60 minutes as a direct-dial number to reach the calling device. This can be adjusted as needed, but 60 minutes or greater is recommended.
Option 37:
For http://Bandwidth.com users, this will be the following:
Geolocation: <https://emergency.bandwidth.com/locations/{account_number}/{location_id}?loc={device_location}>
For Bulk Solutions (http://bulkvs.com ) users, this will be the following:
X-ng911: {device_location}
Option 38: BANDWIDTH ONLY: Enter your Bandwidth Account Number.
Option 39: BANDWIDTH ONLY: Enter the Site Code (or other Geolocation ID if site code not used (rare)).
Option 40: If you’re using Bandwidth, check the box for URLEncode. If you’re using Bulk Solutions, make sure the box is unchecked.
Click “Save all Changes” and wait for the page to refresh.
Dispatchable location information for Devices
Click on “Devices” at the top of the page.
Click on the name of the SIP device to add location data to.
In the “Dispatchable Location” Field, enter the pertinent location data. (ex. FLR 4 RM 410, for Floor 4 Room 410 – see appendix A for preferred abbreviations).
Click “Save”.
Repeat steps 11-15 for each SIP device that is not a trunk or proxy device.
Dispatchable location information for Rooms
Click “Rooms” at the top of the page.
Click on the Room Name to add location data to (location data on devices assigned to rooms is ignored in favor of the room entry.)
In the “Dispatchable Location” Field, enter the pertinent location data. (ex. FLR 4 RM 410 for Floor 4 Room 410 – see appendix A for preferred abbreviations).
Click “Save”.
Repeat steps 17-19 for each room you need to add location data to.
Note: Dispatchable location data can be added in a CSV bulk room upload. See the Rooms page help page for more information.
Pool of emergency call back numbers
Click “Dial Plan”
For any TN such as the main number or reservations number, you will want to block the 911 system from re-routing that TN when an emergency call is placed:
Click the TN (DID) you wish to block from the 911 system
Check the box labeled “Block Emergency Use”
Click “Save”.
If you purchased pool DIDs for emergency use (should have 5 at a minimum) you will add these to an emergency pool. Click “DID Pooling” in the “Extensions” section on the left side of the screen.
Click “Add Pool”
Name will be an identifier such as “Emergency TNs” or “DLR Numbers” or something to identify this pool of TNs.
Check the box “Emergency Callback Pool”
Select a Destination for the pool. This destination is where incoming calls to these TNs will ring when they are not being used for emergency purposes. Usually, the front desk or an IVR that plays a “not in service” message.
Click “Save”
Click “Dial Plan”
Click “Add Extension”
Select a number that would not be easily dialed by accident, such as **5959.
Extension Type should be “DID Pool”
You can add the first DID to the pool by adding it with the DID assign/add selection if you wish. Otherwise leave it as “None”.
Destination will be the pool you just created in step 24 above.
Click “Add.
If you have not yet added the emergency use TNs to the system:
Click “Add Extension”
Enter the TN as the Number/Pattern
Extension Type will be “DID”
Destination will be the pool you just created in step 24 above.
Click “Save”
Repeat this process for each TN you need to add.
If you already have the emergency use TNs added to the system, but not pointed at the pool:
Click on the TN to assign to the pool.
In the “Edit Extension” page, change the Destination to the pool you just created.
Click “Save”
Repeat this process for each TN you need to reassign.
Testing
You are now ready to place a test call from one of the configured devices. Make sure you have your routes set up properly (including a route for 933 as an emergency route) and trunk devices for the appropriate carrier set up. Dial 933 from a device on the system and you should hear back both the number the system selected for callback (one of the emergency use TNs) along with the address and location specific details.
Note on how TNs are selected:
First, the system will utilize a TN assigned to the user/room/guest/etc. who made the call, if available. If not, the system will check for a previously used TN in the expiry period for the device making the call and re-use that TN. If a TN is still not found, the system will then choose a TN from any DID pool(s) marked for emergency use. If there are none available (already used and within timeout period or none defined) the system will choose a TN from the system that isn’t marked with the “Block Emergency Use” flag. The TN that is chosen in any instance will be directly linked with the device making the emergency call for the expiry period and not usable by anyone else on the system until the expiry period is over. This is to ensure a direct call-back from the emergency call taker.
2023 Case
This case includes a better CPU (i3-6100), more RAM (32GB) and a faster MSATA SSD (512GB).
2019-2023
Phonesuite will ship a newer 1U rack mount server case with all 4.1 orders where an expansion card is not required. These new cases are silver and have two USB 3.0 ports on the front that do not work (our current board does not have headers for them). This case does include two lights on the front showing the status of NIC 1 (LAN) and 2 (Series2 Span).
Voiceware training is hosted online at Phonesuite Training. Email Sales@Phonesuite.com to request access to the training.
This sheet is intended to aid installers when gathering information from the hotel. This is not intended to be a full and complete list, just the most commonly needed information.
Below is a basic set of questions and pieces of information you need to have on hand before you attempt to configure and connect a PMS interface to Voiceware.
Voiceware Upgrade
Voiceware can be installed on just about any hardware using a bootable USB key. An existing system (either SBC card or stand-alone 1U rack mount server) can also be “rekeyed” using this process. Note that this process DESTROYS all the data on the system.
Download Rufus from: Rufus - Create bootable USB drives the easy way
Download the current Voiceware ISO from:
Insert a BLANK USB key (min 2GB) into your system
Launch the Rufus tool
In the Device dropdown select the USB key
In the Boot section click the Select button and choose the Voiceware ISO downloaded above
Set Partition Scheme to MBR
Set the Target System to “BIOS or (UEFI-CSM)” (might be listed as “BIOS or UEFI”)
Click START
10. If asked what method to use, select DD and press OK
When finished the USB key can now be inserted into any system and when that system is rebooted it will begin loading from the USB key. Note that during boot up F7 or F10 might need to be pressed to select to boot from the USB key. If the system will not boot from the USB key adjustments to the BISO might need to be made, please contact Phonesuite for assistance in doing this. At this point begin at step 1 in the Voiceware 4.2 Installation section below.
This method assumes a live in the field system is being upgraded from a previous version of Voiceware (i.e. 1.X, 2.X, or 3.X) to version 4. Note that a system already on version 4 can simply be upgraded without the need for a complete reinstallation as outlined below.
Prepare: For this type of upgrade, you will need
A temporary 1U rack mount system loaded with the latest 4.2 installation
Contact Phonesuite for a temporary server if needed
A bootable USB key (see the section “Using a bootable USB key to install on physical hardware” page 3 for how to create a bootable USB key)
Two 10-15ft network cables
Long power cord or extension cord (depending on phone room power availability)
A laptop
A screen and USB keyboard.
Check the existing system for duplicate outbound routes, outbound rates, and extensions. Older versions of Voiceware allowed duplicates however a backup containing duplicates will not load into a 4.2 system.
At a high level the process here is to use the temporary server to run the hotel while the physical hardware is upgraded. Once done the hotel is put back on the existing hardware running Voiceware 4.2. This method minimizes downtime and allows the hotel to continue running on the temporary should there be a hardware failure during the upgrade process.
In office prep work (optional but recommended)
Before traveling to the customers site the below prep work should be completed, this will minimize onsite downtime.
Verify the system is licensed. Contact Phonesuite support to obtain a new license for the temp system as needed.
Verify the temp system is running the latest version of Voiceware.
Upload the customers database to ensure it will be successful and know how long it will take
WARNING: take care with registered SIP trunks. If the trunks register to the system in your office calls to the hotel might start ringing the temp PBX and not the hotel. To avoid this block port 5060 in the router.
Rebuild the Series2 span as needed.
Ensure the license URL in the settings page is http://license.voiceware.com/licenses/
Onsite work
Connect a computer to the hotels network and log into the existing system via the web GUI
Navigate to the backups page and take a manual backup
Download the backup to your laptop (if you already restored the backup to the temp system in the office steps 2-3 can be omitted)
Place the temporary server in a secure location that is easy to access. Note that this can simply be on a table. The temporary system does not need to be fully rack mounted.
Power the system on
Attach a screen and keyboard to the temporary system.
Login and issue the command “ip addr” to find the systems IP address
8. Log into the temporary systems web GUI at the IP found in step 7 above
9. Restore the backup from the existing system to the temporary system (if a backup was already restored at the office and a new restore is not needed this step can be omitted)
a. Note: this process might take some time depending on the size of the backup
10. Click “Restart Now” on the yellow banner that appears after the backup is done restoring
Rebuild spans as needed as they are not restored in the backup process
Navigate to Devices --> Hardware Spans
Click Add Span
Check Dynamic
Select the adaptor “enp1s0” from the drop down (note, your adaptor name could differ)
Enter “003018a4c908” as the remote MAC address
Set the Timing to “1”
Set Signaling method to “PhoneSuite Cabinet”
Click Save Span
Scroll down and click Save Span again
If adding more than one span repeat the above process incrementing the remote MAC address by one for each additional span (i.e. 09, 0a, etc.).
Click “RESTART NOW” from the Hardware Spans page, this process should take less than 5 minutes.
The order of the next few steps is important, follow exactly
Set the temporary systems IP to exactly match the existing systems IP address
Click save
Disconnect the existing system from the network
Click the link that says “Click here to restart the system…” on the temporary system
Connect any existing Series2 cabinets to the temporary server using new patch cables
After the system reboots check general phone system functionality as the hotel should now be running on the new hardware.
Note as an alternative a separate network using a temp router can also be created and the system set with the same IP as the existing system. Doing this requires the use of an onsite router and moving the network the laptop is connected to but makes the swap over as simple as moving the network cable from the existing system to the new system without needing to set IPs and rebooting the system.
The next set of steps installs Voiceware 4.2 on the existing hardware while the temporary system keeps the hotel running. This process should take 15-30 minutes depending on network connection speed.
Note also that the system must have an internet connection to complete the installation. Plug the system back into the network only after the reimage process starts.
Place the bootable USB key into a USB port of on the existing hardware (any USB port is fine)
Attach a screen and USB keyboard
Reboot the system
Note a reboot can be done using the very small black power button near the top card tab, or by unplugging the cabinet, or even by using the screen and keyboard to log into the command line and issuing the command “sudo reboot”
During the boot process a BIOS screen will appear, there is often (but not always) a prompt allowing a key (normally but not always F10) to be pressed to enter the boot menu. Press this key and select the USB drive to boot from.
Note in some cases the system will automatically boot from the USB key and in others the BIOS must be entered (by pressing F2 during boot) to select the USB boot drive manually
Reattach the network cable only after the USB boot process is underway.
At this point the system should begin booting from the USB key. Follow the 4.2 installation steps outlined in the section Voiceware 4.2 installation below but stop at step 8 and return to this section.
Log into the existing hardware using the IP found in step 8 of the 4.2 installation steps above
Navigate to the backups page and upload the backup taken from the existing system previously (in step 6 above)
Restore the backup and click “Restart Now” on the resulting yellow banner
Ensure the license URL in the settings page is http://license.voiceware.com/licenses/
Rebuild spans as needed as they are not restored in the backup process
Navigate to Devices --> Hardware Spans
Click Add Span
Check Dynamic
Select the adaptor “enp1s0” from the drop down (note, your adaptor name could differ)
Enter “003018a4c908” as the remote MAC address
Set the Timing to “1”
Set Signaling method to “PhoneSuite Cabinet”
Click Save Span
Scroll down and click Save Span again
Note: if adding more than one span repeat the above process incrementing the remote MAC address by one for each additional span (i.e. 09, 0a, etc.)
Click “RESTART NOW” from the Hardware Spans page, this process should take less than 5 minutes.
The order of the next few steps is important, follow exactly
Set the existing systems IP to exactly match the temporary systems IP address
Click save
Disconnect the temporary system from the network
Click the link that says “Click here to restart the system…”
Reconnect all Series2 cabinets and network cables back to the original system
After the reboot conduct a full system test
Remove the temporary server and all extra cables
Replace the Series2 cabinet door, pickup tools, and secure the phone room
This method describes upgrading an existing Series2 or 1U rack mount Voiceware system by swapping out the systems hard drive to one with 4.2 preloaded. This method requires the physical removal of the hard drive in a static safe environment. The utmost care should be taken if using this method because there is no temporary hardware available should the equipment be damaged during the swap.
Prepare: for this method you will need
A hard drive that has had Voiceware 4.2 installed on it
A replacement hard drive can be purchased from Phonesuite
Phillips screwdriver
A static free work environment
We recommend a grounded static mat and wrist strap
Screen and USB Keyboard
Check the existing system for duplicate outbound routes, outbound rates, and extensions. Older versions of Voiceware allowed duplicates however a backup containing duplicates will not load into a 4.2 system.
Hard Drive Replacement on the Series2
Log into the existing system and navigate to the backups page, create a new manual backup and download it to your laptop
Power down the Voiceware server using the small black button near the top card tab
If no black button can be found (it does not exist on all hardware versions) use a screen and keyboard to log into the command line and issue the command “sudo poweroff”
Wait a full three minutes
Remove the SBC card
The hard drive is located under the mini ITX mother board as seen in the picture below.
Remove both the power and data cables from the drive
The power cable simple pulls out, while the data cable has a small tab that must be pressed down before the cable can be pulled out.
Turn the board over and remove the four screws holding the hard drive to the SBC board
Carefully remove the now free hard drive
Move the posts from the old drive to the new drive
Carefully hold the new drive in place with one hand while putting in the screws with the other
Reattach the data and power cables
Reinstall the SBC card in the Series2
Reconnect all cables, power cord last
Attach a screen and keyboard
Login and issue the command “ip addr” to find the systems IP address (contact support for passwords as needed)
Navigate to this IP address and log into the system
Navigate to the backups page and upload the backup taken in step 1 above
Restore the backup and click “Restart Now” on the resulting yellow banner
Ensure the license URL in the settings page is http://license.voiceware.com/licenses/
Rebuild spans as needed as they are not restored in the backup process
Navigate to Devices --> Hardware Spans
Click Add Span
Check Dynamic
Select the adaptor “enp1s0” from the drop down (note, your adaptor name could differ)
Enter “003018a4c908” as the remote MAC address
Set the Timing to “1”
Set Signaling method to “PhoneSuite Cabinet”
Click Save Span
Scroll down and click Save Span again
Note: if adding more than one span repeat the above process incrementing the remote MAC address by one for each additional span (i.e. 09, 0a, etc.
Click “RESTART NOW” from the Hardware Spans page, this process should take less than 5 minutes.
After the reboot conduct a full system test
Replace the Series2 cabinet door, pickup tools, and secure the phone room
If the power button connector becomes removed during the swap process below is a picture of where the cable connects to.
Hard Drive Replacement on 1U Rack Mount System
Log into the existing system and navigate to the backups page, create a new manual backup and download it to your laptop
Power down the system using the power button on the front of the system
Note: press the power button only once and wait 30 seconds for the system to fully power down and the green lights to turn off
Label and remove all cables from the system
Remove the system from the rack
Open the case
Note: depending on hardware the screws for the lid are either on the back of the system or on the sides
Locate and unplug the data and power cables from the hard drive
Remove the hard drive from the system
Move the posts (if present) from the existing hard drive to the new drive
Replace the drive and reattach the power and data cables
Replace the lid and screws
Place the system back into the rack and connect all cables, leaving the power cable for last
Connect a screen and keyboard to the system
Power on the system if it did not power itself on when power was attached
Login and issue the command “ip addr” to find the systems IP address (contact support as needed for the password)
Navigate to this IP address and log into the system
Navigate to the backups page and upload the backup taken in step 1 above
Restore the backup and click “Restart Now” on the resulting yellow banner
Ensure the license URL in the settings page is http://license.voiceware.com/licenses/
Rebuild spans as needed as they are not restored in the backup process
Navigate to Devices --> Hardware Spans
Click Add Span
Check Dynamic
Select the adaptor “enp1s0” from the drop down (note, your adaptor name could differ)
Enter “003018a4c908” as the remote MAC address
Set the Timing to “1”
Set Signaling method to “PhoneSuite Cabinet”
Click Save Span
Scroll down and click Save Span again
If adding more than one span repeat the above process incrementing the remote MAC address by one for each additional span (i.e. 09, 0a, etc.
Click “RESTART NOW” from the Hardware Spans page, should take less than 5 minutes.
After the reboot conduct a full system test
Pickup tools, and secure the phone room
Checklist
Check existing system to ensure not duplicate outbound routes are found
Create system backup, download to local storage
Power off the equipment, WAIT 3 minutes before removing cards
Disconnect cables from hard drive
Remove existing hard drive
Attach new hard drive
Reattach power and data cables
Reinstall SBC card
Attach screen and keyboard
Power up and find system IP
Log into the GUI and restore the backup
Ensure the license URL in the settings page is http://license.voiceware.com/licenses/
Rebuild the spans
Full system test
Remove extra equipment and tools
Notify hotel staff that upgrade is complete
If prompted select “Install Voiceware” and press enter. Note this prompt will appear on some installation types and not on others.
At the prompt asking about warning over any data already on the disk select “Yes”.
The system will load the OS, a process that takes about 5 minutes.
Remove the bootable USB key while system is rebooting.
When finished the system will reboot and load a new prompt. The default choice “Voiceware [OEM]” is fine, after a moment the system will boot and present a login screen. Note, it will say Voiceware 4.1 Install, this is okay.
Login using the username “phonesuite” and password “a***********10”.
Issue the commands “sudo -i” and then enter the password again. Next issue the command “voiceware install”.
The system will then install Voiceware, a process taking about 35 minutes.
License & Software Assurance: The system must have a valid license and software assurance active to install. If no license is found (as will be the case with new hardware) the installation process will halt and present the system ID. Contact Phonesuite with the system ID to receive a license and then restart the upgrade process by issuing the command “voiceware install”.
Note that a new percentage indicator has been added to the last section of the download. Also note that at this point if the download is interrupted (system is powered off, loss of internet connection) the system will retain files already downloaded and not download them again. However, the progress percentage always starts at 0%, even on a resumed installation.
When the install process finished the system will reboot. Please note that after the initial installation the system may take up to 3 minutes to fully boot up.
Log into the CLI again and type “ip addr” to receive the IP address, this can then be used to login to the browser or configuration from a web browser.
You will be required to change the CLI password at this point (not pictured).
During the initial boot the screen may display text or messages, this is normal. Simply press enter to display the command prompt again.
Log into the configurator using the username “admin” and the password “phonesuite”.
Navigate to the backups page. From here either upload the Hosted Default Backup downloaded in step 10 above or select the pre-loaded system default backup if the system has two NIC ports available.
Click Restore and then Yes. When the process finishes click Restart Now in the yellow banner and yes again.
Once the system reboots login to the configurator using the default login “installer” and password “Protect6607”
Download and install VMware workstation 16 from Fusion and Workstation | VMware .
Download the Voiceware 4.1 ISO from https://registry.voiceware.com/voiceware/4.1/Voiceware.x86_64-current.install.iso
Select “Create a New Virtual Machine”
Select Install disk image file (iso) and select the downloaded ISO from the local file structure and click Next.
Select Centos 8 as the OS and click Next.
Name the system and click Next.
Set the disk size to 120 GB and click Next
At the Summary screen click Finish.
Select the newly created VMware machine and click Edit virtual machine settings from the right-hand menu.
Select Network Adapter from the left-hand side pick list, then select Bridged network connection. Then click OK.
Select the newly created VMware machine and click “Play virtual machine” from the right-hand menu.
Finished with the VMWare installation. Begin installing Voiceware with step 1 in the Voiceware 4.2 installation process above.
Using an export tool data can be pulled from a Voiceware system in the format required to import directly into ConnectWare. This is available for Users and Phone Hardware (the only two imports available in ConnectWare). In addition other exports are created with general info on DIDs, call groups, queues, IVRs and others. While these export CSV files can’t be imported to ConnectWare they are useful as guides to rebuild the system.
Note that just because a phone works in Voiceware does not automatically mean its supported in ConnectWare. Recall that all phones in ConnectWare are auto provisioned and you should always check that ConnectWare supports the phones before starting this process.
Method 1
On Voiceware 4.3.0.5 systems:
Log into the Command Line
Issue the command
voiceware exportOpen a new tab and enter the URL https://<ip>/exports/<file> (i.e. https://1.2.3.4/exports/users.csv)
Download each file using this method. A list of available files will be displayed when issueing the command but is also listed below.
Method 2
On any system prior to 4.3.0.5, or any version 3 system follow the below process.
Log into the Command Line
Issue the commands
sudo -icurl -kO https://get.voiceware.com/voiceware/utilities/vwexportchmod +x vwexport./vwexport
Open a new tab and enter the URL https://<ip>/exports/<file> (i.e. https://1.2.3.4/exports/users.csv)
Download each file using this method. A list of available files will be displayed when issueing the command but is also listed below.
If the above scrip runs but the files are not downloadable using the above URL then do the following.
cd /var/www/phonesuite/exports/
cp *.csv /var/lib/tftpboot/
You should then be able to download the files using the URL https://1.2.3.4/p/users.csv
Avaiable Files
users.csv (can be direcly imported)
phones.csv (can be direcly imported)
dids.csv
rooms.csv
common_area.csv
ivrs.csv
groups.csv
conferences.csv
Upgrade Series2 to Standalone Server
In some cases upgrading a Serie2 requires the use of an external server in a 1U rack mount case. Below are the changes and considerations that need to be made.