Introduction

This blog post is intended to guide you from the arrival of your bare metal Linux HANA server to a live environment.  The blog will discuss partition configuration, OS installation using the SuSE Wizard, SAP HANA, SAP Business One Server Tools, and SAP Business One Server installation.  The blog will provide commands to use.  The guide is not a Linux how to guide, you can use Google to find a Linux how to guide.  If you have received a HANA appliance server from one of the vendors you can follow the install steps to upgrade to a later release.

The information below can also be found in the installation manuals to come with the product.  The SAP HANA guide is available from https://help.sap.com/hana_platform/#section2.  The SAP Business One guide can be found in ./Documentation/SystemSetup this directory is created when you run the SAP Business One executable; which decompresses the SAP Business One installation files.

Prerequisites

• You have read note 1944415 – Configuration Guide for Hardware Platforms of SUSE Linux Enterprise Server
• You have read the Business One System Setup Guide, the SAP HANA Master Guide, the SAP HANA Client Installation Guide and the SAP HANA Server Installation Guide
• You have received the bare metal server and installed it into the data center.
• You have downloaded the ISO from SuSE and burned it to CD
• You have downloaded the SAP media and copied it to USB, or burned it to CD
  • SAP HANA DB
  • SAP HANA client 32 and 64 bit version
  • SAP Business One
• You have configured the partitions on the Linux server
  • The OS installs to root ‘/’ partition and requires 72 GB of storage
  • You need a SAP HANA data partition that should be at least 3*RAM in size
  • You need a SAP logs partiton that should be at least 1*RAM in size
• You have verified the boot order in the BIOS
  • The system should check the CD before it checks the hard drive
• The target Business One windows host has been prepare the following items need to be installed before you install the Business One Client
  • Crystal reports
  • HANA client 32 and 64 bit+

You can use the steps below to make storage available to the OS.

1. Login as root. su –

2. Find the device name using: fdisk -l

3. Create a mount point. mkdir /mnt/mydrive

4. Mount the drive. Please use the device name you found in step 2 (such as /dev/sdb1). mount /dev/devicename

5. You can navigate to it using cd /mnt/mydrive and list files using ls

Before installing SAP Business One ServerTools and Server, please make sure the following software components are installed properly in HANA server.

libaio

B1H Server installation for SBO-COMMON and Demo DB creation)

libaio

B1H Server installation for SBO-COMMON and Demo DB creation)

libaio

B1H Server installation for SBO-COMMON and Demo DB creation)

 

Here a sample list of prerequisite component by B1H 9.0 PL04, you should refer the latest Administrator guide of SAP Business One, version for SAP HANA for the list.

The SAP Business One prerequisites can be found starting on page 11 of B1_for_SAP_HANA_Admin_Guide.pdf that can be found in the documentation folder that is created when you unzip the files.

Hardware Configuration:

Before SuSE linux installation, please perform the hardware configuration for the linux server with the attached guide about How to Configure Hardware Platforms for SUSE Linux Enterprise Server.zip in note 1944415 – Configuration Guide for Hardware Platforms of SUSE Linux Enterprise Server

Installation

The next section will take you through the 3 main installation tasks: Operating System, SAP HANA, SAP Business One

OS

Please follow instruction in the attached guide about How to Install SUSE Linux Enterprise Server for SAP Business One Products on SAP HANA

in the note 1944415 – Configuration Guide for Hardware Platforms of SUSE Linux Enterprise Server

Please download the SuSE for B1 image (https://www.suse.com/slesb1hana ) and burn it to DVD.  Next, insert the CD, that you created from the image downloaded from SuSE, in the system and power it on.  The SuSE installation wizard will start.

 

At this time the SuSE wizard will allow you to install the OS, create the file system for SAP HANA and install SAP HANA. However, you will have to manually install afterwards SAP HANA and SAP Business One, version for SAP HANA.

The wizard of installation will will prompt the options:

1).Install SuSE Linux Enterprise without creating the file system for SAP HANA and SAP product installation

2).[Recommended] Install SuSE Linux Enterprise and create the file system for SAP HANA without installing SAP HANA and SAP Business One, version for SAP HANA. (You will have to install SAP HANA and B1H by manual)

3).Install SuSE Linux Enterprise, create the file system for SAP HANA and install SAP HANA and SAP Business One, version for SAP HANA. (You will have to provide the installation CD of SAP HANA and B1H afterwards.)

After installing SuSE you should subscribe to SuSE for software download and support service.  Visit https://www.suse.com/products/server/how-to-buy/ for SuSE subscription details.

 

SAP HANA

Make the SAP HANA media available from the OS.  You dothis using one of the following methods:

• Mount network storage where you’ve copied the install files
• Mount USB/CD where you’ve copied the install files
• Use an FTP client to upload the install files from local desktop to Linux server

You may refer to FAQ about SAP HANA, B1A and B1H Installation about how to download and extract the SAP HANA installation CD.

When the files are copied navigate to …/DATA_UNITS/HDB_SERVER_LINUX_X86_64/.

Ensure hdb* files and ./instruntime/sdbrun have execute permission set

• chmod 754 hdb*
• chmod 754 ./instruntime/sdbrun

After setting the proper permissions call ./hdblcmgui for graphical installer or ./hdblcm for console based installer.

 

About hdblcm:

Since HANA 1.0 SP07(Rev 70 onwards), hdblcm installation are introduced to install the all HANA component in the same folder instead of install each component one be one.

“./hdblcm”  :command line installation

“./hdblcmgui”  :[recommended]Graphical installation wizard required to be run in Graphical User Interface.

Prerequisite: To place all the target HANA component installation CD in the same folder

for example:

I would like to install HANA Rev 112.3 with hdblcm tool, just create the following HANA installation CD hierarchy in file system

<> –folder created by manual.

     <> –HANA server installer folder after extraction

     <> –HANA AFL installer folder after extraction

     <> –HANA Client 64 installer, extract it folder name as SAP_HANA_CLIENT, then rename to SAP_HANA_CLIENT_64 to differentiate from the 32 bit HANA client which by default has the same folder name as SAP_HANA_CLIENT.

     <> –As above.

 

Then launch the hdblcm or hdblcmgui in <>

The system will prompt you for the following information:

• System ID: NDB
• Instance number: 00
• Install path:  Use the default (/usr/sap or /hana/shared) if the file system is created with selsb1h image during OS installation.
• Location of data and log volumes: use the partitions you defined prior to installing the OS. The default ones as /hana/data for data, /hana/log for log.
• Password for SYSTEM user: the system user is the SAP HANA DB administrator user.  The password can be anything, the system requires 8 characters, alpha numeric and mixed case
• Password for ndbadm: the ndbadm is the operating system user that is used to manage the SAP HANA DB.  This is the user that is used to start and stop the SAP HANA DB
• Password for sapadm: the sapadm user is used by SAPControl and must be created.

The values shown above are mandatory, using something other than what is shown will prevent a successful installation of SAP Business One.  The installer will show a summary of what you entered.  If the summary matches what you expect click install.  The system will install SAP HANA DB and start it at the end.

If the installation fails because the server does not pass the hardware check please follow the steps in SAP Customer note 1658845

https://service.sap.com/sap/support/notes/1658845.

Select the packages to install

Confirm the components to be installed and start the installation

The screenshots below show the console installation.

Select 1 for a new upgrade, or 2 for a new installation.

Select what to install, we recommend selecting everything.

Provide the required credentials, then confirm what will be installed and let the installer run.

SAP HANA Client

The hdblcm installer is a 64-bit installer that ships with the SAP HANA DB.  The 64-bit installer will install all the required 64-bit components (DB, AFL, and 64-bit client), it will not install the 32-bit version of the client.  Follow the steps below to install the 32-bit version of the client.

Make the SAP HANA client media available from the OS.  You do this using one of the following methods:

• Mount network storage where you’ve copied the install files
• Mount USB/CD where you’ve copied the install files
• Use an FTP client to upload the install files from local desktop to Linux server

When the files are copied navigate to ../DATA_UNITS/HDB_CLIENT_LINUXINTEL.  Ensure hdb* files and ./instruntime/sdbrun have execute permission set

• chmod 754 hdb*
• chmod 754 ./instruntime/sdbrun

After setting the proper permissions call ./hdbinst for console based installer, or ./hdbsetup for the graphical installer.

The directories shown above assume that you downloaded the base revision, for example revision 70.  If you downloaded the B1 certified version you must take all the actions shown but the directory with your install files will be different.

When the HANA installs are competed /usr/sap/hdbclient should contain the 64-bit version and /usr/sap/hdbclient32 should contain the 32-bit version.

SAP Business One Server Tools

The SAP Business One Server Tools installation instructions can be found starting on page 21 of B1_for_SAP_HANA_Admin_Guide.pdf that can be found in the documentation folder that is created when you unzip the files.

The SAP Business One Server tools depend on SAP HANA and both versions of the HANA client.  You need to make the SAP Business One Server tools available on the Linux server.  You can use the same methods described in the HANA section above.

The SAP Business One Server Tools installer require a graphical interface.  You can use the Linux Desktop, XMing, Exceed, Cygwin, to name a few.  If you use a graphical client you need to define the display settings.  If you use putty to connect to the server you can set the display in the SSH > X11 section.

If you did not preconfigure the display settings you can set the display using DISPLAY=localhost:10.0;export DISPLAY. This is an example your display settings might be different.

You need to navigate to ./Packages Linux/ServerTools/Disk1/InstData/VM and set execution permission on install.bin. You use chmod 754 install.bin to set the proper permission.  Note there is a space in the name, to make cd work you need to use double quotes “./Packages Linux/ServerTools/Disk1/InstData/VM”.

Start the install using /install.bin.  The installation wizard will guide you through the install. The installer welcomes you, click next, and set the installation location.

The next screen allows you to choose what to install.  We recommend everything but if you want to limit what is installed you can uncheck everything but Landscape Management.  You need System Landscape Directory and License Manager.  After selecting components you specify the port to install service on.  There is no need to change the default value of 40000.

Set the password of B1SiteUser.  You will need this when installing other components later. Provide certificate details or choose self signed.  The initial install can use a self-signed certificate.

Provide HANA server details.  You provide DB username, password and port. Determine if you want to use domain logon or not.

Review your settings and click install.

SAP Business One Server

The SAP Business One Server Installation instructions can be found starting on page 23 of B1_for_SAP_HANA_Admin_Guide.pdf that can be found in the documentation folder that is created when you unzip the files.

You need to make the SAP Business One Server tools available on the Linux server.  You can use the same methods described in the HANA section above.

The SAP Business One Server installer require a graphical interface.  You can use the Linux Desktop, XMing, Exceed, Cygwin, to name a few.  If you use a graphical client you need to define the display settings.  The steps to define display settings can be found above in the SAP Business One Tools section.

You need to navigate to ./Packages Linux/Server/Disk1/InstData/VM and set execution permission on install.bin. You use chmod 754 install.bin to set the proper permission.  Note there is a space in the name, to make cd work you need to use double quotes “./Packages Linux/Server/Disk1/InstData/VM”.

Start the install using /install.bin.  The installation wizard will guide you through the install.  The server and server tools installer has the same name.

./install.bin

The installer will prompt you to enter a user ID and Company name.

Select the installation type typical or custom.

Select the location where you want to install.

 

Select the features you want to install.

Enter the path to java (https://learntips.b-cdn.net/usr/lib64/jvm/java-1_6_0-ibm-1.6.0).  If not installed, use the SUSE Linux Enterprise Server 11 installation DVD to install java-1_6_0-ibm-1.6.0 to the path shown.

Enter the path to the license server and change the port to 40000.  The installer defaults to 30000.

Enter the HANA server details.

The system ID should be NDB.

The last step before reviewing the settings is entering the password for the admin user.  This password is used to perform initialization and maintenance of databases in the Administration Console.

Review the settings and install the Server.

The system shows success when everything is completed.

Add HANA system to SLD

After you have installed SAP HANA, SAP Business One Server, and SAP Business One Server Tools you need to add the HANA server to the System Landscape Directory using :40000/ControlCenter/”>https://:40000/ControlCenter/.  If you selected self signed certificates the browser will generate a problem with certificate message -this is ok and you can continue.

The first screen the SLD presents is logon, you connect using B1SiteUser and the password defined during the installation. The user ID is mixed case and the logon field will not work if the case settings are not correct.

The opening tab is “Servers and Companies” here you click add and enter the details of the SAP HANA DB.  You enter the hostname of the HANA server, the database user name is SYSTEM.  After entering the password, click ok.

You will see the system added.  When you select it you will see the companies.  If this is a fresh business one installation you will not see any companies until you install the Business One Client..

Add License

The SAP Business One server licensing steps can be found starting on page 71 of B1_for_SAP_HANA_Admin_Guide.pdf that can be found in the documentation folder that is created when you unzip the files.

In the SLD you can click the Service tab and select the License manager URL or navigate there directly using :40000/LicenseControlCenter/index1.html”>https://:40000/LicenseControlCenter/index1.html. The license manager screen will require you re-authenticate.  The user ID is B1SiteUser.  This location provides you the information used to request a license key.  It is also the location you visit to upload the license.

The SAP Business One installation process, shown above, can be watched by visiting https://www.youtube.com/watch?v=rPR5oTBX7fo&hd=1.

 

Install SAP Business One client

The SAP Business One client installation instructions can be found starting on page 38 of B1_for_SAP_HANA_Admin_Guide.pdf that can be found in the documentation folder that is created when you unzip the files.

On the windows server navigate to the directory where the SAP Business One client files have been decompressed.  Double click Autorun.exe to start the installation process.

Enter the ID and the company name. Select SAP Business One Client from the list of items.

The installer asks for a location on the start menu.  The installer asks where on the disk you want to install SAP Business One Client.  Normally, the default location is fine.

In the License Server Details window, specify the name and port of the license server and then choose the Next button. The port number is 40000, the default shown by the installer is 30000, you need to change this.

In the Setup Status window, wait for the system to perform the required actions.  In the Complete window, choose the Finish button.

If you are upgrading Business One client and the upgrade fails check note  1869174 https://service.sap.com/sap/support/notes/1869174 “Upgrading 64-bit SAP Business One 9.0 client, version for SAP HANA to patch level 1 or higher”.