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