Acano X Series & VM 1.7 Release Notes

Acano solution
Acano Server & VM Release 1.7.0
Release Notes
May 2015
76-1005-19-K
Contents
Contents
1
Introduction ....................................................................................................................... 3
2
New Features/Changes in R1.7......................................................................................... 4
2.1 Calling into scheduled Lync meetings directly and via IVR ....................................... 4
2.2 Changes to screen layouts on SIP endpoints ........................................................... 5
2.3 H.323 Gateway ........................................................................................................ 6
2.4 Miscellaneous Improvements ................................................................................... 6
2.5 Summary of API Additions & Changes ..................................................................... 7
2.5.1 Improvements to diagnostics handling via the API ......................................... 7
2.5.2 Handling multiple coSpace access methods .................................................. 7
2.5.3 Security improvements in accessing coSpaces .............................................. 8
2.5.4 Additional changes......................................................................................... 8
3
Notes on Installing and Upgrading to R1.7 ...................................................................... 10
3.1 R1.7 Deployments.................................................................................................. 10
3.1.1 Deployments using a single host server ....................................................... 10
3.1.2 Deployments using a single split server hosted on a Core server and
an Edge server ............................................................................................. 10
3.1.3 Deployments for scalability and resilience .................................................... 10
3.2 Upgrading to Release R1.7 .................................................................................... 11
3.3 Downgrading .......................................................................................................... 12
4
Resolved Issues .............................................................................................................. 13
Resolved in R1.7.0 (same build as previously labelled RC1) ................................. 13
5
Known Limitations ........................................................................................................... 15
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 2
Introduction
1 Introduction
This release note describes the new features, improvements and changes in Release 1.7.0 of
the Acano solution software for both Acano Server and virtualized deployments. It assumes that
you have already upgraded to R1.6.19 or later. If you have not, and are upgrading from 1.2.x,
then read the 1.6 release notes first and follow the instructions, before following any instructions
in this R1.7 release note.
Before upgrading to R1.7, you are advised to take a configuration backup using the backup
snapshot <filename> command and save the backup safely on a different device. See the
MMP Command Reference document for full details.
Note: XMPP server clustering was a beta feature in release 1.6. If you have this feature enabled
contact Acano Support before upgrading to release 1.7.
A revised version of XMPP server clustering will be available in a future release, but the
configuration will be different from the 1.6 beta version. Until this feature is ready, only enable
one XMPP server per domain in your Acano solution.
Note: if you decide to revert to R1.6 after upgrading to R1.7, any self-signed certificates created
on R1.7 cannot be used on a R1.6.12 or earlier build. You will need to recreate the certificates
on R1.6.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 3
New Features/Changes in R1.7
2 New Features/Changes in R1.7
2.1 Calling into scheduled Lync meetings directly and via IVR
Pre-requisite on Lync deployment: This feature requires a working Lync deployment with
telephone dial-in capabilities already enabled.
Release 1.7 supports calling into a scheduled Lync meeting from WebRTC, SIP or Acano
clients, using the Lync call ID to join the call.
This feature requires one or more Lync Front End servers to be configured. You can configure
one via the Web Admin interface under the Lync Edge settings from Configuration > General,
and one or more via the API (create them as TURN servers with type "lyncEdge"). Refer to the
Acano Solution deployment guide in the section entitled “Configuration for Lync Edge” for
instructions on how to do this. If there are multiple FE servers in a Pool, use the Pool FQDN as
the Server Address.
Table 1 Configuration tasks to enable calling into scheduled Lync meetings
Task
On the Web Admin interface
Via the API
To configure the Call
Bridge IVR(s) to allow
entry of Lync conference
IDs
If you have set up an IVR via the
Web Admin:
If you have set up
IVRs through the API:
Go to Configuration > General
and set "Joining scheduled Lync
conferences by ID" in the IVR
section to "allowed"
Set resolveLync
ConferenceIds to
true for the
configured IVR
To allow direct dialing to
Lync conference IDs
from standard SIP
systems
Go to Configuration > Incoming
calls, and for one or more
configured call matching domains,
set "Targets Lync" to "yes.
Set resolveToLync
Conferences to
true on the
incoming dial plan
rule
If you have set up the Web Bridge
via the Web Admin
If you have set up
Web Bridges through
the API:
Note: you may choose to
extend an existing
configured domain to
allow Lync conference
access, or to create a
new one for this purpose.
To allow Lync
conference ID entry via
the Web Bridge call join
interface
Go to Configuration > General
and ensure that "Joining
scheduled Lync conferences by
ID" in the "Web bridge settings"
section is set to "allowed"
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Set resolveLync
ConferenceIds to
true on the Web
Bridge
Page 4
New Features/Changes in R1.7
If a call is being matched against Lync conference IDs, the Call Bridge first checks that the call
ID does not apply to a coSpace, if it does not then the Call Bridge identifies a Lync Front End
server that it has been configured with, that has advertised itself as having the capability to
resolve IDs. The Call Bridge queries the Lync Front End server to determine whether the call ID
in question corresponds to a Lync conference - if it does, the look up is deemed to have been
successful and the call is joined to the Lync call. If the call ID is not recognized as corresponding
to a Lync conference then no further Lync Front End servers will be queried.
Note: you may get unexpected results if you add the settings of multiple Lync Front End servers
that are in different Lync deployments. For instance, if multiple Lync conferences in different
Lync deployments use the same call ID, then more than one Lync Front End server may
respond positively to the lookup, in which case the "first" successful Lync resolution is used.
The text in the invitations sent for scheduled Lync meetings can be customized to include the
necessary details to allow users to join via Acano. These details should be placed in the custom
footer section. For example ‘For SIP/H.323 endpoints, join by calling [email protected] and
entering the conference ID above. For WebRTC go to join.example.com and enter the
conference ID above.’ The URIs in this must match those configured above. Please see the
Microsoft documentation https://technet.microsoft.com/en-us/library/gg398638.aspx for more
details.”
2.2 Changes to screen layouts on SIP endpoints
Release 1.7 introduces new screen layouts on SIP endpoints. These layouts aim to improve the
user experience and focus on the activity within the call, rather than the legacy MCU style of
layouts.
The changes include:

refining who is shown in the “all equal” layouts based on recent active speakers

participants will be shown in "big panes" when they become the active speaker

recent active speakers will be shown in big panes, with other participants shown in a
"dock" of smaller Picture in Picture (PiP) at the base of the screen

people will move out of the "active speaker list" (and thus be "demoted" to the PiP bar)
after a period of inactivity (not speaking)

for "all equal", stacked and overlay, if there is only one other video stream to be shown then
it will be shown full screen, "point to point" mode.

in “speaker large” mode (stacked or overlay) the PIP behavior has been simplified, only
showing up to 6 PiPs below the main speaker, even if there are more than 7 other callers in
the meeting.

other minor changes include:

using a grey background instead of black when the whole screen isn't filled with video
panes

introducing gaps between groups of the same-sized panes (rather than bordered
abutting panes)
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 5
New Features/Changes in R1.7

minor changes to the rendering of on-screen pane labels (e.g. a lighter background
colour on the pane names)
In addition, classic arrangements of 2x2, 3x3, 4x4 or 5x5 are available as layouts through the
API, but rather than being fixed pane arrangements, they are adapted to the number of streams
to show. For example, if you are using the 2x2 layout and have 3 people to show, you will get a
row of 2 panes (half-pane offsetted) above a row of 1, but the panes will be 1/4 screen size. See
parameter: defaultLayout, in section Call Leg Methods in the Acano Solution 1.7 API
Reference Guide.
2.3 H.323 Gateway
The Acano H.323 Gateway enables an H.323 call to connect to the Acano Call Bridge. The
H.323 Gateway does not provide firewall traversal or call control, you are recommended to
deploy a H.323 Gatekeeper to perform these functions. Refer to the H.323 Gateway deployment
guide for more information.
With the H.323 Gateway enabled, you can now make the following calls:

H.323 call > H.323 GW > coSpace

H.323 call > H.323 GW > Call Bridge->Lync

H.323 call > H.323 GW > Call Bridge->SIP device

H.323 call > H.323 GW > Call Bridge->Acano client
The H323 Gateway can be enabled on the same server as the Call Bridge or on a separate one.
Note: by default the H.323 Gateway uses port 6061.
2.4 Miscellaneous Improvements
Release 1.7 supports the following new features:

Active speaker indication shown by a blue line below the speaker’s pane

On-screen participant count provided on SIP endpoints, showing the total number of people
in the call once they are no longer all shown on the screen

Improved security options for guest and user access on Web Bridge, see section 2.5.3

Ability to disable support for Lync presence through the Web Admin interface
(Configuration>Call settings>SIP settings>Lync presence support).

Ability to control whether a user will be allowed to send and receive messages when in a
point to point call with another user

Improved filtering of event logs through Web Admin interface. You can now filter for: ‘show
all messages’, ‘show errors and warnings’ or ‘show only errors’.

Improved TIP support

Allowing “cascading” of Lync and Acano conferences

Improvements to CDRs for distributed non-coSpace calls
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 6
New Features/Changes in R1.7

Overlay screen layout: PiPs now only partially cover bottom of large pane, previously they
completely covered the bottom of the large pane.

support for new look and feel, and additional features in Acano Client v1.6

separate presentation stream - i.e. allowing clients to receive main and presentation
video as separate streams

clients informed of "last used time" for configured slave SIP endpoints with the list
presented in "most recently used" order

more per-participant indications (video muted etc.)
2.5 Summary of API Additions & Changes
2.5.1 Improvements to diagnostics handling via the API
Diagnostic improvements include:

allowing access to call diagnostics via the API (POST to initiate new diagnostics, GET and
DELETE to manage diagnostics)

automatically generating call diagnostics on remote call bridge peers for distributed calls
We now allow generating diagnostics to be triggered via the API on a per-coSpace basis (you
supply the ID of an active coSpace), or by specifying the ID of an active call (the call may or may
not be made within a coSpace). Whether the diagnostics are triggered via this new mechanism
or from a client, other call bridges that are hosting a distributed instance of the same call should
generate their own diagnostics at that point. All such linked diagnostics should end up with the
same GUID on each call bridge, and you are also able to filter the diagnostics (when
enumerating via the API) by coSpace ID.
New profile objects:

/calls/<call id>/diagnostics

/coSpaces/<coSpace id>/diagnostics

/system/diagnostics

/system/diagnostics/<diagnostics id>

/system/diagnostics/<diagnostics id>/contents
2.5.2 Handling multiple coSpace access methods
In Release 1.7, an administrator can decide which access details are shown in invitations
generated by clients. Using the API, specify the “scope” parameter of accessMethod as either
“public” or “private”. Those marked as “public” will be communicated to clients when retrieving
the information to show in invitations. If “scope” is left unset for an accessMethod, by default it
is equivalent to “private”.
If a coSpace has one access method with “scope” set to public, the client will be advised of that
access method's URI / call ID / passcode / weblink rather than the corresponding coSpace-level
values. Currently, if a coSpace has multiple access methods set to public, the Call Bridge will
pick one to send to the client.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 7
New Features/Changes in R1.7
Note: coSpace members are not permitted to edit the URI (etc.) of a coSpace that has any
public access methods.
2.5.3 Security improvements in accessing coSpaces
To prevent someone guessing the call ID of a coSpace and gaining access, security
improvements have been implemented on the Call Bridge and Web Bridge.

An optional additional parameter “secret” has been added to accessMethod to associate a
"secret" passcode per-coSpace or per-access method. This secret is included in the link in
the invite text and allows direct connection to the coSpace. The complexity of the secret
prevents brute force attacks.
Note: The optional parameter “secret” will be automatically generated if it is not specified.

Ability to disable access via the web link, manual entry of call details or user login on the
Web Bridge.

Additional modes to control manual entry of coSpace details. It is now possible to configure
a coSpace so that guests must supply the call ID and passcode at the same time, rather
than the call ID first, and if it's found to be valid, then supplying the passcode. This prevents
brute force attack on call IDs followed by an attack on passcodes.
2.5.4 Additional changes


Additional parameters for the following methods:

Call methods

callLegProfile methods

coSpace methods

coSpace accessMethods

inboundDialPlanRule methods

IVR methods

Web Bridge methods

User Profile methods
New failure reason


duplicateCoSpaceSecret
New options in defaultLayout parameter

allEqualQuarters

allEqualNinths

allEqualSixteenths

allEqualTwentyFifths
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 8
New Features/Changes in R1.7
Refer to the Acano Solution 1.7 API Reference Guide for further information. Additions to the
guide for R1.7 are shown in red for easy reference.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 9
Notes on Installing and Upgrading to R1.7
3 Notes on Installing and Upgrading to R1.7
This release note assumes that you have already upgraded to R1.6.19 or later. If you have not,
and are upgrading from 1.2.x, then read the 1.6 release notes first and follow the instructions,
before following any instructions in this R1.7 release note.
CAUTION: Before upgrading to R1.7 you must take a configuration backup using the backup
snapshot <filename> command and save the backup safely on a different device. See the
MMP Command Reference document for full details.
3.1 R1.7 Deployments
R1.7 supports the new deployments introduced in R1.6: the single combined Acano server, the
single split server and the deployment for scalability and resilience.
3.1.1 Deployments using a single host server
If you are installing the Acano solution for the first time on a single host server (a “combined”
deployment), we recommend that you read and follow the documentation in the following order:
1. Appropriate Installation Guide for your Acano Server or virtualized host.
2. The Acano solution 1.7 Single Combined Acano server Deployment Guide enabling all the
solution components on the single host. This guide refers out to the Acano Certificate
Guidelines for Single Combined Acano Server Deployments for details on obtaining and
installing certificates for this deployment.
3.1.2 Deployments using a single split server hosted on a Core server and an
Edge server
If you are installing the Acano solution for the first time in a split server model, we recommend
that you deploy the XMPP server on the Core server, and deploy the Load Balancer on the Edge
server.
Read and follow the documentation in the following order:
1. Appropriate Installation Guide for your Acano server or virtualized deployment
2. The Acano solution 1.7 Single Split Acano server Deployment Guide. This guide refers out to
the Acano Certificate Guidelines for Single Split Acano Server Deployments for details on
obtaining and installing certificates for this deployment
3.1.3 Deployments for scalability and resilience
If you are installing the Acano solution for scalability and resilience using multiple host servers,
we recommend that you deploy the XMPP server on Core servers, and deploy Load Balancers
on the Edge server.
Read and follow the documentation in the following order:
1. Appropriate Installation Guide for your Acano server or virtualized deployment
2. The Acano solution 1.7 Scalability and Resilience Deployment Guide. This guide refers out
to the Acano Certificate Guidelines for Scalable and Resilient Acano Server Deployments for
details on obtaining and installing certificates for this deployment
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 10
Notes on Installing and Upgrading to R1.7
3.2 Upgrading to Release R1.7
The instructions in this section apply to both Acano Server and virtualized deployments with a
previous Acano solution release already installed.
Upgrading the firmware is a two-stage process: first, upload the upgraded firmware image; then
issue the upgrade command. (This restarts the Acano solution: the restart process interrupts all
active calls running on the Acano solution; therefore, this stage should be done at a suitable
time so as not to impact users − or users should be warned in advance.
To install the latest firmware on the Acano server follow these steps:
1. Obtain the upgrade image from the secure partner section of the Acano website. You should
have obtained a file called upgrade.img. If this is not the case – rename the file to
upgrade.img.
Note: If you are using WinSCP for the file transfer, ensure that the Transfer Settings option is
‘binary’ not ‘text’. Using the incorrect setting results in the transferred file being slightly smaller
than the original – and this prevents successful upgrade.
2. Using a SFTP client, log into the MMP using its IP address. The login credentials will be the
ones set for the MMP admin account. If you are using Windows, we recommend using the
WinSCP tool.
Note 1: You can find the IP address of the MMP’s interface with the ipv4 admin command or
the equivalent ipv6 command.
Note 2: The SFTP server runs on the standard port, 22.
Note 3: After copying the upgrade.img file, you will not be able to see it listed as being in the file
system; this is normal.
3. Copy the software to the Acano Server/ virtualized server.
4. To apply the upgrade, issue the upgrade command.
a. Establish a SSH connection to the MMP and log in.
b. Initiate the upgrade by executing the upgrade command.
upgrade
The Acano Server/ virtualized server restarts automatically: allow 10 minutes for the process
to complete.
5. Verify that the Acano solution is running the upgraded image by re-establishing the SSH
connection to the MMP and typing:
version
6. Check the Configuration > Outbound Calls rules updating the Local Contact Domain field
and completing the new Local From Domain field if necessary.
7. Update the customization archive file when available.
8. Only if you are deploying a scaled or resilient deployment (with more than one server host—
Acano server, virtualized host or a combination) read the Scalability & Resilience
Deployment Guide and plan the rest of your deployment order and configuration.
9. Go on to the next section.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 11
Notes on Installing and Upgrading to R1.7
3.3 Downgrading
To return to the older version of the Acano solution, use the regular upgrade procedure to
“upgrade” to the appropriate version, and then restore the configuration backup for that version.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 12
Resolved Issues
4 Resolved Issues
Resolved in R1.7.0 (same build as previously labelled RC1)
Reference
Issue
Summary
5448
GUID displayed in weblink rather
than call ID
If a user receives a direct call from another Acano user
(i.e. not a call in a coSpace) and the user then clicks
the information button, the web link is displayed with a
GUID instead of a URI/call ID/passcode. Fixed in
R1.7.0, see section 2.5.2 in this release note.
5687
Cannot change branded logo on
connected SIP endpoint
If a user dials into a meeting using a connected SIP
endpoint, the endpoint displays the Acano logo and
the callBrandingProfile is not applied to
the endpoint. Fixed in R1.7.0.
5932
Grey bar at bottom of Web Bridge
landing page always displayed
Footer at bottom of Web Bridge landing page cannot
be customized. Fixed in R1.7.0. showfooter
option added to sign_in_settings.json.
6766
WebRTC clients do not support
DTMF tones
Fixed in R1.7.0. DTMF keypad now displayed in Web
clients and DTMF tones are proxied to the remote
system or interpreted from the remote system by the
Call Bridge.
6894
Malformed API calls return
information
Fixed in R1.7.0. API calls need to be formed properly
otherwise they display an error.
6898
Using the WebRTC client to call a
contact who is not logged in, takes
you to an empty conference rather
than tell you that the call has failed
This makes it feel like the user has successfully
entered an empty coSpace instead of failing to call out
to a user who is off line. Fixed in R1.7.0
7429
G.722.1c issues with non-interworked
call to LifeSize endpoint
Fixed in R1.7.0
7529
Acano media module restart
A bug in the Acano H.264 encoder can very
occasionally cause a media module to restart, but not
cause a full server restart. Fixed in R1.7.0.
7785
Lync audio client disconnected in
cospace when Acano client starts
sharing content
Fixed in R1.7.0.
7862
Calls made within a coSpace fail to
Lync clients, while point-to-point calls
are successful
Fixed in R1.7.0.
7900
Directory searching fails if 1 search
location does not work
If one directorySearchLocations fails,
then all directory searches fail. Fixed in 1.7.0.
7940
Activity list cleared of some entries
after client logs out of clustered
deployment
Point-to-point calls and calls to coSpaces that have no
chat in them are wiped from the activity list after only a
few minutes of the client logging out. Fixed in R1.7.0.
8049
Chat between Lync clients on
different Call Bridges in a distributed
call does not work
Lync clients can only chat between each other if they
land on the same Call Bridge. Fixed in R1.7.0.
8058
Loss of video from 2010 Lync client
coSpace no longer displays video from 2010 Lync
client after video is stopped and then restarted. Fixed
in R1.7.0
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 13
Resolved Issues
8106
System level CallProfile not applied
to ad hoc conferences created by
tenanted users
If a system level call profile is set, ad hoc calls created
by a user who is a member of a tenant will not always
have the call profile applied. In particular, the profile is
not applied if the system has been rebooted since it
was set. Fixed in R1.7.0.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 14
Known Limitations
5 Known Limitations
If you encounter any of the following issues, contact [email protected] because we are likely
to have test builds to send you with fixes for many or all of them by the time you find them.
Reference
Issue
Summary
3965
Unable to stop pcap capture
on serial/ssh
Occasionally users running pcap from the serial console for a
few minutes are unable to stop the capture with a Ctr+C. If this
happens try Ctr+\ or contact Acano support.
4132
Prevent logging in to the Web
Admin Interface
By going to the Web Admin Interface login page, clicking OK to
login and then holding down F5, all the sessions will be “used”
without even logging in. This prevents anyone else from logging
in until those sessions expire. This issue will be addressed in a
future release.
5228
No DNS failover for AD sync
Although the initial problem of the Call Bridge not falling back to
a second AD server address after the LDAP connection to the
first failed has been fixed in R1.2, there remains the issue that
trying to connect to a non-existent/non-responding remote
address can take a long time to time out.
6305
Sharing a presentation in full
screen mode does not work
using Chrome 42
Using the WebRTC client through Chrome, and sharing a
presentation in full screen mode, the web client continues to only
show the application. Possible work-arounds are:
- share screen rather than application
- share the Powerpoint only after starting the presentation
7796
Firefox 37+ WebRTC client
cannot connect to coSpace
Various issues experienced joining a coSpace using Firefox 37+
web browser, including the browser crashing.
7808
Wiggling panes in dock area
Participant panes in dock at bottom of screen may appear
unsteady.
7881
participantLimit field per
tenant does not apply across
calls hosted on multiple Call
Bridges
The participantLimit field, which may be set through the API, can
be applied in two places: on a tenant or as part of a callProfile.
When participantLimit is configured for a tenant, it acts to limit
the number of participants across all calls corresponding to that
tenant. However this only works correctly in single Call Bridge
deployments. In a scalable and resilient deployment, with
distributed Call Bridges, the limit is applied per Call Bridge.
When participantLimit is used as part of a callProfile it works
correctly in both the single and distributed Call Bridge cases.
8260
Problems restoring backup
snapshot taken from 1.7.0 to
a server running release 1.7.0
There is a known issue restoring a backup taken from a server
running 1.7.0 to a server also running 1.7.0. The problem is not
with the backup file but with the restore process. This will be
fixed in release 1.7.1 so any backups taken for 1.7.0 can be
restored to a server running 1.7.1. If you encounter a problem
applying a 1.7.0 backup restore you need to contact Acano
Support for advice and they will assist you to complete the
restore.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 15
© 2015 Acano (UK) Ltd. All rights reserved.
This document is provided for information purposes only and its contents are subject to change without notice. This
document may not be reproduced or transmitted in any form or by any means, for any purpose other than the
recipient’s personal use, without our prior written permission.
Acano and coSpace are trademarks of Acano. Other names may be trademarks of their respective owners.
Acano Solution: Acano Server R1.7.0 Release Notes 76-1005-19-K
Page 16