TC2543en-Ed02 Generic Appliance ServerInstallation

Technical Bulletin OmniPCX Enterprise
TC2543 ed.01 Release 12.2 and above
Generic Appliance Server Installation
This document provides the configuration details required to install an OmniPCX® Enterprise on a Generic Appliance
Server.
Revision History
Edition 1: January 8, 2019 creation of the document
Edition 2: May 27, 2019 update of the document
Legal notice:
The Alcatel-Lucent name and logo are trademarks of Nokia used under license by ALE. To view other trademarks used by
affiliated companies of ALE Holding, visit: www.al-enterprise.com/en/legal/trademarks-copyright. All other trademarks are the
property of their respective owners. The information presented is subject to change without notice. Neither ALE Holding nor any
of its affiliates assumes any responsibility for inaccuracies contained herein. © 2019 ALE International. All rights reserved.
www.al-enterprise.com
Table of contents
1 Preamble ................................................................................................................................................ 3
2 Useful documents ................................................................................................................................... 3
3 Installation procedure.............................................................................................................................. 3
3.1 Collecting the required information .................................................................................................. 3
3.2 Verifying BIOS configuration .............................................................................................................. 4
3.2.1 Lenovo x3250 M6 ....................................................................................................................... 4
3.2.2 HP DL20 Gen9 ............................................................................................................................ 4
3.3 Verifying hardware, “.iso” file and licenses ....................................................................................... 6
3.4 Installing SUSE Linux Enterprise Server on the host server .................................................................. 6
3.5 Getting the ALUID and posting it to eLP ............................................................................................. 9
3.6 Installing the Generic Appliance Server ........................................................................................... 10
3.6.1 Process overview ...................................................................................................................... 10
3.6.2 Pre-Installation procedure ......................................................................................................... 11
3.6.3 Post-installation procedure ........................................................................................................ 12
4 Update of the security patch .................................................................................................................. 23
5 Miscellaneous........................................................................................................................................ 23
5.1 Ethernet redundancy (bounding) ..................................................................................................... 23

5.2 VLAN tagging on SUSE OS ............................................................................................................... 23
6 Troubleshooting .................................................................................................................................... 23
6.1 Commands ..................................................................................................................................... 23
6.2 FlexLM license file ........................................................................................................................... 24
6.2.1 Installation ............................................................................................................................... 24
6.2.2 Status ...................................................................................................................................... 24
6.3 Rehosting ....................................................................................................................................... 24
OmniPCX Enterprise - Release 12.2 and above

Generic Appliance Server Installation TC2543 ed.01
Copyright © ALE International 2019 page 2/26
1 Preamble
This document is a quick guide about the installation of Generic Appliance Server (GAS) without S.O.T
(Software Orchestration Tool).
For GAS installation with S.O.T, refer to the S.O.T documentation.
The “GAS” is a dedicated hardware with:

 1 OXE Virtual Machine
 0 or 1 OMS Virtual Machine
 A Flex-LM server runs directly on the Host OS (SUSE Linux Enterprise Server (SLES))
Please note the GAS iso file (oxesws_x.yy.iso) you download from the BPWS may not install the right OXE
patch. Therefore, a patch installation of OXE may be needed after completing this procedure.
More information can always be found in the OXE documentation.
2 Useful documents
The following documents are available on the business portal website:
 System documentation: “OXE System: Appliance Server Installation Manual”
 Presales document: TBE063 OmniPCX Enterprise & Generic Appliance Server
o Contains hardware prerequisites
3 Installation procedure
To begin, the server must be connected to the network with its ethernet port. Default gateway must be
accessible.
3.1 Collecting the required information

Installation requires:
 The IP address of the host server
 The FQDN of the host server
 The subnet mask of the host server
 The IP address of the default gateway (this IP MUST be accessible during installation)
 The IP address of the DNS server (the GAS IP address may be used if the customer doesn’t want to
configure a DNS server)
 The IP addresses of the OmniPCX Enterprise Call Server(s)
 The IP address of the OXE-MS (optional)

3.2 Verifying BIOS configuration
The virtualization option must be enabled independently of the type/brand server:
1. At server initialization, Press F9 to enter BIOS configuration
2. Navigate to: System Options > Processor Options
3. Validate the Intel Virtualization Technology option
Verify that the boot sequence is configured to start on the DVD drive.
Refer to the server manufacturer documentation on BIOS configuration.
3.2.1 Lenovo x3250 M6
To run on a Lenovo x3250 M6 server, the GAS requires BIOS modification.

Check and/or modify the following parameters:
1. At server initialization, press F9 to enter BIOS configuration

2. Navigate to: Boot Manager > Boot Modes
3. Set the System Boot Mode option to Legacy Mode
3.2.2 HP DL20 Gen9
To run on a HP DL20 G9 server, the OmniPCX Enterprise requires several BIOS modifications.
Check and/or modify the following parameters:
1. At server initialization, press F9 to enter BIOS configuration

2. Navigate to: System Options > Boot Options

3. Set the Boot Mode option to Legacy BIOS Mode
4. Navigate to: System Options > USB Options
5. Set the USB Boot Support option to Disabled

6. Navigate to: System Options > SATA Controller Options
7. Set the Embedded SATA Configuration option to Enable SATA AHCI Support

8. Navigate to: Service availability
9. Set the Automatic Power-on option to Always Power On
3.3 Verifying hardware, “.iso” file and licenses

• The .iso files which correspond to the applications to install:
Component File name (*.iso)

SLES Operating System bootdvd.x.x.xxx.xxx.x86_64.iso
Generic Appliance Server oxesws_x.yy.iso containing the following files:

• oxeswspreinst.bin (pre-Installation setup)
• oxeswsposinst.bin (post-Installation setup)
• systemcompatibilitycheck.sh
3.4 Installing SUSE Linux Enterprise Server on the host server

The SLES operating system is customized by ALE International specifically for the Generic Appliance Server.
The SLES OS is installed on the host using the AutoYaST configuration file. It contains installation data, such
as language, login, password, packages to install, and partitioning.
To install SLES on the host server:
1. Load the "ALE boot DVD" in the drive (note: this DVD can also be used to install othe ALE products)
After a few seconds, a welcome page is displayed:

Note:
If the server does not boot on the DVD drive, change boot order in the server BIOS.
2. Press F2 to select your language and your keyboard type

3. Scroll down the list of installation options and select OmniPCX Enterprise
4. Scroll down the list of installation options and select Software Package

Installation takes about 30 minutes and erases all the content of the disk.
All actions are performed automatically and the different pop-up windows indicate the installation progression.
5. As soon as the server reboots, press the eject button on the DVD drive and remove the DVD
6. Request for password change is prompted and needs to be changed:

 The default account is root
 The default password is letacla1
Do not forget your new password, it will be important later
7. Configure network details for the server:
 The IP address of the host server
 The FQDN of the host server (concatenation of host name and domain name)
 The subnet mask of the host server
 The IP address of the default gateway
 The IP address of the DNS server
You are prompted to confirm your entries.

8. To confirm write “Yes”
3.5 Getting the ALUID and posting it to eLP
The ALUID is necessary to obtain license files to install or replace a Generic Appliance Server. If you ordered
machines, the ALUID is displayed on the hardware sticker. The Generic Appliance Server is delivered without a
sticker.
After OS installation:
1. After OS installation, click on “not listed” and log in with your root account
Username : root / password : the one you have changed previously
According to the type of keyboard, it is possible to choose the language keyboard at the top right or to make
appear a virtual keyboard.

Note
GUI can be started with the following command: “systemctl start display-manager”
2. Open a terminal (right-click on the desktop)

3. Enter the command /usr/bin/getaluid to retrieve the ALUID
4. Send your ALUID to Actis (see the eLicensing Host Registration page of the Enterprise Business Portal)
After your request is processed, you receive the necessary license files, bearing the extension *.swk and *.ice
3.6 Installing the Generic Appliance Server
3.6.1 Process overview

Installation of the Generic Appliance Server on the host operating system can be performed in any of the
following ways:
 From the hard disk (file copied via an SFTP connection) or USB key (.iso file)
 From the DVD (not detailed after)
Note The key plugged on a USB port must be in FAT32 format.
The pre-installation can be performed either from a Graphical User Interface (GUI), or from console in silent
mode. This section describes only the installation in silent mode.

The post-installation of the Generic Appliance Server Installer can be performed only from GUI. There is no
option for the silent installation.
The following operations are performed during the pre-installation procedure:

 Compatibility check of hardware (free space availability, processor virtualization support)
 Compatibility check of host OS (version of OS, KVM support)
 Copy of mandatory files (Virtual Machine images, scripts) to the host
 Installation of Flex-LM server on host OS
 Creation of networking bridge (br0) in the host OS to facilitate VM access the network outside
The following operations are performed during the post-installation procedure:

 Network configuration
 Creation of one VM for the OmniPCX Enterprise and, optionally, one VM for OXE-MS with their
corresponding images
 Transfer of license files to the OmniPCX Enterprise VM
3.6.2 Pre-Installation procedure
To perform the pre-installation of Generic Appliance Server Installer package:
1. Open a session on the server console (root)

2. Insert the external media containing the .iso file (USB key on a server port) or copy it via sftp
The USB key is automatically mounted in /run/media/root/
Start the graphical interface, using the command (if you don’t have graphical interface):
“systemctl start display-manager”
3. Open a terminal session: Applications > Utilities > XTerm
4. Extract from the iso the files, enter the command (or use the GUI):
 mkdir /root/Desktop/GASiso
 mount -o loop /<directory of iso>/oxe_sws-5.04.iso /root/Desktop/GASiso/
 mkdir /root/Desktop/GASinstallfiles
 cp -r /root/Desktop/GASiso/ /root/Desktop/GASinstallfiles/
 umount /<directory of iso>/oxe_sws-5.04.iso
 rm /root/Desktop/GASiso/
5. Enter the /root/Desktop/GASinstallfiles/GASiso/checksystemcompatibility.sh command to check your

system and fix the reported issues (if any)
6. Check that no error is logged in the file:

 /var/log/OXEMS/InstallLog/checkingsystem.log

7. Locate the oxeswspreinst.bin file and give executable rights to this file, using the commands:
 cd /root/Desktop/GASinstallfiles/GASiso/
 chmod +x oxeswspreinst.bin
8. Start installation, using the command: ./oxeswspreinst.bin -i Silent
During installation:
 The OmniPCX Enterprise and OXE-MS image files are extracted and copied in:
/home/OmniPCXEnterpriseSoftwareServer/Installation_Folder/imgs
 Configuration files and scripts are extracted and copied in:
/home/OmniPCXEnterpriseSoftwareServer/Installation_Folder/scripts
 The Flex-LM server is installed on the host

The Installation takes about 15 minutes to 25 minutes.
No installation status message (success/failure) is displayed for silent installation. The cursor is positioned to
an empty prompt at the end of the pre-installation. You can verify the pre-installation status (PRE-
INSTALLATION STATUS: SUCCESS/FAILED) from the file /etc/sws_preinstall.inf
3.6.3 Post-installation procedure

To perform the post-installation:
1. Locate the oxeswsposinst.bin file and give executable rights to this file, using the command:
chmod +x oxeswsposinst.bin
2. Execute the command: ./oxeswsposinst.bin
3. Once the welcome message shows, click the Next button

4. In the local settings page, select your country code (for OmniPCX Enterprise database and time zone)
5. Click Next
The network settings page is displayed:
6. Configure the OmniPCX Enterprise with its node related information details (netadmin details)
 If the OmniPCX Enterprise is not duplicated:
1. Select the No Redundancy radio button in the OXE IP Configuration
2. Enter the parameters in the Configuration Details
For more information about the OmniPCX Enterprise parameters, refer to the system documentation.

OmniPCX Enterprise wizard page example
 If the OmniPCX Enterprise is configured as Local redundancy:

1. Select the Local Redundancy radio button in the OXE IP Configuration
2. Enter the parameters in the Configuration Details.
Note:
Twin CPU configuration must be managed whatever the state of twin CPU.

 If the OmniPCX Enterprise is configured as Spatial redundancy:
1. Select the Spatial Redundancy radio button in the OXE IP Configuration
2. Enter the parameters in the Configuration Details.
7. Click the Next button and configure OXE-MS network settings.

IP address must be entered in the corresponding text box. Otherwise the Next button is not activated. Enter
an IP address in the correct format:
 Select 0 or 1 OXE-MS
 Enter network settings: for OMS1 Details enter the IP address of the OXE-MS VM
 Click the Next button to provide the OXE License details
8. Several cases are possible for licenses:

1. If license files .zip, .swk, .hw, hardware.mao,.k2 or .ice are available in the path
/opt/sws_lic, the following screen will be displayed:

2. Otherwise if the files .zip, .swk, .hw, hardware.mao are found and neither .k2 nor .ice found in the
path /opt/sws_lic, a warning will be displayed as shown in below screen but it allows the user to
proceed the installation without .k2 or .ice.

Press Next to proceed.
3. If any of the License files is missing in the target machine (/opt/sws_lic), below screen will be
displayed. In that case, user have two choices:
 Choice #1 Click the Skip button if you wish to manually provide license files after the post-install
process.
 Choice #2 Provide license files in a USB dongle, placed in a single directory sws_lic.
 Plug the USB key on your SUSE Linux Server.
 Wait for a few seconds then click Browse button to continue.
The following pop-up appears, displaying root directory of the key:

Select the directory containing the license files and click “Open”.
1. If all files (.swk, hardware.mao, .zip, .hw, .k2 or .ice) are found in the selected
directory, a success message “OK” is displayed for each file and Next button is enabled. Clicking
Next button reaches “Post-installation Summary” screen.

2. If the files .zip, .swk, hardware.mao and .hw are found and neither .k2 nor .ice found a warning
will be displayed as shown in below screen and allows the user to proceed the installation
without .k2 or .ice.
3. If some files are missing, an error message “Not OK” is displayed for those files and Next
Button remains disabled. However you will be able to proceed to Post Installation Summary
screen by clicking Skip.
9. Click Next

The Post-installation Summary page is displayed with all the entered settings
10. Check server parameters

If settings are correct, click Install to start configuration. The duration is around 20 minutes.
The following page shows the configuration progress status:

The data captured through the post-installation pages are written into a configuration file. This configuration
file is used to proceed to the following steps through scripts:
 Network Configuration for OXE Call Server:
All the network parameters such as OXE IP, CPU Name, network number, router details are extracted
from configuration file and updated into the Netadmin file to enable network configuration
 Empty database configuration:
An empty database is created as per the country chosen during post installation
 License configuration:
License files .zip, hardware.mao, software.mao, .swk, .ice are placed in the OXE directory
/usr4/BACKUP/OPS for future installation
The .ice file is placed in the directory /opt/Alcatel-Lucent/data/licenses/ on the Suse OS for FlexLM
server usage
 Network Configuration for OXE-MS:
Network parameter of OXE-MS, such as OXE-MS IP, CS IP and subnet mask are updated in the oms.cfg
file to enable network configuration in OXE-MS
After successful configuration, the OmniPCX Enterprise starts along with the OXE-MS.
11. At the end of the post-installation, check the installation status displayed in the Install Complete page:
 In case of success, click the Done button
 In case of failure, the corresponding error message with the information of log file displays, see Un-
installation procedure in the system documentation
12. Once installation is complete, you can verify the versions of Generic Appliance Server, patches, OXE-MS
and FlexLM server from the sws_release file available in the /etc/ path

13. Configure the OXE VM and OXE-MS VMs
Connect to the virtual machines in any of the following manners:
 From a Telnet terminal
 From the KVM console:
1. Open a session on the KVM console
2. Start the graphical interface, using the command “systemctl start display-manager”
3. Go to: Applications
4. Click the System Tools icon
5. Select the Virtual Machine Manager icon
The Virtual Machine Manager window opens to access VMs
1. Click on “File -> Add Connection…” then click on Connect.
2. From the VM Manager home page, open one of virtual machines by clicking its name.
4 Update of the security patch

In order to make an update of OS with vulnerability fixes contained in the bootdvd iso file, use following
commands:
 mount /dev/cdrom /media/cdrom
 cd /media/cdrom/scripts
 ./suse-update.sh /media/cdrom
 umount /media/cdrom
 reboot
5 Miscellaneous
5.1 Ethernet redundancy (bounding)
See TKC article 000053068
5.2 VLAN tagging on SUSE OS

See TKC article 000052833
6 Troubleshooting
6.1 Commands
Report to the system documentation chapter 4.3 Maintenance for more information.

 Version of GAS:
cat /root/.bootcd_option_oxesw
 IP Address modification of the server Linux SUSE:

cd /usr/bin
./setIPAddress.sh (Warning: only if no vlan and no bonding)
 you can found OXE logs in this directory:
/home/OmniPCXEnterpriseSoftwareServer/Logs/
6.2 FlexLM license file

6.2.1 Installation
If FlexLM license file (.k2 or .ice) are not selected in the post installation, the file must be copied manually to
/opt/Alcatel-Lucent/data/licenses/
Then restart the service with the command “service flexlmd restart”
6.2.2 Status
Status of flexlm server can be checked with the command “service flexlmd status”
Example of a running service:
Example if no license file is found:
6.3 Rehosting
When the Server has to be changed from one network to another, the server is physically disconnected from
the existing network and connected to the new network. Then the script setIPAddress.sh present at /usr/bin is
run to rehost the server.
Running the script i.e rehosting the server prompts for network details:
 IP Address
 Gateway
 Netmask

 DNS server
 Host Name
Once all the details are entered, the server will be configured to the new network.

Submitting a Service Request
Please connect to our eService Request application.
Before submitting a Service Request, please be sure:

 The application has been certified via the AAPP if a third party application is involved.
 You have read the release notes that list new features, system requirements, restrictions, and more,
and are available in the Technical Documentation Library.
 You have read through the related troubleshooting guides and technical bulletins available in the
Technical Documentation Library.
 You have read through the self-service information on commonly asked support questions and known
issues and workarounds available in the Technical Knowledge Center.
- END OF DOCUMENT -


TC2543en-Ed02 Generic Appliance ServerInstallation

Uploaded by

Copyright:

Available Formats

TC2543en-Ed02 Generic Appliance ServerInstallation

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

TC2543en-Ed02 Generic Appliance ServerInstallation

Uploaded by

Copyright:

Available Formats

Technical Bulletin OmniPCX Enterprise

TC2543 ed.01 Release 12.2 and above

Generic Appliance Server Installation

5.1 Ethernet redundancy (bounding) ..................................................................................................... 23

OmniPCX Enterprise - Release 12.2 and above

The “GAS” is a dedicated hardware with:

More information can always be found in the OXE documentation.

3.1 Collecting the required information

OmniPCX Enterprise - Release 12.2 and above

3.2.1 Lenovo x3250 M6

To run on a Lenovo x3250 M6 server, the GAS requires BIOS modification.

1. At server initialization, press F9 to enter BIOS configuration

3. Set the System Boot Mode option to Legacy Mode

3.2.2 HP DL20 Gen9

1. At server initialization, press F9 to enter BIOS configuration

OmniPCX Enterprise - Release 12.2 and above

5. Set the USB Boot Support option to Disabled

OmniPCX Enterprise - Release 12.2 and above

9. Set the Automatic Power-on option to Always Power On

3.3 Verifying hardware, “.iso” file and licenses

Component File name (*.iso)

Generic Appliance Server oxesws_x.yy.iso containing the following files:

3.4 Installing SUSE Linux Enterprise Server on the host server

After a few seconds, a welcome page is displayed:

OmniPCX Enterprise - Release 12.2 and above

2. Press F2 to select your language and your keyboard type

OmniPCX Enterprise - Release 12.2 and above

6. Request for password change is prompted and needs to be changed:

OmniPCX Enterprise - Release 12.2 and above

3.5 Getting the ALUID and posting it to eLP

OmniPCX Enterprise - Release 12.2 and above

2. Open a terminal (right-click on the desktop)

3.6 Installing the Generic Appliance Server

3.6.1 Process overview

Note The key plugged on a USB port must be in FAT32 format.

OmniPCX Enterprise - Release 12.2 and above

The following operations are performed during the pre-installation procedure:

The following operations are performed during the post-installation procedure:

3.6.2 Pre-Installation procedure

To perform the pre-installation of Generic Appliance Server Installer package:

1. Open a session on the server console (root)

The USB key is automatically mounted in /run/media/root/

3. Open a terminal session: Applications > Utilities > XTerm

5. Enter the /root/Desktop/GASinstallfiles/GASiso/checksystemcompatibility.sh command to check your

6. Check that no error is logged in the file:

OmniPCX Enterprise - Release 12.2 and above

8. Start installation, using the command: ./oxeswspreinst.bin -i Silent

 Configuration files and scripts are extracted and copied in:

 The Flex-LM server is installed on the host

3.6.3 Post-installation procedure

OmniPCX Enterprise - Release 12.2 and above

OmniPCX Enterprise - Release 12.2 and above

 If the OmniPCX Enterprise is configured as Local redundancy:

OmniPCX Enterprise - Release 12.2 and above

7. Click the Next button and configure OXE-MS network settings.

OmniPCX Enterprise - Release 12.2 and above

8. Several cases are possible for licenses:

OmniPCX Enterprise - Release 12.2 and above

OmniPCX Enterprise - Release 12.2 and above