Draft Notice
This document is a work in progress. You can use it as a reference to help you with your 9.0 SAP Business One powered by SAP HANA installs. Be advised that some of the content shown here will be updated. When the document is completed this notice will be removed.
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 http://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 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
Installation
The next section will take you through the 3 main installation tasks: Operating System, SAP HANA, SAP Business One
OS
Please 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. The installation process is captured on the System Deployment slide deck available from https://service.sap.com/~form/handler?_APP=00200682500000002702&_EVENT=DISPLAY&_HIER_KEY=201100035870000001783&_HIER_KEY=501100035870000019682&_HIER_KEY=601100035870000247760&_HIER_KEY=601100035870000255309&.
At this time the SuSE wizard will allow you to install HANA and the OS, you will have to manually install afterwards SAP Business One 9.0.
HANA
Make the SAP HANA 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_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 ./hdbsetup for graphical installer or ./hdbinst for console based installer.
The system will prompt you for the following information:
- System ID: NDB
- Instance number: 00
- Install path: /usr/sap
- Location of data and log volumes: use the partitions you defined prior to installing the OS
- 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
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.
The screenshots below show the console installation.
SAP HANA 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. There is not a graphical installer
Repeat the step above for ../DATA_UNITS/HDB_CLIENT_LINUX_X86_64.
When both 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 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
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/ServerTools/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
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 https://<hostname>: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
In the SLD you can click the Service tab and select the License manager URL or navigate there directly using https://<hostname>: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.
Install SAP Business One client
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".