Unattended Installation Mode

Nghia Nguyen SAP NetWeaver RIG Americas SAP Labs, LLC

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

SAPInst Backend Architecture

Ins. GUI
controls etc. (SSL)

SDTserver

initializes GUI
controls

XML
etc.

GUI-Engine
XML Callback

updates KeyDB
SAPINSTGUI.x ml Installation Repository Control.xml

SAPInst (backend)

pure java
Embedded Javascript
...

Action_Handler Dialog_Handler Cancel_Handler

Registry

HP DEC NT

SysLib
JavaAdapt er

PropertyManager

KeyDB
KeyDBClient BaseTable

Controller
InterfaceBroker

commit rollback

s on cti at fun ci lls an ca st s in e

MsgLib
logbook
Filter Buffered Messenger ErrorHandler Dictionary

requests service
DLL/JavaClass

Connector

t s ha lien C DB ey

ite com rate/ mit/ rollb ack

Module Lib

... ...

Module DLL
InstallationWorkbench

Msg-Manager
Writer

may use
e.g. Oracle, DB2 ...

Runtime

...

Writer

Development

ConnectionCompiler

XML

SAP AG 2007, Unattended Installation Mode / 4

SAPInst framework building blocks (2)

Controller
controls the execution of steps defined through installation components (control.xml) enables runtime loading of dynamic installation libraries (DLLs or shared objects) Provides mechanisms to run Java Script code

GUI-Engine
handles communication with the STD-Server/GUI and processing user input

SAP AG 2007, Unattended Installation Mode / 5

SAPInst framework building blocks(3)

Syslib
provides platform independent access to common installation tasks related to the operating systems (creating users, running executables, changing environment variables, manipulating the file system, etc.) Supported all Operating Systems SAP systems running on filename on Windows: sylib.dll; on Unix: sylib.so (Sun) build the basis for platform independent installation modules.

Keydb
provides a table based persistency layer (key.xml)

Message library
provides a common message handling (messages.xml)

SAP AG 2007, Unattended Installation Mode / 6

SAPInst framework building blocks(4)

Module/C++ Framework Extensions

contains none framework functionality implemented by portierung teams (C/C++)
Mostly used by db porting groups to call native DB specific functionality can be called within steps using java script

Operating System Windows Registry, Services, ProgramItems, LogOff Database Oracle, Informix, SAPDB, DB2/UDB, DB2/OS400, DB2/OS390 databases, instances, tablespaces, execute SQL scripts, ... SAP System Load, R3load Jload SAP System Configuration RFC based interface to call ABAP functions: ClientCopy, Language Settings, Add-Ons, Plug-Ins, Support Packages,User, RFC destinations, ..., Preconfiguration Packages

SAP AG 2007, Unattended Installation Mode / 7

Why using SDT Server ?

PC Inst-Gui
Browser

Server

SLM

GUI

SLM

SDT Server adapters for tools: SAPinst, SAINT, SAPM, JSPM, SAPJup, SAPup, (SMLT, ).
Tool Adapter

sdt.server

SLM can configure the tools via SDT Server and the integrated adapters. SLM can start and control the tools. The SDT Server could also be configured without SLM in a stand alone mode, to execute up-to-date installations.

SAPinst

SAPJup

SAPup

SAINT

SPAM

JSPM

Server

SAP AG 2007, Unattended Installation Mode / 8

Installations from the framework point of view

Installation service

Framework Sapinst(.exe) SDT-Gui

Control flow Component and step oriented description relevant files are : control.xml dialog.xml keydb.xml packages.xml .. ..

Software to be installed organized in so called software packages. Identified by a tag file (label.asc).

SAP AG 2007, Unattended Installation Mode / 9

How to get an nstallation service ?

via starting SAPinst using a product.catalog file
contains all installation services avialable for the customer based on XML

SAP AG 2007, Unattended Installation Mode / 10

Installation Service
From the point of SAPInst a installation Service consists as a set of XML-Files control.xml
contains all components which are needed for execute that service

name of start component dialog.xml (SAPINST_DIALOG_URL)

contains the dialogs (description) used by that service

keydb.xml (SAPINST_KEYDB_URL)
tables definition and content needed by components running during the service execution

messages.xml (SAPINST_MESSAGE_URL)
list of messages which can be used by components ( contains place holders )

packages.xml (SAPINST_PACKAGES_URL)
contains the list of software packages which might be used by the service

resourcepool.xml (SAPINST_RESOURCE_URL)
contains text information which can be used within dialog definitions (including pictures)

SAP AG 2007, Unattended Installation Mode / 11

Installation service definition within product.catalog

Depending on the selection the framework gets the information about what to copy from the installation master CD to the SAPinst installation directory (SIDIR).
Relevant XML-attributes of the selection :
<component id="d0e27361" output-dir="AS //this plus predecessor output dirs defines location of the SIDIR under the sapinst_instdir // all files of the control file directory will be copied the SIDIR // also the files of the product-dir (including sub directories ) // name of the start component

control-file="NW04S/WEBAS/ADA/control.xml product-dir="NW04S/WEBAS/ADA/PD

name="NW_Onehost

SAP AG 2007, Unattended Installation Mode / 12

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Unattended Installation
You can install an SAP system based on SAP NetWeaver 2004s in unattended mode. SAP Note Number 950619 SAP NetWeaver 2004s, ERP 2005, CRM 5.0, SRM 5.0, SCM 5.0

SAP AG 2007, Unattended Installation Mode / 14

Cases
Custom Instance
New server build New Developer

Save Time

SAP AG 2007, Unattended Installation Mode / 15

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Procedures
1. Create inifile.xml 2. Edit inifile.xml 3. Save the following files in a common directory 4. Create a file containing the paths to the installation DVDs 5. Identify the product ID(s) 6. Start SAPinst

SAP AG 2007, Unattended Installation Mode / 17

Procedures 1/6
Create inifile.xml
Run SAPinst as described in the installation guide. Stop SAPinst when the screen "Parameter Summary" appears.

Solution Manager Key

SR1 Release key is asked the during the parameter input SR2 Release key is not ask during the parameter input

SAP AG 2007, Unattended Installation Mode / 18

Procedures 2/6
Edit inifile.xml
Password
<strval><![CDATA[des19(97|31|137|230|96|156|245|108|235|)]]> <strval><![CDATA[<plain password>]]>

Changeable Parameters*:
Host, SID, Directory, Instance number, JCE Policy file, DB, Password, Etc.

Solution Manager Key**

Possible Option
Create a Web Service from smsy TX Create a standalone application from smsy TX

* May required change in the inifile.xml format if switching DB type ** Must create/change and insert into the inifile.xml

SAP AG 2007, Unattended Installation Mode / 19

Procedures 3/6
Save the following files in a common directory
inifile.xml, keydb.dtd, and doc.dtd Locate in the sapinst_instdir

SAP AG 2007, Unattended Installation Mode / 20

Procedures 4/6
Create a file containing the paths to the installation DVDs
Create a file with a name of start_dir.cd Enter the paths to the installation DVDs

Example:
Unix:
/usphlrig1/DLMinst/DL_Store/NW04S_Linux_SR2/BS_2005_SR2_SAP_Installation_Master
/usphlrig1/DLMinst/DL_Store/NW04S_Linux_SR2/NW_2004s_SR2_Kernel_WINDOWS__LNX_X86 /usphlrig1/DLMinst/DL_Store/NW04S_Linux_SR2/RDBMS_MAXDB_7.6.00_Build_35 /usphlrig1/DLMinst/DL_Store/NW04S_win32_SR2/Java/51032257

Windows:
Z:\IM\BS_2005_SR2_SAP_Installation_Master Z:\Kernel\NW_2004s_SR2_Kernel_WINDOWS__LNX_X86\KU_WINDOWS_I386 Z:\Java\51032257 Z:\MAXDB\RDBMS_MAXDB_7.6.00_Build_35

SAP AG 2007, Unattended Installation Mode / 21

Procedures 5/6
Identify the product ID(s)
Method 1: search for the product ID in "product.catalog" Method 2: look inside the keydb.xml for the product ID

SAP AG 2007, Unattended Installation Mode / 22

Procedures 6/6
Start SAPinst
SAPINST_PARAMETER_CONTAINER_URL:<path to copied inifile.xml> SAPINST_EXECUTE_PRODUCT_ID:<product IDs for installation services> SAPINST_SKIP_DIALOGS:true

Example:
sapinst.exe SAPINST_PARAMETER_CONTAINER_URL="c:\inst\inifile.xml SAPINST_EXECUTE_PRODUCT_ID=d0e4202 SAPINST_SKIP_DIALOGS=true

SAP AG 2007, Unattended Installation Mode / 23

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Solutions and Hints

Ensure all dependency materials are setup for the new box
Example:
JDK location Java policy file

Must start in an empty directory with only the cd path file (start_dir.cd)

SAP AG 2007, Unattended Installation Mode / 25

Solutions and Hints - Continue

Windows OS
SAPinst needs to <b>log you off</b> in order to reliably continue the installation
make sure the account which runs the installation has the following User rights
Act as part of the operating system Increase quotas Replace a process level token

Linux OS
The tmp installation directory where start_dir.cdreside must be own my sapinst userID and with full permissions for group

SAP AG 2007, Unattended Installation Mode / 26

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Demo

SAP AG 2007, Unattended Installation Mode / 28

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Summary
Note 950619
Has all the information on how to make this procedure work

Security
Must take into consideration of the password

SAP AG 2007, Unattended Installation Mode / 30

SapInst Unattended Installation Procedures Solutions and Hints Demo Summary Further Information

Further Information
Public Web:
www.sap.com SAP Developer Network: www.sdn.sap.com SAP Customer Services Network: www.sap.com/services/

SAP Service Marketplace:

service.sap.com/instguides Master Guides, Installation Guides, Upgrade Guides, Planning Guides

SAP Education Training Opportunities

http://www.sap.com/education/

SAP AG 2007, Unattended Installation Mode / 32