Source: https://ru.scribd.com/document/194731525/IP-Office-App-Server-Install-and-Mainten-8-1
Timestamp: 2019-07-17 15:02:21
Document Index: 713971934

Matched Legal Cases: ['sui generis', 'art 6', 'art 57', 'art 58', 'art 58', 'art 71', 'art 58']

IP Office App Server Install and Mainten 8.1 | Ip Address | Installation (Computer Programs)
Uploaded by francovilla75
saveSave IP Office App Server Install and Mainten 8.1 For Later
Voicemail Quick Reference Sb
Complete t de User Guide
IP Office 8.
IP Office Application Server Installation and Maintenance
15-601011 Issue 06g - (03 September 2013)
2013 AVAYA All Rights Reserved. Notice While reasonable efforts have been made to ensure that the information in this document is complete and accurate at the time of printing, Avaya assumes no liability for any errors. Avaya reserves the right to make changes and corrections to the information in this document without the obligation to notify any person or organization of such changes. For full support, please see the complete document, Avaya Support Notices for Hardware Documentation, document number 03600759. For full support, please see the complete document, Avaya Support Notices for Software Documentation, document number 03600758. To locate this document on our website, simply go to http://www.avaya.com/support and search for the document number in the search box. Documentation disclaimer Documentation means information published by Avaya in varying mediums which may include product information, operating instructions and performance specifications that Avaya generally makes available to users of its products. Documentation does not include marketing materials. Avaya shall not be responsible for any modifications, additions, or deletions to the original published version of documentation unless such modifications, additions, or deletions were performed by Avaya. End User agrees to indemnify and hold harmless Avaya, Avaya's agents, servants and employees against all claims, lawsuits, demands and judgments arising out of, or in connection with, subsequent modifications, additions or deletions to this documentation, to the extent made by End User. Link disclaimer Avaya is not responsible for the contents or reliability of any linked websites referenced within this site or documentation provided by Avaya. Avaya is not responsible for the accuracy of any information, statement or content provided on these sites and does not necessarily endorse the products, services, or information described or offered within them. Avaya does not guarantee that these links will work all the time and has no control over the availability of the linked pages. Warranty Avaya provides a limited warranty on its hardware and Software (Product(s)). Refer to your sales agreement to establish the terms of the limited warranty. In addition, Avayas standard warranty language, as well as information regarding support for this Product while under warranty is available to Avaya customers and other parties through the Avaya Support website: http://support.avaya.com. Please note that if you acquired the Product(s) from an authorized Avaya Channel Partner outside of the United States and Canada, the warranty is provided to you by said Avaya Channel Partner and not by Avaya. Software means computer programs in object code, provided by Avaya or an Avaya Channel Partner, whether as stand-alone products or pre-installed on hardware products, and any upgrades, updates, bug fixes, or modified versions. Licenses THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA WEBSITE, HTTP://SUPPORT.AVAYA.COM/LICENSEINFO ARE APPLICABLE TO ANYONE WHO DOWNLOADS, USES AND/OR INSTALLS AVAYA SOFTWARE, PURCHASED FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AUTHORIZED AVAYA CHANNEL PARTNER (AS APPLICABLE) UNDER A COMMERCIAL AGREEMENT WITH AVAYA OR AN AUTHORIZED AVAYA CHANNEL PARTNER. UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING, AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE WAS OBTAINED FROM ANYONE OTHER THAN AVAYA, AN AVAYA AFFILIATE OR AN AVAYA AUTHORIZED AVAYA CHANNEL PARTNER; AVAYA RESERVES THE RIGHT TO TAKE LEGAL ACTION AGAINST YOU AND ANYONE ELSE USING OR SELLING THE SOFTWARE WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING OR USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OF YOURSELF AND THE ENTITY FOR WHOM YOU ARE INSTALLING, DOWNLOADING OR USING THE SOFTWARE (HEREINAFTER REFERRED TO INTERCHANGEABLY AS YOU AND END USER), AGREE TO THESE TERMS AND CONDITIONS AND CREATE A BINDING CONTRACT BETWEEN YOU AND AVAYA INC. OR THE APPLICABLE AVAYA AFFILIATE (AVAYA). Avaya grants you a license within the scope of the license types described below, with the exception of Heritage Nortel Software, for which the scope of the license is detailed below. Where the order documentation does not expressly identify a license type, the applicable license will be a Designated System License. The applicable number of licenses and units of capacity for which the license is granted will be one (1), unless a different number of licenses or units of capacity is specified in the documentation or other materials available to you. Designated Processor means a single stand-alone computing device. Server means a Designated Processor that hosts a software application to be accessed by multiple users. License type(s) Designated System(s) License (DS). End User may install and use each copy of the Software only on a number of Designated Processors up to the number indicated in the order. Avaya may require the Designated Processor(s) to be identified in the order by type, serial number, feature key, location or other specific designation, or to be provided by End User to Avaya through electronic means established by Avaya specifically for this purpose. Concurrent User License (CU). End User may install and use the Software on multiple Designated Processors or one or more Servers, so long as only the licensed number of Units are accessing and using the Software at any given time. A Unit means the unit on which Avaya, at its sole discretion, bases the pricing of its licenses and can be, without limitation, an agent, port or user, an e-mail or voice mail account in the name of a person or corporate function (e.g., webmaster or helpdesk), or a directory entry in the administrative database utilized by the Software that permits one user to interface with the Software. Units may be linked to a specific, identified Server. Database License (DL). End User may install and use each copy of the Software on one Server or on multiple Servers provided that each of the Servers on which the Software is installed communicates with no more than a single instance of the same database. CPU License (CP). End User may install and use each copy of the Software on a number of Servers up to the number indicated in the order provided that the performance capacity of the Server(s) does not exceed the performance capacity specified for the Software. End User may not reinstall or operate the Software on Server(s) with a larger performance capacity without Avayas prior consent and payment of an upgrade fee.
IP Office Application Server Installation and Maintenance IP Office 8.1
Page 2 15-601011 Issue 06g (03 September 2013)
Named User License (NU). You may: (i) install and use the Software on a single Designated Processor or Server per authorized Named User (defined below); or (ii) install and use the Software on a Server so long as only authorized Named Users access and use the Software. Named User, means a user or device that has been expressly authorized by Avaya to access and use the Software. At Avayas sole discretion, a Named User may be, without limitation, designated by name, corporate function (e.g., webmaster or helpdesk), an e-mail or voice mail account in the name of a person or corporate function, or a directory entry in the administrative database utilized by the Software that permits one user to interface with the Software. Shrinkwrap License (SR). You may install and use the Software in accordance with the terms and conditions of the applicable license agreements, such as shrinkwrap or clickthrough license accompanying or applicable to the Software (Shrinkwrap License). Heritage Nortel Software Heritage Nortel Software means the software that was acquired by Avaya as part of its purchase of the Nortel Enterprise Solutions Business in December 2009. The Heritage Nortel Software currently available for license from Avaya is the software contained within the list of Heritage Nortel Products located at http://support.avaya.com/LicenseInfo under the link Heritage Nortel Products. For Heritage Nortel Software, Avaya grants Customer a license to use Heritage Nortel Software provided hereunder solely to the extent of the authorized activation or authorized usage level, solely for the purpose specified in the Documentation, and solely as embedded in, for execution on, or (in the event the applicable Documentation permits installation on non-Avaya equipment) for communication with Avaya equipment. Charges for Heritage Nortel Software may be based on extent of activation or use authorized as specified in an order or invoice. Copyright Except where expressly stated otherwise, no use should be made of materials on this site, the Documentation, Software, or hardware provided by Avaya. All content on this site, the documentation and the Product provided by Avaya including the selection, arrangement and design of the content is owned either by Avaya or its licensors and is protected by copyright and other intellectual property laws including the sui generis rights relating to the protection of databases. You may not modify, copy, reproduce, republish, upload, post, transmit or distribute in any way any content, in whole or in part, including any code and software unless expressly authorized by Avaya. Unauthorized reproduction, transmission, dissemination, storage, and or use without the express written consent of Avaya can be a criminal, as well as a civil offense under the applicable law. Virtualization Each vAppliance will have its own ordering code. Note that each instance of a vAppliance must be separately ordered. If the end user customer or Avaya channel partner would like to install two of the same type of vAppliances, then two vAppliances of that type must be ordered. Each Product has its own ordering code. Note that each instance of a Product must be separately licensed and ordered. Instance means one unique copy of the Software. For example, if the end user customer or Avaya channel partner would like to install two instances of the same type of Products, then two Products of that type must be ordered. Third Party Components Third Party Components mean certain software programs or portions thereof included in the Software that may contain software (including open source software) distributed under third party agreements (Third Party Components), which contain terms regarding the rights to use certain portions of the Software (Third Party Terms). Information regarding distributed Linux OS source code (for those Products that have distributed Linux OS source code) and identifying the copyright holders of the Third Party Components and the Third Party Terms that apply is available in the Documentation or on Avayas website at: http://support.avaya.com/Copyright. You agree to the Third Party Terms for any such Third Party Components. Note to Service Provider The Product may use Third Party Components that have Third Party Terms that do not allow hosting and may need to be independently licensed for such purpose. Preventing Toll Fraud Toll Fraud is the unauthorized use of your telecommunications system by an unauthorized party (for example, a person who is not a corporate employee, agent, subcontractor, or is not working on your company's behalf). Be aware that there can be a risk of Toll Fraud associated with your system and that, if Toll Fraud occurs, it can result in substantial additional charges for your telecommunications services. Avaya Toll Fraud intervention If you suspect that you are being victimized by Toll Fraud and you need technical assistance or support, call Technical Service Center Toll Fraud Intervention Hotline at +1-800-643-2353 for the United States and Canada. For additional support telephone numbers, see the Avaya Support website: http://support.avaya.com. Suspected security vulnerabilities with Avaya products should be reported to Avaya by sending mail to: securityalerts@avaya.com. Trademarks The trademarks, logos and service marks (Marks) displayed in this site, the Documentation and Product(s) provided by Avaya are the registered or unregistered Marks of Avaya, its affiliates, or other third parties. Users are not permitted to use such Marks without prior written consent from Avaya or such third party which may own the Mark. Nothing contained in this site, the Documentation and Product(s) should be construed as granting, by implication, estoppel, or otherwise, any license or right in and to the Marks without the express written permission of Avaya or the applicable third party. Avaya is a registered trademark of Avaya Inc. All non-Avaya trademarks are the property of their respective owners. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Page 3 15-601011 Issue 06g (03 September 2013)
Downloading Documentation For the most current versions of Documentation, see the Avaya Support website: http://support.avaya.com. Contact Avaya Support See the Avaya Support website: http://support.avaya.com for product notices and articles, or to report a problem with your Avaya product. For a list of support telephone numbers and contact addresses, go to the Avaya Support website: http://support.avaya.com, scroll to the bottom of the page, and select Contact Avaya Support.
Page 4 15-601011 Issue 06g (03 September 2013)
1. IP Office Application Server
1.1 Avaya Pre-Built ..................................................................... Servers 1.2 Non-Avaya..................................................................... Server Requirements 1.3 Using Linux ..................................................................... 1.4 Additional Documentation ..................................................................... 1.5 Network Configuration ..................................................................... Limitations 1.6 Small Community ..................................................................... Networks 1.7 Licenses ..................................................................... 1.8 Voicemail Pro ..................................................................... Features 10 11 12 12 13 13 14 14
6.12.2............................................................................ Upgrading Application Files 6.13 Uninstalling ..................................................................... an Application 6.14 File Repositories ..................................................................... 6.14.1............................................................................ Source Files 6.14.2............................................................................ Setting the Repository Locations 6.14.3............................................................................ Uploading Local Files 6.14.4............................................................................ Creating Remote Software Repositories
63 64 65 65 65 66 67
7. Server Menus
7.1 Home ..................................................................... 7.2 Logs ..................................................................... 7.2.1 View ............................................................................ 7.2.2 Download ............................................................................ 7.3 Updates ..................................................................... 7.3.1 Services ............................................................................ 7.3.2 System ............................................................................ 7.4 Settings ..................................................................... 7.4.1 General ............................................................................ 7.4.2 System ............................................................................ 7.5 Apps Center ..................................................................... 7.6 VNC ..................................................................... 71 73 73 74 75 76 77 78 79 83 88 89
2. DVD Installation
2.1 2.2 2.3 2.4 2.5 Software Requirements ..................................................................... Information ..................................................................... Requirements Server Software ..................................................................... Installation Logging In ..................................................................... Checking the ..................................................................... Services 16 17 18 22 23
3. Pre-Built Server Installation
3.1 Logging In ..................................................................... 27 3.2 Changing the ..................................................................... IP Address Settings 28 3.3 Changing the ..................................................................... Web Password 29
8.1 Changing the ..................................................................... Root Password 93 8.2 SSH File Transfers ..................................................................... 94 8.3 Windows to ..................................................................... Linux Voicemail Transfer 95 Index ...............................................................................97
4. Voicemail Pro Configuration
4.1 Adding Voicemail ..................................................................... Licenses 4.2 IP Office Configuration ..................................................................... 4.3 Installing the ..................................................................... Voicemail Pro Client 4.4 Logging in ..................................................................... to the Voicemail Server 4.5 Changing the ..................................................................... Voicemail Server Password 4.6 Transferring ..................................................................... Voicemail Server Settings 4.7 ContactStore ..................................................................... 4.8 Backup/Restore ..................................................................... Limitations 33 34 35 36 37 38 39 39
5. one-X Portal for IP Office Configuration
5.1 Adding Licenses ..................................................................... 5.2 Enabling one-X ..................................................................... Portal for IP Office Users 5.3 Initial one-X ..................................................................... Portal for IP Office Login 5.4 Initial AFA ..................................................................... Login 5.5 Transferring ..................................................................... one-X Portal for IP Office Settings 45 46 47 48 48
6.1 Logging In ..................................................................... 6.2 Changing the ..................................................................... Web Password 6.3 Changing the ..................................................................... Root Password 6.4 Setting the..................................................................... Password Rules 6.5 Starting/Stopping ..................................................................... Application Services 6.5.1 Starting ............................................................................ a Service 6.5.2 Stopping ............................................................................ a Service 6.5.3 Setting ............................................................................ a Service to Auto Start 6.6 Server Shutdown ..................................................................... 6.7 Rebooting ..................................................................... the Server 6.8 Changing the ..................................................................... IP Address Settings 6.9 Date and Time ..................................................................... Settings 6.10 Changing..................................................................... the Web Control Port 6.11 Setting the ..................................................................... Menu Inactivity Timeout 6.12 Upgrading ..................................................................... Applications 6.12.1............................................................................ Loading Application Files onto the Server 53 54 55 56 57 57 57 57 58 58 59 60 61 62 62 62 Page 5 15-601011 Issue 06g (03 September 2013)
Chapter 1. IP Office Application Server
Page 7 15-601011 Issue 06g (03 September 2013)
IP Office Application Server:
The IP Office Application Server is a single installation of selected IP Office 8.1 applications running on Linux. The Linux operating system is included as part of the installation. However installation requires minimal Linux knowledge due to the inclusion of a web based management interface to allow the server to be managed remotely via web browser. The IP Office Application Server installation installs the following: Linux The base operating system installed is a Linux operating system. However, no specific knowledge of Linux is required for installation or maintenance of the IP Office Application Server. one-X Portal for IP Office This is a web browser based application that user's can use to control making and answering calls on their phone. It also provides a range of gadgets for the user to access features such as their directory, call log and voicemail messages. The one-X Portal for IP Office application is configured and managed remotely using web browser access. The installer configures and licensed one-X Portal for IP Office user on the IP Office system. Voicemail Pro This is a voicemail server. It provides mailbox services to all users and hunt groups on the IP Office system. You can customize the server to provide a range of call routing and voicemail services. Configuration of the Voicemail Pro service uses the Windows Voicemail Pro client. You can download a copy of the Voicemail Pro client from the server. Licenses in the IP Office configuration set the number of simultaneous connections to voicemail. Web Control Menus These menus allow configuration of the server's own settings using a web browser.
The IP Office Application Server can be supplied either pre-installed onto a suitable server or as a DVD for installation onto a customer supplied server. Both options are covered by this manual.
Page 9 15-601011 Issue 06g (03 September 2013)
1.1 Avaya Pre-Built Servers
The IP Office Application Server can be supplied pre-installed onto a suitable server. The general specification of the servers used is: Form: Rack mounted server PC. RAM: 12GB. Hard Disk: 250GB. Ethernet Port: Only a single port (eth0) is supported. This port is labeled as port 1 on the physical server.
The following are the default settings applied to the server applied shipment from Avaya: DHCP Mode: Off IP Address: 192.168.42.10 NetMask: 255.255.255.0 Gateway: Blank Hostname: The server MAC address. DNS1: Blank DNS2: Blank Time Zone: EST - Eastern Standard Time. Root User Password: Administrator
Voicemail Pro English and French Language TTS for Voicemail Pro one-X Portal for IP Office
Page 10 15-601011 Issue 06g (03 September 2013)
IP Office Application Server: Avaya Pre-Built Servers
1.2 Non-Avaya Server Requirements
The following are the minimum server PC requirements. IMPORTANT: Compatible Servers The compatibility of any particular server PC for the operating system cannot be guaranteed. It is the installers responsibility to ensure that the server platform is compatible with CentOS 5 (http://www.centos.org). A list of tested servers is available at https://hardware.redhat.com/. The servers used by Avaya for product testing were: HP ProLiant DL160 Dell Optiplex 780MT Minimum Specification Recommended Specification Processor Intel Dual Core 2.4GHz Intel Pentium Quad Core 2.4GHz or AMD Athlon 64 4000+ or equivalent. 4GB 30GB
RAM Memory Hard Disk Space
4GB 30GB
Operating System The IP Office Application Server installation installs its own operating system (CentOS Linux), replacing any existing operating system on the PC. If an OS free PC cannot be obtained, Linux based PCs are typically cheaper than equivalent Windows based PCs. Drives DVD Drive or other bootable source for operating system installation. Other Requirements: The server PC must be configurable to boot from DVD or another external source in order to overwrite any existing OS. This may require access to the BIOS in order to change the boot order if the PC is supplied with an operating system already installed. The IP Office Application Server is intended to operate as a headless server, i.e without requiring any keyboard, video and mouse (KVM) connections after initial installation. All configuration and user access is done remotely from other PCs.
Page 11 15-601011 Issue 06g (03 September 2013)
Despite using a Linux based operating system, knowledge or experience of Linux by the installer and maintainer is not required. The IP Office Application Server is designed to be configured and maintained remotely using its web browser interface. Other services running on the server are administered using separate client applications. No access to the Linux command line is expected. Avaya does not support using the Linux desktop or command line to perform any actions on the server except when specifically instructed by Avaya.
In addition to reading this manual, you should also have, have read and be familiar with the following manuals before attempting to install a IP Office Application Server system.
one-X Portal for IP Office Administration Manual This manual covers the installation and administration menus used for the one-X Portal for IP Office application. This manual is essential to configure the application to support multiple IP Office servers in a Small Community Network. Voicemail Pro Linux Installation Manual This manual covers voicemail server configuration and scenarios with multiple servers in a Small Community Network. Those scenarios can include a mix of Windows based and Linux based servers. Voicemail Pro Administration Manual By default the voicemail server provides mailbox services to all users and hunt groups without any configuration. This manual covers administration of the voicemail server using the Voicemail Pro client in order to enable additional features. IP Office Manager Manual IP Office Manager is the application used to configure the IP Office application. This manual details how to use IP Office Manager and the full range of IP Office configuration settings.
All releases of IP Office software are accompanied by a technical bulletin. The bulletin will include details of changes that may have occurred too late to be included in this documentation. The bulletins also detail the changes in the software release compared to previous releases and any specific actions required or restrictions that apply if upgrading from a previous release.
Other Documentation and Documentation Sources
All the documentation for IP Office systems is available from the following web sites: Avaya Support Web Site - http://support.avaya.com Avaya IP Office Knowledge Base - http://marketingtools.avaya.com/knowledgebase
Page 12 15-601011 Issue 06g (03 September 2013)
IP Office Application Server: Additional Documentation
1.5 Network Configuration Limitations
The IP Office control unit has two physical LAN interfaces: LAN1 and LAN2. The ports labeled LAN and WAN respectively. Scenarios where users of the one-X Portal for IP Office application are accessing it from the IP Office's other LAN should be avoided for more than 30 users. They should also be avoided where NAT is being applied to traffic between LAN1 and LAN2. These restrictions should be observed even when the IP Office system is in a Small Community Network where the H323 SCN trunks may be routed via the other LAN.
1.6 Small Community Networks
Up to 32 IP Office systems can connect using H323 SCN trunks to form a Small Community Network, supporting up to 1000 users. When installing a IP Office Application Server within a Small Community Network, it is important to be aware of the following factors affecting the different server applications: one-X Portal for IP Office A Small Community Network only supports a single one-X Portal for IP Office. The application can support up to 500 simultaneous one-X Portal for IP Office users. Following installation of the IP Office Application Server with one-X Portal for IP Office application on it, addition configuration steps are required to configure the one-X Portal for IP Office application with details of the other IP Office systems. Refer to the one-X Portal for IP Office Installation Manual. Voicemail Pro In an Small Community Network, one Voicemail Pro server stores all mailboxes and their related messages, greeting and announcements. Additional Voicemail Pro servers installed in the network perform other specific roles. For full details, refer to the Voicemail Pro manuals. Centralized Voicemail Server In the network, one Voicemail Pro server is used as the centralized voicemail server for all IP Office systems in the network. This server is used to store all mailboxes and their related messages, greeting and announcements. This is mandatory regardless of the presence of any additional options below. The IP Office associated with the centralized server holds the licenses for voicemail server support. The other servers in the network do not require any voicemail licenses in order to use this server as their voicemail server. Fallback IP Office Without needing to install another Voicemail Pro server, the IP Office hosting the centralized voicemail server can be configured such that, if for any reason it is stopped or disabled, the centralized voicemail server switches to being controlled by another IP Office in the network. Distributed Voicemail Servers Additional Voicemail Pro servers can be installed and associated with other IP Office systems to provide call services for those systems. For example to record messages, play announcements, etc. However, any messages it records are then automatically transferred to and stored on the centralized server. The IP Office associated with the distributed server requires the appropriate licenses for voicemail server support. Backup Voicemail Server An additional sever, with the Voicemail Pro application can be specified as the backup server for the centralized server. If for any reason the voicemail application on the centralized server is stopped or disabled, the centralized IP Office will switch to using the backup voicemail server for its voicemail functions. During normal operation the centralized and backup voicemail servers automatically exchange information about mailboxes and voicemail service configuration. The backup voicemail server uses the licenses provided by the centralized IP Office. A distributed server cannot also be used as a backup server and vice versa.
Page 13 15-601011 Issue 06g (03 September 2013)
The IP Office system licenses entered into its configuration enable various features. For example, licenses enable the number of one-X Portal for IP Office users and the number of voicemail channels. For the IP Office Application Server it is important to understand the role of the following system licenses: Essential Edition This license is a pre-requisite for the Preferred Edition license below. For Voicemail Pro operation on IP Office Application Server, the following licenses are used: Essential Edition This license is a pre-requisite for the Preferred Edition license below. Preferred Edition (Voicemail Pro) This license is required for use of the Voicemail Pro application. It also enables 4 voicemail ports. It is also required as a pre-requisite for the user profile licenses required for one-X Portal for IP Office users. Preferred Edition Additional Voicemail Ports These licenses add additional voicemail ports in addition to the 4 enabled by the Preferred Edition (Voicemail Pro) license above. Messaging TTS Pro This license enables the use of text-to-speech facilities using the optional Linux TTS software and user email reading. One license per simultaneous instance of TTS usage. VMPro Recording Administrators This license enables the archiving of call recordings made by the voicemail server to a separate archiving and playback application (ContactStore for IP Office). Either this license or an Advanced Edition license is required by each IP Office system requiring such call archiving. User Profile Licenses In order to log into and use the one-X Portal for IP Office application, a user must be configured and licensed to one of the following user profile roles in the IP Office configuration: Office Worker, Teleworker or Power User. Each role requires an available Office Worker, Teleworker or Power User license in the IP Office configuration.
1.8 Voicemail Pro Features
Voicemail Pro runs on both Windows and Linux servers. Voicemail Pro running on Linux server, such as the IP Office Application Server, does not support the following features: VB Scripting 3rd Party Database Integration VPNM UMS Web Voicemail (However, access via IMAP and one-X Portal for IP Office are available as alternatives.) ContactStore ContactStore is supported for IP Office Release 8.1 Feature Pack 1 and higher.
Page 14 15-601011 Issue 06g (03 September 2013)
Chapter 2. DVD Installation
Page 15 15-601011 Issue 06g (03 September 2013)
This section covers the installation of the IP Office Application Server software onto a customer supplied server PC from the Avaya IP Office Application Server DVD.
The following software is required for the installation process and subsequent administration of the server and applications. These DVDs can be ordered from Avaya or can be downloaded from the Avaya support web site (http:// support.avaya.com).
Avaya DVDs Required
IP Office Application Server DVD Set (2 DVDs) The IP Office Application Server software is provided as a DVD set orderable from Avaya. The first DVD is the one referred to by the installation processes in this documentation. The second DVD is a copy of the Open Source Software (OSS) used by the IP Office Application Server as required by the license terms of that OSS software. TTS Language Packs (3 DVDs) Text to speech is supported by the Voicemail Pro application. These DVDs contain the installation files for the supported languages and are requested by the installation process if TTS installation is selected. IP Office Administrator Applications DVD This DVD includes the software package to install the IP Office Manager, System Status Application and Monitor applications onto a Windows PC. These applications are required for the installation and maintenance of the system.
Installer and Maintainer Applications
The following applications are used to administer and maintain the server and its applications. IP Office Manager This application is used to configure the IP Office application. It also includes tools to upload files used by Avaya IP phones to the IP Office. This application is installed from the IP Office Administrator Applications DVD onto a Windows PC. System Status Application This application is used to monitor the IP Office application and its trunks. It displays systems details, system alarms and can also display details of current calls in progress. For troubleshooting, the System Status Application is able to capture snapshots of the system's current status and configuration. This application can be used by installers, maintainers and trusted users. This application is installed from the IP Office Administrator Applications DVD onto a Windows PC. IP Office System Monitor This application is used to monitor all activity on the IP Office. It includes a range of filter settings to control the level of detail shown in the monitor trace. Interpretation of the details shown requires a high level of data and telephony experience. However all system installers and maintainers should known how to use IP Office System Monitor to capture a historical log of system activity for analysis by Avaya. This application is installed from the IP Office Administrator Applications DVD onto a Windows PC. Voicemail Pro Client This application is used to configure the Voicemail Pro application. A copy of the installation package for this application can be downloaded from the server. Web Browser A web browser is used for access to the web control pages of the sever. A browser is also used to access the oneX Portal for IP Office applications administration menus. SSH Client Access to a program that supports SFTP/SSH, for example SSH Secure Shell, is useful but not obligatory.
Page 16 15-601011 Issue 06g (03 September 2013)
DVD Installation: Software Requirements
The following information is required during the installation process: Server Applications During the installation process, you can select which IP Office Application Server applications are installed. Note that for each application selected, the normal license requirements still apply. Refer to the separate installation manual for each application for details. c Voicemail Pro If selected for installation, refer to the Voicemail Pro Linux Installation Manual for details of setup and configuration of the Voicemail Pro application. c Voicemail Text to Speech Prompts During installation, you can select whether you want TTS prompt installed. If selected, you will be prompted to select the languages that you want installed. These are installed from a separate sets of DVDs (see Software Requirements 16 ). c one-X Portal for IP Office If selected, the same information is required as for a Windows based installation of the one-X Portal for IP Office application. For example, IP address of IP Office Application Server system, LDAP server information and voicemail server address (if other than the IP Office Application Server address). Refer to the one-X Portal for IP Office Installation manual. Server IP Address Settings The IP Office Application Server supports IPv4 addressing obtain through either DHCP or static addressing. IPv4 Support Use DHCP IP Address Prefix (Netmask) Gateway Primary DNS Secondary DNS c c __________________________ c __________________________ c __________________________ c __________________________ c __________________________
c Hostname A hostname helps simplify access to the server and the applications it provides rather than requiring users to use the IP address. c Timezone The timezone in which the server is located and whether the server should use UTC or local time. c Root Password This password is used for configuration access to the server. c Client PC The IP Office Application Server is designed and intended for remote configuration and management. It is not managed directly from the server. Therefore a client PC with a web browser on the same network as the server PC is required for configuration. If Voicemail Pro server is one of the selected server applications, then the client PC must be a Windows based PC onto which the Voicemail Pro client application can be installed.
Page 17 15-601011 Issue 06g (03 September 2013)
2.3 Server Software Installation
This process installs the Linux operating system onto the server and the Linux based applications. The installation process requires approximately 15 minutes (add 30 minutes if the Test CD/DVD option is selected during the installation).
Server Software Installation (CentOS 5)
1. Insert the IP Office Application Server DVD into the PCs DVD drive and reboot the PC. 2. The PC should boot from the DVD and the display the IP Office Application Server installation screen. If the PC does not boot from the DVD and instead starts an existing operating system, that indicates that the boot order of the server PC needs to be changed. Follow the PC manufacturers instructions for accessing the PCs BIOS and setting it to boot from DVD before booting from hard disk. If the server PC already has IP Office Application Server installed, options to upgrade, downgrade, reinstall or do a new install are presented. Note that a new install will reformat the hard disk, removing all existing files including customer data. 3. After loading installation software from the DVD, the installation menus will be displayed as follows: A: Language/Keyboard These initial steps apply just to the installation process, they do not affect the installed applications. However, they also allow you to familiarize yourself with how the text menus operate. Use Tab to move the selector forwards, use AltTab to move it backward. Press Space to select the currently highlighted item.
B: Test CD/DVD If this is the first time that the DVD onto which the IP Office Application Server software has been copied has been used, it may be useful to check that the DVD has been written correctly before any changes to the server PC are made. The check process can take up to 30 minutes. If the DVD has already been used successfully for other installations, select Skip to continue. C. End User License Agreement Read through the end user license agreement. It is available in several languages, use the Change Language to select the one required. On the last page select I Accept if you want to continue with the installation. D1: Previous Installation Detected If IP Office Application Server is already installed on the server, a upgrade menu is displayed, detailing the existing installed options and the new options. If Upgrade is selected, the process continues from step J. Preparing to Install. If Install is selected, the existing installation is overwritten, continuing as below.
D2: Confirm Installation If you select No, you will be prompt to remove the DVD from the drive and then reboot the server. Use this option if you do not want to overwrite the existing data on the server.
Page 18 15-601011 Issue 06g (03 September 2013)
DVD Installation: Server Software Installation
The Advanced option can be used to adjust disk partitioning. For example, install replacing all partitions, replacing only Linux partitions or install into a new partition in any unallocated disk space. If selected, the menu for the partitioning options is displayed after the server applications selection below. Only use this option if you are familiar with disk partitioning and all contents of any existing partitions that you want to maintain have been backed up. Note that if you use this option, the Upgrade option (see Step D1) is not displayed when attempting to upgrade by booting from an ISO file on USB or DVD in future. E: Server Package Selection The applications available for installation and the version of each are indicated. Select the applications required and then select OK. If you select TTS Language Packs, the installation process will prompt you to insert the TTS Language Packs DVDs later in the installation process. F: Ethernet Address Configuration The next stages will vary slightly depending on whether the server PC has a single network interface or multiple network interfaces. F1. Single Network Interface Select Yes. Select No if you like but it will make it hard for you or users to access the server and any of the applications. If you do select No, the installer will go to the Miscellaneous Network Settings menu. F2. Multiple Network Interfaces If the server PC has multiple network interfaces, this menu will list them and shows whether they have been configured or not. Select the interface you want to configure and then select Edit. G: Network Configuration You must select at least Activate on boot and Enable IPv4 support. Currently IPv6 is not used for any of the IP Office Application Server services. The address settings entered can be changed after installation but must be valid for initial browser access to the server's web configuration pages.
G1: IPv4 Address Settings If Enable IPv4 support was selected, this menu is displayed to allow entry of the address settings. It is recommended that you use manual address configuration rather than DHCP. Do not use a restricted address such as 127.0.0.1. G2: IPv6 Address Settings If Enable IPv6 support was selected, this menu is displayed to allow entry of the address settings.
Page 19 15-601011 Issue 06g (03 September 2013)
G3: Network Settings The following general settings apply to the server if not using DHCP. The Gateway address must be set. The Primary DNS and Secondary DNS addresses can be left blank if not known. However, they should be set if possible. G4. Multiple Network Interfaces (Again) If the server PC has multiple network interfaces, the menu listing them is shown again and shows which have been configured or not. To configure another interface select it and then select Edit. When at least one of the interface has been configured, select OK. H: Hostname Configuration Having a hostname makes the server easier to access than using its IP address. You can select to obtain a hostname by DHCP, however not all DHCP servers support the issuing of hostnames. If expecting to use the Voicemail Pro service in a network of Voicemail Pro servers for functions like distributed voicemail or backup voicemail, a valid hostname is important. Do not use localhost.
I: Select Timezone Select the timezone to match the customer location. This timezone setting is important as it is used to apply time offsets to the UTC time value. The time and date settings can be altered after installation using the server's web configuration pages.
J: Root Password This is the root user password for access to the operating system. It is not normally used during IP Office Application Server configuration and maintenance. However, ensure that you note the password set. K: Preparing to Install Based on the selections made in the previous menus, the installation software now prepares the files for installation. L: Dependency Checks The installer checks that there are no conflicts or omissions within the installation selections. M: WARNING ! This is the last stage at which you can select Back to amend selections or to exit the installation process. If you select OK, the installer will start formatting the hard disk, erasing any existing data and applications. The log file can be downloaded after installation using an SFTP/SSH application 94 .
N: Formatting the Hard Disk The server hard disk is now formatted.
Page 20 15-601011 Issue 06g (03 September 2013)
O: Copying the Installation File The install image containing files to be installed is now copied to the formatted hard disk. P: Installing the Operating System Files The various files relating to the operating system are not copies to their correct locations on the hard disk.
Q: Installing the Applications The installer will now copy and install the files for the previously selected applications plus the standard applications it uses for its own management.
R.TTS Language Pack Installation If TTS Language Pack was selected during the Package Selection, the installation process will now prompt you to insert one of the TTS Language Pack DVDs. After inserting a TTS Language Pack DVD, the list of languages on the DVD is displayed. Select the languages required and then select Next. After the languages are installed click OK. You can now either insert another Language Pack DVD to install the languages on it or select Cancel to complete TTS language installation. R: Installation Complete The installation of the operating system and applications is now complete. Remove the IP Office Application Server DVD from the server PC. Then select the Reboot option.
S: IP Office Application Server Booted The adjacent screen is shown after successful start of the IP Office Application Server. The address shown is that for IP Office Application Server configuration access using a web browser. It is not necessary to login at this menu. All configuration of the IP Office Application Server is done through remote web browser 22 access. The important detail on this display is the IP address, especially if the server is configured to obtain its address by DHCP.
Page 21 15-601011 Issue 06g (03 September 2013)
Administration of the IP Office Application Server is done using a web browser on a client PC with network access to the IP Office Application Server. 1. From a client PC, start the browser and enter http:// followed by the address of the IP Office Application Server and :7070. The port number and protocol (http or https) used can be changed through the Settings | General 79 menu after logging in. 2. The login page appears. Select the Language required.
3. Enter the name and password for IP Office Application Server administration. The default name and password are Administrator and Administrator. Select Change Password 54 to change the password. 4. If the login is successful, the Home
page for the server appears.
Page 22 15-601011 Issue 06g (03 September 2013)
DVD Installation: Logging In
2.5 Checking the Services
After logging in 22 to the IP Office Application Server, the Home page provides a summary of the services that the server can provide and the status (started or stopped) of those services. By default all the application services are set to automatically start. However, they may still require individual configuration and the addition of licenses to the IP Office configuration.
1. Login and select the Home menu.
2. Check that the expected services have been started. If not, each can be individually started using the Start/Stop buttons on the right. 3. Check the Notifications panel is not listing any errors that would indicate a problem with the installation. 4. If all the services are started as expected, each can be individually configured. 5. If the sever is running correctly, logout and then log in again using the Change Password
Page 23 15-601011 Issue 06g (03 September 2013)
Chapter 3. Pre-Built Server Installation
Page 25 15-601011 Issue 06g (03 September 2013)
While on a pre-built Avaya server the IP Office Application Server software is pre-installed, there are still some basic installation processes that must be completed before it can be used with the IP Office system. Those basic processes are covered in this and the two following chapters.
1. Initial IP Office Application Server configuration: a. Change the IP address settings to match the customer network b. Change the default password used for web control access 2. Initial Voicemail Pro configuration: a. IP Office Configuration i. Adding voicemail licenses
ii. Check the Voicemail Type Setting b. Voicemail Pro Configuration i. Install the Voicemail Pro client
ii. Log in to the Voicemail Pro server
iii.Change the default administrator password 3. Initial one-X Portal for IP Office configuration:
a. Add licenses 45 Those IP Office users who want to use the one-X Portal for IP Office application need to have their Profile set to Office Worker, Teleworker or Power User and the Enable one-X Portal Services option selected. To do this requires the addition of licenses for those roles. b. Enable one-X Portal for IP Office users 46 When licenses are available, the number of licenses allows the configuration of the equivalent number of users for those roles and then for one-X Portal for IP Office usage. c. Initial one-X Portal for IP Office login 47 Having licensed and configured some users for one-X Portal for IP Office, you need to login as the one-X Portal for IP Office administrator in order to perform initial one-X Portal for IP Office configuration. d. Initial AFA login 48 The one-X Portal for IP Office AFA interface is used for remote backup and restoration of the application. At minimum you should login in order to change the default password for the interface.
If the IP Office Application Server is a replacement for an existing Voicemail Pro and/or one-X Portal for IP Office server, additional steps are required to backup and restore the settings from the existing servers. You should read and understand the addition steps for the backup and restoration before beginning the IP Office Application Server installation. Transferring Voicemail Pro Settings
Transferring one-X Portal for IP Office Settings
Page 26 15-601011 Issue 06g (03 September 2013)
Pre-Built Server Installation:
1. From a client PC, start the browser and enter http:// followed by the address of the IP Office Application Server and :7070. The port number and protocol (http or https) used can be changed through the Settings | General 79 menu after logging in. 2. The login page appears. Select the Language required.
Page 27 15-601011 Issue 06g (03 September 2013)
3.2 Changing the IP Address Settings
On shipment the IP Office Application Server has a default IP address of 192.168.42.10. You can change the server's IP address and other network settings. Warning Changing IP address and other network settings requires you to login again. If the server is using DHCP or is switched to DHCP, the address obtained for the server is displayed on the server's command line display. ! Warning The Unified Communications Module should use an IP address on the same subnet as the IP Office system's LAN1.
to the server's web configuration pages.
2. Select Settings. 3. Select System. 4. The Network section shows the IP address settings: Network Interface This drop down allows selection of which network interface is currently being configured by the web form. Within the IP Office configuration, Eth0 matches LAN1, Eth1 matches LAN2. On the pre-built IP Office Application Server only Eth0 is used. This port is labeled as port 1 on the physical server. Host Name Sets the host name that the IP Office Application Server should use. This setting requires the local network to support a DNS server. Do not use localhost. Use DHCP If selected, the server obtains its IP address, subnet mask and default gateway settings by making DHCP requests. The related fields show the values obtained in response to the DHCP request. IP Address Displays the IP address set for the server. Subnet Mask Displays the subnet mask applied to the IP address. Default Gateway Displays the default gateway settings for routing. System DNS Enter the address of the primary DNS server. The server greys out this option if it obtains the address of the DNS server from a DHCP server (see below). Automatically obtain DNS from provider This setting is only useable if Use DHCP is also selected. If selected, the server attempts to obtain DNS server details from the DHCP server. 5. Click Save. The server restarts.
Page 28 15-601011 Issue 06g (03 September 2013)
Pre-Built Server Installation: Changing the IP Address Settings
3.3 Changing the Web Password
To change the browser password:
3. Click on the Change password link. The change password menu appears.
4. Enter the current password and the new password. The new password must meet the complexity requirements displayed on the menu. Once logged in, you can change the password complexity requirements. 5. Click OK. The menu confirms whether the change was successful or not. If the new password is accepted, click Cancel to return to the Login menu.
Page 29 15-601011 Issue 06g (03 September 2013)
Page 30 15-601011 Issue 06g (03 September 2013)
Chapter 4. Voicemail Pro Configuration
Page 31 15-601011 Issue 06g (03 September 2013)
By default the Voicemail Pro application will provide basic mailbox services for all users and hunt groups created in the IP Office configuration. For installations with just a single IP Office and Voicemail Pro server this will normally occur without any further configuration. Details of IP Office and Voicemail Pro configuration are covered by the Voicemail Pro Linux Installation manual and Voicemail Pro Administration manuals. This section of this manual covers only the minimum steps recommended to ensure that the voicemail server is operating correctly and is secure. Those are:
Voicemail Pro Initial Configuration
a. IP Office Configuration i. Adding voicemail licenses
iii.Change the default administrator password
IMPORTANT: Voicemail IP Address Note
The IP address 169.254.0.2 is used for internal connected between the IP Office system and the voicemail application on the Unified Communications Module. This is the address that should be set for the voicemail server 34 in the IP Office configuration. This address should not be used for any other purpose such as external access to the voicemail server application. For all other access to the voicemail server from elsewhere on the network, the IP address of the Unified Communications Module should be used. To check that address, see Viewing the Module IP Address.
Transferring Settings from a Previous Server
If the IP Office system was already configured to operate with an external Voicemail Pro server that is now being replaced, the settings, prompts and messages on the old server can be transferred to the new server. After completing the steps above, see Transferring Voicemail Server Settings 38 .
For use of UMS options, the Voicemail Pro service needs to communicate with a MAPI proxy application installed on a Windows PC. The installation package for the MAPI proxy can be downloaded from the server's Windows Client 88 menu. For full details refer to the Voicemail Pro Linux Installation manual.
Page 32 15-601011 Issue 06g (03 September 2013)
Voicemail Pro Configuration:
4.1 Adding Voicemail Licenses
The Voicemail Pro application will operate for up to 2 hours without a license. This allows a level of basic installation testing and configuration. However, for full operation the application must be licensed using licenses entered into the IP Office configuration. For Voicemail Pro operation on IP Office Application Server, the following licenses are used: Essential Edition This license is a pre-requisite for the Preferred Edition license below. Preferred Edition (Voicemail Pro) This license is required for use of the Voicemail Pro application. It also enables 4 voicemail ports. It is also required as a pre-requisite for the user profile licenses required for one-X Portal for IP Office users. Preferred Edition Additional Voicemail Ports These licenses add additional voicemail ports in addition to the 4 enabled by the Preferred Edition (Voicemail Pro) license above. Messaging TTS Pro This license enables the use of text-to-speech facilities using the optional Linux TTS software and user email reading. One license per simultaneous instance of TTS usage. VMPro Recording Administrators This license enables the archiving of call recordings made by the voicemail server to a separate archiving and playback application (ContactStore for IP Office). Either this license or an Advanced Edition license is required by each IP Office system requiring such call archiving.
To enter licenses:
1. Start IP Office Manager and receive the configuration from the IP Office system. 2. Select License.
3. To add a license, click and select License. Enter the new license and click OK. To avoid potential issues with mistyping, we recommend you add licenses by cutting and pasting them from the supplied license file. 4. The Status of the new license should show Unknown and the name the license should match the type of license entered. If the name shows as Invalid, the most likely cause is incorrect entry of the license key characters. 5. Click on the save icon to send the configuration back to the IP Office.
6. Use Manager to receive the configuration again and check that the status of the license. It should now be Valid.
Page 33 15-601011 Issue 06g (03 September 2013)
4.2 IP Office Configuration
When a IP Office Application Server running Voicemail Pro is added, the IP Office system configuration needs to be adjusted to use the voicemail server. If a different role is intended for the voicemail server (see Small Community Networks 13 ), refer to the Voicemail Pro Installation Manual. This section only covers voicemail server support for the IP Office in which it is installed.
1. Start IP Office Manager and receive the configuration from the IP Office system. 2. Select System.
3. Select the Voicemail tab.
The Voicemail Type should be set to Voicemail Lite/Pro. The Voicemail IP Address should be set to match the IP address given to the server hosting Voicemail Pro. For an Avaya supplied server the default address is 192.168.42.10. For simplicity, if you only have the one voicemail server, an address of 0.0.0.0 tells the IP Office to broadcast a request for the voicemail server and to use the server that replies. In the Voicemail Channel Reservation section, the number of channels will be 4 plus any additional channels licensed. 4. If any changes have been made, save the changes back to the IP Office system.
Page 34 15-601011 Issue 06g (03 September 2013)
Voicemail Pro Configuration: IP Office Configuration
4.3 Installing the Voicemail Pro Client
The client for the Voicemail Pro server must be installed on a Windows PC. It can then be used to remotely administer the voicemail server. The software package for installing the client can be downloaded from the IP Office Application Server using the following process.
1. From a client PC, start the browser and enter http:// followed by the address of the server and :7070. 2. The server's web login page is displayed. Enter the name and password configured for server administration. 3. After logging in, select the Apps Center heading.
4. Click on the link for the Voicemail Pro client file in order to download the software package for installing the client. 5. Once the package has been downloaded, run it to install the Voicemail Pro client.
Page 35 15-601011 Issue 06g (03 September 2013)
4.4 Logging in to the Voicemail Server
To connect to a remote voicemail server you will need to login using the name and password of an administrator account already configured on that server. The default account is Administrator and Administrator.
To Login with the Voicemail Pro Client
1. From the Start menu, select Programs | IP Office | Voicemail Pro Client. 2. The Voicemail Pro Client window opens. If the client has been started before, it will attempt to start in the same mode as it previously used. If it cannot do that or it is the first time the client has been started, the select mode menu is displayed.
3. Select Online. The menu for entering the name, password and details of the server is displayed.
4. Enter the User Name and User Password for an administrator account on the voicemail server. The default account is Administrator and Administrator. 5. In the Unit Name\IP Address field enter the DNS name or IP address of the voicemail server. Alternatively click on Browse to search the local network for a server and select a server from the results.
6. Click Login. Note that if 3 unsuccessful logins are attempted using a particular administrator account name, that administrator account is locked for an hour. 7. The following menu may appear. Select Download. 8. You should now change the password
Page 36 15-601011 Issue 06g (03 September 2013)
Voicemail Pro Configuration: Logging in to the Voicemail Server
4.5 Changing the Voicemail Server Password
While logged in to the server using the Voicemail Pro client, you can change the password of the Voicemail Pro administrator account being used. The default password of the default account must be changed. You can also create additional administrator accounts, refer to the Voicemail Pro Administrator manual.
To Change the Voicemail Pro Administrator Password
1. From the File menu, select Change Password.
2. In the New Password box, type the new password. 3. In the Confirm Password box, retype the new password. 4. Click OK.
Page 37 15-601011 Issue 06g (03 September 2013)
4.6 Transferring Voicemail Server Settings
If the IP Office Application Server is replacing an existing voicemail server, a backup of all the settings, prompts and messages from that server can be transferred to the new server. If the existing server is a Linux based server, SSH file transfer is used to retrieve the backup files from the server. Otherwise, if Windows based, a direct folder copy on the server can be used. SSH File transfer is then used to transfer the backup file set onto the new server.
Backing Up the Old Voicemail Server
A full immediate backup of all the voicemail server settings, prompts and messages can be obtained using the Voicemail Pro client. 1. Connect to the old voicemail using the Voicemail Pro client. Hint: The option File | Voicemail Shutdown | Suspend Calls can be used to display the number of currently active voicemail sessions. If necessary you can used the menu to stop any new sessions or to force the end of all sessions before taking the backup. 2. Select Preferences | General. Select the Housekeeping tab. 3. Select Backup Now.
4. Select all the backup options for a complete backup and click OK. This will create a backup folder, the name of which includes the date and time of the backup and Immediate. For example VMPro_Backup_26012011124108_Immediate. 5. The time to complete the backup will vary greatly depending on the number of mailboxes and messages being supported by the server.
Shutting Down the Old Voicemail Server
Once the server has been backed up, it should be shutdown. This will release all the licenses it has currently obtained from the IP Office system. 1. Once the backup above has been completed, select File | Voicemail Shutdown | Shutdown. 2. Select Shut Down Immediately. This will start a forced shutdown of the server, ending any currently active voicemail sessions.
Loading the Backup onto the New Server Using SSH
Use the following method to transfer and then restore the backup. 1. Connect to the IP Office Application Server using an SSH File transfer tool
2. Copy the backup folder into the folder /opt/vmpro/Backup/Scheduled/OtherBackups. 3. Using a web browser, login
4. Select Settings. On the General tab, select the Restore button for the Voicemail service. From the list of available backups, select the one just copied onto the server. 5. Click OK. 6. Once the restore has been completed, on the Home menu, Stop and then Start the voicemail service.
Page 38 15-601011 Issue 06g (03 September 2013)
Voicemail Pro Configuration: Transferring Voicemail Server Settings
4.7 ContactStore
IP Office Release 8.1 Feature Pack 1 and higher supports the use of a Windows based ContactStore for IP Office server with a Linux based Voicemail Pro server. That includes support for both normal and authenticated voice recording settings configured on the IP Office switch. In order to operate, the Linux based voicemail server automatically transfers recordings to a folder on the Windows ContactStore server using SFTP. The ContactStore application is configured to monitor and collect any recordings that appear in that folder and add them to its recordings database. The voicemail server configuration is done through the Voicemail Recording tab (Preferences | General) of the Voicemail Pro client. The tab specifies the path and user name/password details for SFTP file transfers to a folder on the ContactStore server. This requires the ContactStore server to have an SFTP application running in order to receive files from the Linux based voicemail server. The tab appears in the Voicemail Pro client only when connected to a Linux based voicemail server. Refer to the Voicemail Pro administration manuals for details. The ContactStore configuration is done through the usual Windows registry settings of the ContactStore application. The registry path for the applications VRL directory (HKEY_LOCAL_MACHINE | SOFTWARE | Network Alchemy | Voicemail | Directories | VRLDir) needs to be set to match the SFTP application folder on the ContactStore server to which the Linux based voicemail server has been configured to send recordings. Refer to the ContactStore installation manual.
4.8 Backup/Restore Limitations
If extra folders have been manually created on the voicemail server, on Linux based voicemail servers these folders are not included in the restore process. Instead the extra folders need to be copied manually. For example, if a folder containing custom prompts for use in call flows has been created separate from the default language folders used for prompts, that folder will not be backed up or restored. To resolve this, the extra folders must be backed up and restored manually. In the following example, a folder Custom is manual copied from an existing server to create a backup. It is then manually restored.
Manually Backing Up a Custom Folder
1. Using an SSH file transfer tool the folder.
, copy the folder Custom from /opt/vmpro to your PC to create a backup of
Manually Restoring a Custom Folder
1. To restore the folder, again using an SSH file transfer tool, copy the folder to the /home/webcontrol folder on the server. 2. Using the SSH command line, you now need to copy the Custom folder from /home/webcontrol to the /opt/vmpro folder. This is done by logging in as the root user. a. Login to the system's command line interface using the existing root user password. This can be done either directly on the server or remotely using an SSH client shell application. If logging in at the on the server: a. At the Command: prompt, enter login. b. At the login: prompt enter webcontrol. c. At the Password: prompt, enter the password (the default is web). If logging in remotely: a. Start your SSH shell application and connect to the IP Office Application Server PC. The exact method will depend on the application being used. The Host Name is the IP address of the IP Office Application Server. The User Name is webcontrol. The Protocol is SFTP/SSH. The Port is 22. If this is the first time the application has connected to the server, accept the trusted key. b. If this is the first time the application has connected to the IP Office Application Server, accept the trusted key. c. When prompted, enter the webcontrol user password
, the default is web.
b. Enter admin. At the password prompt enter the admin password, the default is Administrator. The prompt should change to Admin>. c. Enter root. At the password prompt, enter the current root user password.
Page 39 15-601011 Issue 06g (03 September 2013)
d. The prompt should have changed to something similar to root@APPSDVD~]#, indicating that you are now logged in as the root user. e. Change directory by entering cd /home/webcontrol. f. Move the Custom sub-folder to /opt/vmpro by entering mv Custom /opt/vmpro. 3. Using the SSH file transfer tool again, verify that the Custom has been copied to /opt/vmpro as required.
Page 40 15-601011 Issue 06g (03 September 2013)
Voicemail Pro Configuration: Backup/Restore Limitations
Page 41 15-601011 Issue 06g (03 September 2013)
Chapter 5. one-X Portal for IP Office Configuration
Page 43 15-601011 Issue 06g (03 September 2013)
At this stage, the one-X Portal for IP Office server software has been installed on the server and its service started. However, both the IP Office and the one-X Portal for IP Office services still require some basic configuration. The following sections are a summary applicable to most installations. For full details of one-X Portal for IP Office installation refer to the one-X Portal for IP Office Installation Manual.
one-X Portal for IP Office Initial Configuration
Page 44 15-601011 Issue 06g (03 September 2013)
one-X Portal for IP Office Configuration:
5.1 Adding Licenses
In order to log into and use the one-X Portal for IP Office application, a user must have their Profile setting in the IP Office configuration set to one of the following user profile roles: Office Worker, Teleworker or Power User. To do that first requires a matching Office Worker, Teleworker or Power User license to be available.
Page 45 15-601011 Issue 06g (03 September 2013)
5.2 Enabling one-X Portal for IP Office Users
Those users who want to use the one-X Portal for IP Office application need to have their Profile set to Office Worker, Teleworker or Power User and the Enable one-X Portal Services option selected. This requires available licenses 45 for those roles.
1. Start IP Office Manager and click on the 2. Select the IP Office and click OK.
3. Enter the user name and password for access to the IP Office configuration settings. 4. Click on User.
5. Select the user who you want to enable for one-X Portal for IP Office operation. Select the User tab.
6. Change the user's Profile to Office Worker, Teleworker or Power User. 7. Check that the Enable one-X Portal Services check box is selected. 8. Note the user Name and Password. These are used by the user to login to one-X Portal for IP Office. 10.Repeat the process for any other users who will be using one-X Portal for IP Office services. 11.Click on to save the updated configuration back to the IP Office system.
Page 46 15-601011 Issue 06g (03 September 2013)
one-X Portal for IP Office Configuration: Enabling one-X Portal for IP Office Users
5.3 Initial one-X Portal for IP Office Login
The initial one-X Portal for IP Office configuration is done using web browser access to the administrator address.
one-X Portal for IP Office Login
1. Open a web browser and enter the IP address of the IP Office Application Server followed by :8080/onexportaladmin.html. This is the login path for the administrator access to the one-X Portal for IP Office application. 2. The login menu is displayed. a. If the message System is currently unavailable - please wait is displayed, the one-X Portal for IP Office application is still starting. When the message disappears, you can login. b. Enter the default administrator name (Administrator) and password (Administrator) and click Login. c. Follow the process for one-X Portal for IP Office initial configuration as described in the one-X Portal for IP Office Installation Manual. d. As the final step, the one-X Portal for IP Office server will prompt you to change the password used for administrator access. e. Enter a new password and click Change Password. f. You now have access to the one-X Portal for IP Office administration menus. For full details refer to the one-X Portal for IP Office Administration manual. g. Click on Log Out. 3. Click on User Login shown top-right. 4. The login window will display System in currently unavailable. When this message is no longer displayed, attempt to login as a user.
Page 47 15-601011 Issue 06g (03 September 2013)
5.4 Initial AFA Login
The AFA menus provided by one-X Portal for IP Office are used to perform backup and restoration operations for the application. The default password used for the menus should be changed.
1. Open a web browser and enter the IP address of the IP Office Application Server followed by :8080/onexportalafa.html. This is the login path for the administrator access to the one-X Portal for IP Office AFA menus. 2. At the login menu, enter the name Superuser and the associated password. The default password is MyFirstLogin1_0. After logging with the default password you will be prompted the following information including a new password: Display Name Enter a name for display in the one-X Portal for IP Office menus. Password/Confirm Password Enter a password that will be used for future access. Backup Folder This is the path to be used for backup and restore operations on the one-X Portal for IP Office server. Note that even if backing up and restoring to and from an FTP or local PC folder, this server folder is still used for temporary file storage.
5.5 Transferring one-X Portal for IP Office Settings
If the IP Office Application Server is replacing an existing one-X Portal for IP Office server, a backup of all the one-X Portal for IP Office settings can be transferred to the new server. The backup is obtained from the old server via web browser access. Web browser access to the new server is then also used to reload the same backup. The backup and restore process can use either an intermediate FTP file server or can use files downloaded and restored to and from the browsing PC.
Backing Up the one-X Portal for IP Office
The backup process will create a zip file with the date and time also added to the selected file name of the zip file. 1. Browse to the old server using the address http://<server>:8080/onexportal-afa.html where <server> is the name or the IP address of the server. 2. At the login menu, enter the name Superuser and enter the associated password. 3. Select DB Operations. 4. Select Backup. 5. For Backup To select either FTP (an FTP server) or Local Drive (the PC from which you are browsing). If you select FTP, you will also need to complete address, name and password settings for uploading files to the FTP server. 6. Click Backup.
Restoring the one-X Portal for IP Office Settings
Once a backup file has been obtained, a similar process can be used to load it onto the new server. 1. Browse to the new server using the address http://<server>:8080/onexportal-afa.html where <server> is the name or the IP address of the server. 2. At the login menu, enter the name Superuser and enter the associated password. 3. Select DB Operations. 4. Select Restore. 5. For Restore From select either FTP (an FTP server) or Local Drive (the PC from which you are browsing). If you select FTP, you will also need to complete address, name and password settings uploading files to the FTP server. If you selected FTP: a. Click Show Available Backups. b. Select the backup to restore and click Restore. If you selected Local Drive: a. Use the Browse option to select the backup file.
Page 48 15-601011 Issue 06g (03 September 2013)
one-X Portal for IP Office Configuration: Transferring one-X Portal for IP Office Settings
b. Click Restore.
Page 49 15-601011 Issue 06g (03 September 2013)
Chapter 6. Server Maintenance
Page 51 15-601011 Issue 06g (03 September 2013)
The main configuration and control of the IP Office Application Server is done via web browser access. After logging in using the administrator name and password, you are able to view the status of the services provided by the server and to perform actions such as stopping or starting those services. Logging In
Changing the Web Password Changing the Root Password Setting the Password Rules
Starting/Stopping Application Services Server Shutdown
Changing the IP Address Settings Date and Time Settings
Changing the Web Control Port
Setting the Menu Inactivity Timeout Upgrading an Application
Uninstalling an Application Setting Update Repositories
Page 52 15-601011 Issue 06g (03 September 2013)
Login using the IP address set during ignition, suffixed with the port :7070. Do not login using the IP Office system's LAN1 address.
To login to the server web control menus:
Page 53 15-601011 Issue 06g (03 September 2013)
6.2 Changing the Web Password
Page 54 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Changing the Web Password
6.3 Changing the Root Password
The root password for the server is set during the server installation. This is a password used for Linux command line access and so is not normally used during normal operation. However, for security you can change the root password through the web control menus.
2. Select Settings and click on the System tab. 3. The new root password is set through the Change Root Password menu.
New Password Enter the new password for the server's root account. Confirm New Password Confirm the new password. 4. Note the rules displayed for the password entry, enter the new password. The password complexity requirements are set in the Password Rules Settings 56 menu. The rules set there are applied to changing both the root password 55 and changing the web control administrator password 54 . 5. Click Save. The menu will confirm if the new password was accepted.
Page 55 15-601011 Issue 06g (03 September 2013)
6.4 Setting the Password Rules
You can configure the rules applied to new passwords. These rules are applied when changing the web administrator password 54 . They are also applied when changing the root password 55 . The current rules are shown on the change password menus when someone attempts to change either password.
To change the password rule settings:
2. Select Settings and click on the System tab. 3. The current password rules are shown in the Password Rules Settings menu.
Minimum password length This field set the minimum length of new passwords. Note that the combined requirements of the fields below for particular character types may create a requirement that exceed this value. Note also that the maximum password length is 31 characters. Minimum number of uppercase characters This field sets the number of uppercase alphabetic characters that new passwords must contain. Minimum number of lowercase characters This field sets the number of lowercase alphabetic characters that new passwords must contain. Minimum number of numeric characters This field sets the number of numeric characters that new passwords must contain. Minimum number of special characters This field sets the number of non-alphanumeric characters that new passwords must contain. Allow character sequences If this option is selected, character sequences such as 1234 or 1111 or abcd, are allowed in new passwords without any restriction. When not selected, the maximum length of any sequence is set by the field below. Maximum allowed sequence length This field is used to set the maximum allowed length of any character sequence when Allow character sequences is not selected. 4. Adjust the rules are required and then click Save.
Page 56 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Setting the Password Rules
6.5 Starting/Stopping Application Services
The application services installed on the IP Office Application Server can be started and stopped individually. This may be necessary for maintenance or if a particular service is not currently required, for example if one-X Portal for IP Office has been installed but is not wanted or currently licensed. The services can be set to automatically start after a server reboot. By default all the application services are automatically started.
6.5.1 Starting a Service
2. Select Home. The services and their current status (running or stopped) are listed. 3. To start a particular service click on the Start button next to the service. To start all the services that are not currently running, click on the Start All button.
6.5.2 Stopping a Service
2. Select Home. The services and their current status (running or stopped) are listed. 3. To start a particular service click on the Stop button next to the service. To stop all the services that are currently running, click on the Stop All button. 4. The service's status changes to stopping while it is being stopped. If it remains in this state too long, the service can be forced to stop by clicking on Force Stop.
6.5.3 Setting a Service to Auto Start
By default all the application services are automatically started.
To change a services auto start setting:
2. Select Home. The services and their current status (running or stopped) are listed. 3. Use the Auto Start check box to indicate whether a service should automatically start when the IP Office Application Server is started.
Page 57 15-601011 Issue 06g (03 September 2013)
6.6 Server Shutdown
Use this process when it is necessary to switch off the IP Office Application Server for any period. Once the process has been completed, power to the server can be switched off. To restart the server, switch the server power back on.
2. After logging in, select the Home
3. Click on Shutdown. The menu prompts you to confirm the action.
4. Click Yes to confirm that you want to proceed with the shutdown. 5. The login page appears again. Do not attempt to login again immediately. 6. After a few minutes, typically no more than 2 minutes, the server shuts down. 7. Switch off power to the server.
6.7 Rebooting the Server
Rebooting the server stops all currently running services and then stops and restarts the server. Only those application services set to Auto Start 57 automatically restart after the reboot.
3. Click on Reboot. The menu prompts you to confirm the action.
4. Click Yes to confirm that you want to proceed with the reboot. 5. The login page appears again. Do not attempt to login again immediately. 6. After a few minutes, typically no more than 5 minutes, you should be able to login again. 7. Once logged in, you can manually restart any services required if not set to Auto Start.
Page 58 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Rebooting the Server
6.8 Changing the IP Address Settings
You can change the server's IP address and other network settings. Warning Changing IP address and other network settings requires you to login again. If the server is using DHCP or is switched to DHCP, the address obtained for the server is displayed on the server's command line display. ! Warning The Unified Communications Module should use an IP address on the same subnet as the IP Office system's LAN1.
Page 59 15-601011 Issue 06g (03 September 2013)
6.9 Date and Time Settings
The date and time settings used by the server PC can be changed through the server's web configuration pages. The current time being used by the server is shown on the Home 71 menu.
2. Select Settings. 3. Select System. 4. The date and time settings are shown in the Date Time section. Date Shows the current date being used by the server. If Enable Network Time Protocol is selected, this is the date obtained from the NTP server and cannot be manually changed. Time Shows the current UTC time being used by the server. If Enable Network Time Protocol is selected, this is the time obtained from the NTP server and cannot be manually changed. The current time being used by the server is shown on the Home 71 menu. Timezone In some instances the time displayed or used by a function needs to be the local time rather than UTC time. The Timezone field is used to determine the appropriate offset that should be applied to the UTC time above. Note that changing the timezone can cause a Session expired message to appear in the browser. Enable Network Time Protocol If this option is selected, the IP Office Application Server will attempt to obtain the current UTC time from the NTP servers listed in the NTP Servers list below. It will then use that time and make regular NTP requests to update the date and time. The following options are only used if Enable Network Time Protocol is selected. NTP Servers This field is used to enter the IP address of an NTP server or servers which should be used when Enable Network Time Protocol is selected. Enter each address as a separate line. The network administrator or ISP may have an NTP server for this purpose. A list of publicly accessible NTP servers is available at http://support.ntp.org/bin/view/Servers/WebHome, however it is your responsibility to make sure you are aware of the usage policy for any servers you choose. Choosing several unrelated NTP servers is recommended in case one of the servers you are using becomes unreachable or its clock is unreliable. The operating system uses the responses it receives from the servers to determine which are reliable. The IP Office system can also use NTP to obtain its system time. Using the same servers for the IP Office Application Server and IP Office system is recommended. Synchronize system clock before starting service When using NTP, the time obtained by the operating system is used to gradually change the server's hardware clock time. If this option is selected, an immediate update of the server's clock to match the NTP obtained time is forced. Use local time source When using NTP, the time obtained by the operating system is used to gradually change the server's hardware clock time. If this option is selected, the server's hardware clock time is used as the current time rather than the NTP time. 5. Click Save.
Page 60 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Date and Time Settings
6.10 Changing the Web Control Port
By default, access to the web control menus uses http and port 7070. These can be changed if required. Warning Changing IP address and other network settings requires you to login again. If the server is using DHCP or is switched to DHCP, the address obtained for the server is displayed on the server's command line display.
To change the web control port setting:
2. Select Settings. 3. Select General. 4. The Application Port and Protocol settings are shown in the Web Control section. Application Port Change the port used for logging in. The default is 7070. If you change this value you must ensure that you do not set it to a value already used by another service or application. Protocol Select the protocol used for connection. The default is http. The options are http or https. 5. Click Save. The server will advise you that it is restarting the web service and that you will need to login again.
Page 61 15-601011 Issue 06g (03 September 2013)
6.11 Setting the Menu Inactivity Timeout
You can adjust the inactivity time applied to the web control menus.
Note that changing this setting requires you to login again.
To change the menu inactivity timeout:
2. Select Settings. 3. Select General. 4. The Inactivity timeout is shown in the Web Control section. Inactivity Timeout Select the period of inactivity after which the web session is automatically logged out. Changing this value requires you to login again. The options are 5 minutes, 10 minutes, 30 minutes and 1 hour. 5. Click Save. The server restarts the web service and requires you to login again.
6.12 Upgrading Applications
The application services hosted by the IP Office Application Server can be upgraded without having to reinstall or upgrade the whole server. This is done using files either uploaded to the server (local) or downloaded by the server from an HTTP folder (remote repository), see File Repositories 65 . Once an RPM file or files are available, the IP Office Application Server web configuration pages will list the available versions and allow switching between versions or simple upgrading to the latest version. Warning Before upgrading or changing the version of any installed application or operating system components, you must ensure that you have read the appropriate Avaya Technical Bulletins for the software release. The Technical Bulletins detail supported versions of software and known issues or additional actions required for upgrading.
The options in this section cover the upgrading of individual components of the operating system and applications supported by the IP Office Application Server. If a full reinstallation is necessary, following suitable backup of the user data, the server can be reinstalled from DVD.
6.12.1 Loading Application Files onto the Server
This method uploads the RPM file for an application onto the IP Office Application Server. The files can then be used to update the applications. The alternative is to use files loaded into a remote software repository 67 . 1. Login
2. Select the Settings menu and then the General sub-menu. 3. Check that the Local checkbox for Applications is selected. 4. Click on the Browse button and browse to the location of the file file name should now be listed in the File field. 5. Click Add. The server will now start uploading the file. 6. Repeat the process for any other files. Voicemail Pro Each version of the Voicemail Pro server application is split into separate RPM files for the server and each of the prompt languages it supports. Unless advised otherwise, you should upload the full set of files to the file repository.
that you want to load and select the file. The
Page 62 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Upgrading Applications
6.12.2 Upgrading Application Files
Where multiple versions of a software component are available to the server, the web menus can be used to update or change the current version installed.
2. Select the Updates page.
3. The Services section displays the current version and latest available version of each application service. Some applications may not support upgrading or downgrading whilst the application is currently installed. For those applications, the Change Version and Update buttons remain greyed out even if there are updates available in the application file repository. These applications must first be uninstalled using the Uninstall button before the Change Version and Update buttons become useable. 4. Select one of the following actions: To update an application to the latest version available, click on Update. To update all applications to the latest version available, click on Update All. To change the current version of an application, click on Change Version. Select the version required and click Apply.
Page 63 15-601011 Issue 06g (03 September 2013)
6.13 Uninstalling an Application
The Updates menu can also be used to uninstall an application service. When uninstalled the application is removed from the list of available service unless files for reinstallation are present in the configured file repository.
3. The Services section displays the current version and latest available version of each application service. 4. To uninstall a service, click on Uninstall. If there are installation files for the application available in the application file repository change to become an Install button.
, the button will
If there are no installation files for the application available in the file repository, the application is no longer listed.
Page 64 15-601011 Issue 06g (03 September 2013)
Server Maintenance: Uninstalling an Application
6.14 File Repositories
The Updates 75 and Web Client 88 menus use files stored in the configured file repositories. Each repository can be either a set of files uploaded to the sever or the URL of a remote folder on an HTTP server. You can add files to these repositories without affecting the existing operation of the server. However when the application or operating system repositories contain later versions of the files than those currently installed, a icon is displayed on the Updates menu.
6.14.1 Source Files
Update files may be made available individually in response to particular issues or to support new IP Office releases. The files are also included on the IP Office Application Server DVD. Files can be extracted from a DVD ISO image using an application such as WinZip. Warning Before upgrading or changing the version of any installed application or operating system components, you must ensure that you have read the appropriate Avaya Technical Bulletins for the software release. The Technical Bulletins detail supported versions of software and known issues or additional actions required for upgrading. File Type Application Files Voicemail Pro one-X Portal for IP Office Windows Client Files Operation System Files RPM RPM EXE RPM DVD/ISO Folder \AVAYA\VMPro \AVAYA\ONEX \AVAYA\THICK_CL \CENTOS
Voicemail Pro Each version of the Voicemail Pro server application is split into separate RPM files for the server and each of the prompt languages it supports. Unless advised otherwise, you should upload the full set of files to the file repository.
6.14.2 Setting the Repository Locations
The IP Office Application Server can use either remote or local software repositories to store software update files. Separate repositories are configured for operating system updates, IP Office application installation files and Windows client files.
The files uploaded or present in the file repositories are used by the Updates
and Apps Center
Repository If the Local option is not selected, this field is used to set the URL of a remote HTTP file repository each repository must be different, the same URL must not be used for multiple repositories.
Local This checkbox is used to set whether the file repository used is local (files stored on the IP Office Application Server or remote (a folder on a HTTP web server specified in the Repository field). File / Browse / Add If the Local option is selected, this field and adjacent buttons can be used to browse to a specific update file. When the file is located and selected, click Add to upload the file to the file store on the IP Office Application Server.
Page 65 15-601011 Issue 06g (03 September 2013)
6.14.3 Uploading Local Files
The processes below can be used to upload files to the server if it is being used as a repository for that type of file.
6.14.3.1 Uploading Application Files
6.14.3.2 Uploading Operating System Files
This method uploads the RPM file for an application onto the IP Office Application Server. The files can then be used to update the IP Office applications. The alternative is to use files loaded into a remote software repository 67 . 1. Login
2. Select the Settings menu and then the General sub-menu. 3. Check that the Local checkbox for Operating System is selected. 4. Click on the Browse button and browse to the location of the file file name should now be listed in the File field. 5. Click Add. The server will now start uploading the file. 6. Repeat the process for any other files.
6.14.3.3 Uploading Windows Client Files
2. Select the Settings menu and then the General sub-menu. 3. Check that the Local checkbox for Downloads is selected. 4. Click on the Browse button and browse to the location of the file file name should now be listed in the File field. 5. Click Add. The server will now start uploading the file. 6. Repeat the process for any other files.
Page 66 15-601011 Issue 06g (03 September 2013)
Server Maintenance: File Repositories
6.14.4 Creating Remote Software Repositories
Alternatively to using local files uploaded to the server 62 for updates, the server can be configured to display the versions of files available for use in remote file folders hosted on an HTTP server.
Creating an Application Update Repository
1. Create a folder on the web server for the remote file repository. For example a folder called Applications. 2. If the folder is a sub-folder of the existing web site it will be browseable as part of that website's URL, ie. if the folder is a sub-folder of wwwroot. If the folder is on a separate path, then it must be mapped to the web server URL path, the process for this will depend on the HTTP server being used. 3. The folder directory must be browseable. For example, in IIS right -click on the folder, select Properties and ensure that Directory Browse option is selected. 4. Copy the RPM files from their source
5. From another PC, test that you can browse to the URL of the folder and that the list of files in the folder is displayed. 6. Login to the IP Office Application Server web configuration pages. 7. Select Settings and then General. 8. Uncheck the Local checkbox for Applications. Enter the URL of the HTTP server folder into the preceding field. 9. Click Save. 10.Select Updates. 11.If the server is able to access the HTTP folder, the details of the versions available will now reflect those available in that folder. The message repository error indicates that the IP Office Application Server was not able to connect to the folder or not able to list the files in the folder.
Creating an Windows Client Repository
The process is the similar to that shown above for application RPM files. However a separate folder on the HTTP server must be used and the files placed in it are the EXE files used for installing the Windows applications.
Creating an Operating System Repository
The repository for operating system updates is different from those used for application updates and downloads. It must be a YUM repository, details of how to setup and configure a YUM repository will depend on the version of Linux being used on the HTTP server. Each time an RPM file is added, deleted or changed, the directory must be updated using the createrepo <folder_path> command. In order to host the repository on a Windows web server, the folder must be setup and maintained on a Linux server where the createrepo command can be used and the folder then copied to the Windows server.
Page 67 15-601011 Issue 06g (03 September 2013)
Chapter 7. Server Menus
Page 69 15-601011 Issue 06g (03 September 2013)
The IP Office Application Server web configuration pages are as follows: Home 71 This menu gives an overview of the current status of the applications hosted on the server. Logs 73 This menu has sub-menus for viewing and managing log records and log files. View 73 View the current log files for the server and the application services hosted by the server. Download 74 Create and download archive files of existing log records. Updates 75 Display the versions of applications and components installed and the alternate versions available. Settings 78 This menu has sub-menus for various areas of server configuration and operation. General 79 General server settings such as the locations of software update repositories. System 83 View and manage the server setting for date, time and IP address details. Apps Center 88 This page can be used to download the installation packages for Windows applications such as the Voicemail Pro client application.
Page 70 15-601011 Issue 06g (03 September 2013)
Server Menus:
This menu is accessed by selecting Home. The menu provides an overview of the server status including the status of the application services running on the server.
Services This table lists the services being supported by the server. In addition to showing the status of the service, it also contains buttons to start/stop each service and to select whether the service should be automatically started whenever the server is started. Clicking on the link for Mem/CPU usage will display a summary graph of CPU and memory usage by the application. Notifications This table gives a summary of the most recent log messages generated by the services running on the IP Office Application Server. More detailed information is available through the Logs 73 page. System This table gives a general overview of the sever status. This section also provides controls to shutdown or reboot the server. Note that it may take up to 10 minutes for CPU usage data to appear after a server reboot. OS/Kernel: The overall version of the CentOS operating system installed on the server and the version of the operating system kernel. Up Time: This field shows the system running time since the last server start. Server Time: This field shows the current time on the server. Average CPU Load: This field shows the average CPU load (percentage use) for the preceding minute, 5 minute and 15 minute periods. Last Successful Logon: This field shows the date and time of the last successful logon, including the current logon. Unsuccessful Logon Attempts: This field shows a count of unsuccessful logon attempts.
Page 71 15-601011 Issue 06g (03 September 2013)
Shutdown Selecting this button will start a process that will stop all the application services and then shutdown IP Office Application Server. This process should be used when it is necessary to switch off the IP Office Application Server for any period. Once the process has been completed, power to the server can be switched off. To restart the server, switch the server power back on. Reboot Selecting this button will start a process that will stop all the application services and then stop and restart the IP Office Application Server and services. Note that this stops all services. To stop and restart individual application services, use the buttons shown for each service in the Services panel above.
Page 72 15-601011 Issue 06g (03 September 2013)
Server Menus: Home
This menu is accessed by selecting Logs. The menu is divided into two sub-menus: View 73 View the current log files for the server and the application services hosted by the server. Download 74 Create and download archive files of existing log records.
7.2.1 View
This menu is accessed by selecting Logs and then clicking on the View tab. This menu can be used to view application logs and audit log records.
Application Log This table lists the log records for a selected server application supported by the IP Office Application Server. The Application drop-down is used to select which records are shown. Clicking on a column header sorts the records using that column. The records shown are all those generated since the last time the log files were archived using the Create Archive command on the Logs | Download 74 page. For Voicemail Pro the level of log information output is set through the Debug section of the Settings | General 79 menu. For one-X Portal for IP Office the level of log information output is set through the applications own administration menus, not through the IP Office Application Server menus. Audit Log This table lists the actions performed by users logged in through the IP Office Application Server's web browser interface. Clicking on a column header sorts the records using that column.
Page 73 15-601011 Issue 06g (03 September 2013)
This menu is accessed by selecting Logs and then clicking on the Download tab. This menu is used to create, manage and download archives of previous log files. The log files are compressed into an archive file which can then be downloaded by clicking on the link. The archive files are in .tar.gz format. The log files within this type of archive file can be extracted by a range of utility applications including WinZip.
To Create Archive Files
1. Click on the Create Archive button. Any log records recorded since the last creation of an archive are placed into archive files for each service. 2. The new archive files are listed in the web page.
To Download Archive Files
1. Any archive file can be downloaded by clicking on the file name of the archive file. 2. The process for the download and the location to which the file is downloaded will depend on the browser being used.
To Delete Archive Files
1. To delete an archive, select the Delete checkbox next to the archive file in the list. To select all the archive files click on Select All. 2. To delete the selected files, click on Delete Selected.
Page 74 15-601011 Issue 06g (03 September 2013)
Server Menus: Logs
This menu is accessed by selecting Updates. The menu displays the different versions of server operating system files and application files available in the file repositories. The file repository locations are configured through the Settings | General 79 page. Warning Before upgrading or changing the version of any installed application or operating system components, you must ensure that you have read the appropriate Avaya Technical Bulletins for the software release. The Technical Bulletins detail supported versions of software and known issues or additional actions required for upgrading.
The menu is divided into 2 sections: Services 76 This section displays the current version of application files and whether update files are available. System 77 This section displays the current version of the operating system and whether update files are available.
Page 75 15-601011 Issue 06g (03 September 2013)
7.3.1 Services
This menu is accessed by selecting Updates. The Services section shows details of the current version of each application installed and the latest version available.
The Change Version, Update and Update All buttons in the panel are not useable unless appropriate update files are available in the applications software repository 65 . This also affects the availability of the Install button option. Change Version Clicking on this button shows the update files available for the related application in the server's file repository 65 . The current version is selected. Selecting another version and then clicking Apply will upgrade or downgrade to the selected version.
Update Clicking on this button will start an update of the related application to the latest available version in the application file repository 65 . Uninstall Clicking on this button will uninstall the selected application. If there are installation files for the application available in the application file repository change to become an Install button.
If there are no installation files for the application available in the file repository, the application is no longer listed. Install This button is displayed if an application is uninstalled and update files for the application are available in the file repository. Check Now Clicking this button makes the IP Office Application Server recheck the version of update files available in the file repository. Normally it does this automatically when the Updates page is loaded. Update All If this button is clicked, those applications that support upgrading without being uninstalled (see above) are updated to the latest versions available in the application file repository.
Page 76 15-601011 Issue 06g (03 September 2013)
Server Menus: Updates
This menu is accessed by selecting Updates. The System section shows details of the operating system and whether there are updates available.
Check Now Clicking this button makes the IP Office Application Server recheck the version of update files available in the file repository. Normally it does this automatically when the Updates page is loaded. Review updates Clicking this button will display a list of the available update files. This list allows selection of which updates you want to install.
Update All Clicking this button will install all the available updates without going through the process of selecting with updates to install.
Page 77 15-601011 Issue 06g (03 September 2013)
This menu is accessed by selecting Setting. The menu has two tabs for various areas of server configuration and operation. General 79 General server settings such as the locations of software update repositories. System 83 View and manage the server setting for date, time and IP address details.
Page 78 15-601011 Issue 06g (03 September 2013)
Server Menus: Settings
This menu is accessed by selecting Settings and then clicking on the General tab. This menu is used for a wide variety of server settings.
Page 79 15-601011 Issue 06g (03 September 2013)
Log files age (days) Sets the number of days that log file records are retained. This does not affect log file archives one-X Portal for IP Office which performs its own log file size limitation.
. Not applied to
Note that changing any of these settings will require you to login again. Application Port Change the port used for logging in. The default is 7070. If you change this value you must ensure that you do not set it to a value already used by another service or application. Protocol Select the protocol used for connection. The default is http. The options are http or https. Inactivity Timeout Select the period of inactivity after which the web session is automatically logged out. Changing this value requires you to login again. The options are 5 minutes, 10 minutes, 30 minutes and 1 hour.
The IP Office Application Server can send SNMP event trap information to a specified SNMP server. Protocol Sets the protocol, TCP or UDP, to be used for the SNMP messages. Traps IP Sets the target IP address for the SNMP messages. Traps Port Sets the target port for the SNMP messages. Device ID Sets the device ID to be used in the SNMP messages System Description Sets the system description value included in SNMP messages. System Location Sets the system location value included in SNMP messages. Enable SNMP This option must be selected to enable SNMP.
Page 80 15-601011 Issue 06g (03 September 2013)
This section can be used to set the debug logging level used by certain applications. For the one-X Portal for IP Office the logging level is set through the applications own web administration menus. Log files are retrievable through the Logs | Download 74 menu. Debug Level This control is used to set the level of information that the voicemail service includes in its log files. The options are None, Critical, Error, Warning, Information and Verbose. The default level is Critical.
These controls allow you to backup and restore the application settings being used selected IP Office applications. Voicemail Pro Server For the Voicemail Pro server, these controls can only be used to restore an existing backup. Using the Voicemail Pro client, the voicemail server can be configured to perform regular (daily, weekly and or monthly) automatic backups of selected options including messages and prompts. The Voicemail Pro client can also be used to perform an immediate backup. When the Restore button is selected, the backups available in the backup folder (/opt/ vmpro/Backup/Scheduled) are listed. The backup name includes the date and time and whether the backup was a manual or scheduled backup. When the required backup is selected, clicking OK will start the restoration process. For details refer to the Voicemail Pro client help. one-X Portal for IP Office one-X Portal for IP Office has its own method of backup and restore that can be access through the one-X Portal for IP Offices web client administration.
Page 81 15-601011 Issue 06g (03 September 2013)
Page 82 15-601011 Issue 06g (03 September 2013)
This menu is accessed by selecting Settings and then clicking on the System tab. This menu is used to adjust server settings such as its IP address settings and time settings.
Page 83 15-601011 Issue 06g (03 September 2013)
Network Interface This drop down allows selection of which network interface is currently being configured by the web form. Within the IP Office configuration, Eth0 matches LAN1, Eth1 matches LAN2. On the pre-built IP Office Application Server only Eth0 is used. This port is labeled as port 1 on the physical server. Host Name Sets the host name that the IP Office Application Server should use. This setting requires the local network to support a DNS server. Do not use localhost. Use DHCP If selected, the server obtains its IP address, subnet mask and default gateway settings by making DHCP requests. The related fields show the values obtained in response to the DHCP request. IP Address Displays the IP address set for the server. Subnet Mask Displays the subnet mask applied to the IP address. Default Gateway Displays the default gateway settings for routing. System DNS Enter the address of the primary DNS server. The server greys out this option if it obtains the address of the DNS server from a DHCP server (see below). Automatically obtain DNS from provider This setting is only useable if Use DHCP is also selected. If selected, the server attempts to obtain DNS server details from the DHCP server.
Page 84 15-601011 Issue 06g (03 September 2013)
These settings are used to set or obtain a UTC date and time value for use by the IP Office Application Server and services. Date Shows the current date being used by the server. If Enable Network Time Protocol is selected, this is the date obtained from the NTP server and cannot be manually changed. Time Shows the current UTC time being used by the server. If Enable Network Time Protocol is selected, this is the time obtained from the NTP server and cannot be manually changed. The current time being used by the server is shown on the Home 71 menu. Timezone In some instances the time displayed or used by a function needs to be the local time rather than UTC time. The Timezone field is used to determine the appropriate offset that should be applied to the UTC time above. Note that changing the timezone can cause a Session expired message to appear in the browser. Enable Network Time Protocol If this option is selected, the IP Office Application Server will attempt to obtain the current UTC time from the NTP servers listed in the NTP Servers list below. It will then use that time and make regular NTP requests to update the date and time. The following options are only used if Enable Network Time Protocol is selected. NTP Servers This field is used to enter the IP address of an NTP server or servers which should be used when Enable Network Time Protocol is selected. Enter each address as a separate line. The network administrator or ISP may have an NTP server for this purpose. A list of publicly accessible NTP servers is available at http://support.ntp.org/bin/view/Servers/WebHome, however it is your responsibility to make sure you are aware of the usage policy for any servers you choose. Choosing several unrelated NTP servers is recommended in case one of the servers you are using becomes unreachable or its clock is unreliable. The operating system uses the responses it receives from the servers to determine which are reliable. The IP Office system can also use NTP to obtain its system time. Using the same servers for the IP Office Application Server and IP Office system is recommended. Synchronize system clock before starting service When using NTP, the time obtained by the operating system is used to gradually change the server's hardware clock time. If this option is selected, an immediate update of the server's clock to match the NTP obtained time is forced. Use local time source When using NTP, the time obtained by the operating system is used to gradually change the server's hardware clock time. If this option is selected, the server's hardware clock time is used as the current time rather than the NTP time.
Page 85 15-601011 Issue 06g (03 September 2013)
Password Rules Settings
Minimum password length This field set the minimum length of new passwords. Note that the combined requirements of the fields below for particular character types may create a requirement that exceed this value. Note also that the maximum password length is 31 characters. Minimum number of uppercase characters This field sets the number of uppercase alphabetic characters that new passwords must contain. Minimum number of lowercase characters This field sets the number of lowercase alphabetic characters that new passwords must contain. Minimum number of numeric characters This field sets the number of numeric characters that new passwords must contain. Minimum number of special characters This field sets the number of non-alphanumeric characters that new passwords must contain. Allow character sequences If this option is selected, character sequences such as 1234 or 1111 or abcd, are allowed in new passwords without any restriction. When not selected, the maximum length of any sequence is set by the field below. Maximum allowed sequence length This field is used to set the maximum allowed length of any character sequence when Allow character sequences is not selected.
New Password Enter the new password for the server's root account. Confirm New Password Confirm the new password.
Page 86 15-601011 Issue 06g (03 September 2013)
Page 87 15-601011 Issue 06g (03 September 2013)
7.5 Apps Center
This menu is accessed by selecting Apps Center. The menu is used to download files for use on the local PC. For example, the Voicemail Pro client used to administer the Voicemail Pro server application. The file repository location is configured through the Settings | General
The files included in the installation may vary. Typical files are listed below. Note that some packages require the addition of licenses to the system and configuration changes. Refer to the specific installation manuals for those applications: VmPro...ClientOnlyEXE This is the installation package for the Voicemail Pro client application used to administer the Voicemail Pro server application. VmPro...MapiEXE This is the installation package for the MAPI proxy. This can be installed on a Windows PC in the same network as the Windows Exchange server. It allows the Linux based Voicemail Pro server to access UMS services. Refer to the Voicemail Pro installation manual.
Page 88 15-601011 Issue 06g (03 September 2013)
Server Menus: Apps Center
This menu allows the user to log in to remotely to the Linux graphical desktop. Note: Wireshark To run Wireshark from the VNC desktop, login to the desktop using the root user account.
This menu is used to start and stop the VNC service supported on the server.
This menu is used to connect to and display the desktop using VNC.
Once the password is accepted, the operating system desktop is displayed.
Page 89 15-601011 Issue 06g (03 September 2013)
Page 90 15-601011 Issue 06g (03 September 2013)
Chapter 8. Additional Processes
Page 91 15-601011 Issue 06g (03 September 2013)
This section details processes that are not normally required but may be useful. These should only be attempted if you are confident with Linux commands and managing a Linux based system.
Changing the Root Password SSH File Transfers
Windows to Linux Voicemail Transfer
Page 92 15-601011 Issue 06g (03 September 2013)
8.1 Changing the Root Password
Page 93 15-601011 Issue 06g (03 September 2013)
8.2 SSH File Transfers
The directory structure of files on the server can be accessed using any file transfer tool that supports SFTP/SSH. For example WS_FTP or SSH Secure Shell.
1. Start your SFTP or SSH file application and connect to the IP Office Application Server PC. The exact method will depend on the application being used. a. Enter the details for the IP Office Application Server: The Host Name is the IP address of the IP Office Application Server. The User Name is webcontrol. The Protocol is SFTP/SSH. The Port is 22. If this is the first time the application has connected to the server, accept the trusted key. b. If this is the first time the application has connected to the IP Office Application Server, accept the trusted key. c. When prompted, enter the webcontrol user password
2. The default folder displayed after logging in is /home/webcontrol.
Page 94 15-601011 Issue 06g (03 September 2013)
Additional Processes: SSH File Transfers
8.3 Windows to Linux Voicemail Transfer
You can transfer a set of Voicemail Pro backup files from a Windows based voicemail server to a Linux based voicemail server. 1. On the Windows voicemail server: a. Using the Voicemail Pro client, perform an immediate backup on the Windows voicemail server, selecting to backup all types of file. b. This will create a backup folder, the name of which includes the date and time of the backup and Immediate. For example VMPro_Backup_26012011124108_Immediate. The default path for such folders is C: \Program Files\Avaya\IP Office\Voicemail Pro\Backup\Scheduled. c. Within Windows, locate the folder just created by the backup and copy the folder to the PC with your SSH file transfer tool. 2. Connect to the server using a SSH File transfer tool
3. Copy the Windows backup folder into the folder /opt/vmpro/Backup/Scheduled/OtherBackups. 4. Using a web browser, login 5. Select Settings. 6. On the General tab, select the Restore button for the Voicemail service. From the list of available backups, select the one just copied onto the server. 7. Click OK.
to the IP Office Application Server.
If you do not allow remote SSH access to the server, files can be transferred from the CD/DVD drive. This requires the contents of the CD or DVD to be mounted as part of the folder structure. 1. Create a CD or DVD with the Windows backup folder on it. 2. Login on the server as the root user. 3. Enter eject -n. 4. The response will be something like eject: device is '/dev/hda'. 5. Enter mount /dev/hda/mnt/cdrom. 6. The contents of the drive are now accessible as part of the file structure in the folder /mnt/cdrom. 7. Copy the backup folder from /mnt/cdrom to /opt/vmpro/Backup/Scheduled/OtherBackups. For example: cp -a -f /mnt/cdrom/VMPro_Backup_26012011124108_Immediate /opt/vmpro/Backup/Scheduled/ OtherBackups 8. The backup can now be restored using the web client.
Page 95 15-601011 Issue 06g (03 September 2013)
Address DNS 28, 59, 83 IP 28, 59, 83 Administrator Login 44 Application Install 62 Uninstall 64 Upgrade 62 Application Logs 73 Applications 9 Archive 74 Audit Log 73
IP Address 28, 34, 59, 83 IP Office Check 44 Select 44
Licenses 14 Linux 11, 12 Local 79 Log Files Age 79 Logging In 22, 53 Login 36 Administrator 44 Logs 73 Application 73 Archive 74 Audit 73 Download 74 Log Files Age 79
Backup 79, 95
Capacity 9 CentOS 12 Compatibility 11 Change IP Address 28, 59 Change Password Root Password 93 Web Browser Password Clients 88 Compatibility 11 Configuration one-X Portal for IP Office Voicemail Pro 32 CPU Usage 71 Create Archive 74
Mask 28, 59, 83 Memory 11 Usage 71 Menu Download 74 General 79 Home 71 Logs 73 Logs Download 74 Logs View 73 Services 76 Settings 78 System 77, 83 Updates 75 Updates Services 76 Updates System 77 View 73 Windows Clients 88 Module Restart 58 Shutdown 58
Date 60, 83 Default Gateway 28, 59, 83 Password 22, 27, 53 DHCP 28, 59, 83 Disk Usage 71 Disk Space 11 DNS 28, 59, 83 Documentation 12 Download Logs 74 Windows Clients 88 DVD Drive 11
Network 13 Network Time Protocol 60, 83 no Remote 36 Notifications 71 NTP 60, 83
one-X Portal for IP Office Configuration 44 Operating System 11
Gateway 28, 59, 83 General 79
Passwd 93 Password Change 44 Root Password 93 Web Browser Password PC Requirements 11 Port Web Control 79 Preferred Edition 14, 33 Processor 11
Hard Disk 11 Headless 11 Home 71 Host Name 28, 59, 83
Initial configuration 44 Install Application 62 IP Office Application Server Service 62
18 RAM 11 Usage 71 Page 97 15-601011 Issue 06g (03 September 2013)
Reboot 58, 71 Remote Software Repositories 67 Repositories 67 Repository 79 Requirements 11 Restart 58 Restore 79, 95
SCN 13 Server NTP 60, 83 Reboot 58, 71 Shutdown 58, 71 Server Name 36 Service Install 62 Uninstall 64 Upgrade 62 Services 9, 76 Start 71 Starting 57 Status 71 Stop 71 Stopping 57 Settings 78 SFTP 94 Shutdown 58, 71 Small Community Network 13 SNMP 79 SNMP Support 79 Software 36 Repositories 67 Software Repositories 79 Specification 11 SSH access 94 Start 58 Start Services 71 Status 71 Stop Services 71 Subnet Mask 28, 59, 83 System 77, 83
Voicemail features 14 Voicemail IP Address 34 Voicemail Pro Configuration 32 Limitations 14 Voicemail Pro Client run 36 Voicemail Pro Client window 36 Voicemail Pro Login window 36 Voicemail Pro Server connect 36 Voicemail Type 34
WAN 36 Watchdog 79 Web Control Port 79 Windows 95 Windows Clients 88 Workstation 36
Technical Bulletins 12 Time Timezone 60, 83
Uninstall Application 64 Service 64 Unit Name/IP Address 36 Update Services 76 System 77 Updates Services 75 System 75 Upgrading Applications 62 Usage CPU 71 Disk 71 Memory 71 Using Linux 12
View Logs 73 Voicemail 95 IP Office Application Server Installation and Maintenance IP Office 8.1 Page 98 15-601011 Issue 06g (03 September 2013)
Page 99 15-601011 Issue 06g (03 September 2013)
Template: 29th August 2013
Performance figures and data quoted in this document are typical, and must be specifically confirmed in writing by Avaya before they become applicable to any particular order or contract. The company reserves the right to make alterations or amendments to the detailed specifications at its discretion. The publication of information in this document does not imply freedom from patent or other protective rights of Avaya or others. All trademarks identified by the or are registered trademarks or trademarks, respectively, of Avaya Inc. All other trademarks are the property of their respective owners. This document contains proprietary information of Avaya and is not to be disclosed or used except in accordance with applicable agreements. 2013 Avaya Inc. All rights reserved.
IP Office Application Server Installation and Maintenance IP Office 8.1 Page 100 15-601011 Issue 06g (03 September 2013)
Documents Similar To IP Office App Server Install and Mainten 8.1
Ivica Milic
More From francovilla75
6.76C2FC45d01
pcf-dev-1.6.b.RELEASE-student-handout.pdf
Josei Av
ZOC SSH Features
Implementing IEEE 802.1ah Provider Backbone Bridje