SAP GUI Installation Server - SAP Blogs
SAP GUI Installation Server - SAP Blogs
Communit y
Follow Like
Topics
RSS Feed
Groups
All Group
s
Locations
Interests
Activities
Answers
All Questions
Ask a Question
How to Ask a Question
Using Tags
All Tags
Blogs
All Blog Posts
Write a Blog Post
How to Write a Blog Post
Using Tags
Using Categories
All Tags
Events
All Events
SAP Community
SAP CodeJam
SAP Stammtisch
SAP SuccessFactors
User Groups
Programs
Influencers
Spotlight Interviews
All Programs
Resources
Getting Started
Community Tutorials
Community Videos
Community Voice Newsletter
Reputation
Missions & Badges
Moderation
Rules of Engagement
All Resources
What's New
Explore SAP
Explore all areas of SAP
Products
Business Network
Business Technology Platform
CRM and Customer Experience
Enterprise Resource Planning
Financial Management
Human Capital Management
Small and Midsize Enterprises
Spend Management
Supply Chain Management
Sustainability Management
View products A-Z
View Industries
Trials and Demos
Partners Services
Learning and Support
Company Information
Careers
Customer Stories
Events
Investor Relations News
Center
Security and Trust
Topics
Groups
Answers
What's New
Explore SAP
Blogs
Events
Programs
Resources
SAP Community Log-in Update
In a few months, SAP Community will switch to SAP Universal ID as the only option to login. Create your SAP Universal ID now! If
you have multiple S- or P- accounts, use the Consolidation Tool to merge your content. Get Started with SAP Universal ID
Home
Community
Blogs
Ask a Question
Write a Blog Post
Login / Sign-up
Send a Message
Manage My Blog Posts
Quick Start Guide
Thirumal Karra
June 20, 2013 22 minute read
Introduction
This document describes how to set up and maintain an SAP GUI Installation Server for the efficient distribution of SAP Front end Components across
workstations in your organization.
Overview
SAP’s Front-End Software Deployment Tool – Netweaver SAPSetup not only allows direct installations from distribution media, but also an Installation
Server based deployment mechanism that helps distribute SAP Front-End Software to workstations over a network and also using Microsoft SCCM to
deploy the large number of users.
Front end components are available from an installation server or a distribution medium such as a DVD.
Install new SAP front end components, uninstall existing ones, and update the remaining components in one cycle.
Easier and more reliable handling of SAP front end components by using installation servers:
Maintain nearly all Windows-based SAP front end components on a single installation server.
Integrate additional SAP front end components into an existing installation server, such as Import Product.
Deploy multiple SAP front end components on workstations using a single command.
Easily manage the installation server with wizard-driven user interfaces.
Local Security Handling (LSH), when configured, lets you deploy SAP front end components on workstations without requiring administrator
privileges on all machines.
Whenever installed SAP front end components or packages change on the installation server, the automatic workstation update service
(AWUS) will, once configured, automatically update the workstations and reboot them if necessary.
Easier handling of multiple SAP front end components by configuration of installation packages – by implementing script events, you can
customize and extend the installation of such packages.
Controlling workstations remotely helps you to remotely access and control workstations on which you have administrator privileges.
You can collect remote log files, execute processes remotely, and list remote processes.
The directory for the creation of the installation server is configured automatically. By default, it is made NULL-session accessible. It can be
shared automatically on the network for everyone to read.
If NwSapSetup.exe is started from a batch file, the return code can be caught by the environment variable %ErrorLevel%.
0001053737_Expected release dates for SAP GUI for Windows & ITS Patches
0001670678_730_New Features
0001685221_SAP Logon maintain system entry without sapmsg.ini and service file
The host for server-based installations must meet the following conditions:
Accessible to all users at all times, even after the installation is complete. This is required for maintenance purposes such as the
distribution of patches.
Have broadband network connection for high throughput
Have sufficiently free disk space for all SAP front end components
Note: Read SAP Note 26417 to check that all hardware and software requirements for the front-end workstations have been met.
When installing SAP front end components with server-based workstation installation, the following options are available:
The following figure shows how the installation with an installation server works.
/wp-content/uploads/2013/06/1_234229.png
With an installation server, the administrator can group various SAP front end components together as installation packages relevant for certain
employee roles. The administrator can also specify which package particular users should receive, or offer a variety of packages and allow the user to
choose the most appropriate one.
To keep workstations up to date automatically, use the automatic workstation update service (AWUS). Whenever the installation server is patched, or
packages are updated on the installation server, this service will update the workstation(s) and reboot them, if necessary. The AWUS works regardless
of whether a user is logged on or not:
/wp-content/uploads/2013/06/2_234233.png
/wp-content/uploads/2013/06/3_234234.png
NwCreateInstServer.exe prompts you to supply the path to the directory in which you want to create the installation server.
Choose Browse to navigate to the directory in which you want to create the installation server. Ensure that the directory is empty.
/wp-content/uploads/2013/06/4_234236.png
Choose Verify to ensure that the chosen directory meets the prerequisites:
/wp-content/uploads/2013/06/5_234237.png
Choose Share to maintain the file-sharing properties of the selected directory for distributing using logon scripts and automatic
workstation update service Choose Next to continue.
/wp-content/uploads/2013/06/6_234238.png
Processing is recorded in the file NwCreateInstServer.log located in the SAPSetup log file directory.
/wp-content/uploads/2013/06/7_234240.png
If you want to set up an empty installation server, you can skip the update by calling NwCreateInstServer.exe with the parameter /NoServerUpdate on
the command line. In this case, the procedure ends here.
To update the installation server, reboot the Installation Server and execute NwUpdateInstServer.exe to transfer SAP front end components to your
installation server.
Navigate to the Installation Server folder and Click verify to start the Update
/wp-content/uploads/2013/06/9_234260.png
/wp-content/uploads/2013/06/10_234261.png
NwUpdateInstServer.exe transfers all SAP front end components available in the downloaded objects to the installation server.
/wp-content/uploads/2013/06/11_234262.png
If you have .NET Framework version 4 installed, choosing Finish Automatically starts NwSapSetupAdmin.exe from the recently updated installation
server.
NWCreateInstServer: Installation Server Creation Wizard Driven Tool that helps in creating a basic Installation Server and configures.NET
Security to administer it over a network path.
NWUpdateInstServer: Installation Server Update Wizard Driven Tool is used to update an Installation Server with SAP Front-End
Components. This utility will also automatically update older versions existing on an Installation Server by newer ones.
NWSAPSetupAdmin: Installation Server Administration Wizard Driven Tool that helps in maintaining and configuring an Installation Server, creating
packages, importing products, apply patches etc. Administrators can create a Package Definition File to deploy the package using like Microsoft
SCCM.
NWSAPSetup: Front-End Installation Tool is used to install SAP Front-End Components available on the Installation Server on a Workstation, to
update an installation or to perform un-installations. Administrator can install manually or using command lines to perform the installation silently
and unattended deployments
NWCheckWorkstation: This utility is used to diagnose the health of the Workstation containing installed SAP front-end components. It
creates a CAB-file with the error information. If required, you supply the logs to the SAP Primary Support.
NWSAPSetupDS: This tool allows you to configure (Local Security Handling) that helps administrators to allow domain users with non-
administrative privileges to install software locally on their workstations.
Import Product: Use this feature to add new products (for example, SAP front-end components) to an existing installation server for distribution over
the network.
Export Product: Use this feature to export front-end components available on one installation server to another.
Delete Product: Use this feature to delete a product from an installation server.
Create Package: Use this feature to create packages for deployment. Packages can contain many components and their installation parameters can
also be customized.
Create Package Definition File (PDF): You can create a package definition file (PDF) for an installation server package. PDF is a package description
format that simplifies the interoperability and information exchange between the SAP Installer and system management products like the System
Management Server from Microsoft.
Configure Package: Use this feature to change the attributes or the content of your packages.
Patch: Use this feature to patch components that are available on the installation server.
Local Security Handling: This feature allows workstation users to install SAP components from the installation server without requiring administrative
privileges.
Automatic Workstation Update: Whenever the installation server is patched, or the packages installed are updated, this service will update the
workstation and reboot them if necessary. The workstation updater works in two modes – one in the presence of a logged-on user and another in his
or her absence:
When a user is logged on, the user is informed of update availability and the update happens on the user’s assent. The user is also informed if a reboot
is necessary and the reboot is also only executed on the user’s assent.
If no user is logged on, the update is done automatically and the reboot (if necessary) is done automatically, too.
Control Remote Workstations: This functionality uses the Windows Management Instrumentation (WMI) to help you remotely access and control
workstations on which you have administration privileges. You access this feature via the Remote menu, where you find the options to:
/wp-content/uploads/2013/06/13_234299.png
Navigate to the product download location and select the “Setup” Folder
/wp-content/uploads/2013/06/14_234300.png
/wp-content/uploads/2013/06/15_234301.png
/wp-content/uploads/2013/06/16_234302.png
Navigate to the Installation Server folder you want to update and “Verify” the Installation
/wp-content/uploads/2013/06/17_234303.png
/wp-content/uploads/2013/06/18_234304.png
Check the logs for information if the Installation Server update fails for any reason.
/wp-content/uploads/2013/06/19_234307.png
/wp-content/uploads/2013/06/20_234308.png
/wp-content/uploads/2013/06/21_234309.png
/wp-content/uploads/2013/06/23_234314.png
/wp-content/uploads/2013/06/25_234316.png
The (X) cross indicator next to a package indicates that the package is incomplete. This typically occurs when a product that the package contains has
been deleted from the installation server. You can either delete this package or re-import the missing product.
/wp-content/uploads/2013/06/26_234320.png
Select the package that you want to customize and navigate to “Package Configuration”
Verify the Package Parameters (Variable Name, Package Value and Variable Description )
/wp-content/uploads/2013/06/27_234321.png
Add event-scripting to perform custom actions on the user’s workstation during the installation of the package (for example, copying additional files). You can insert scripting
samples delivered by SAP via Insert Script and adapt them to your requirements. The scripts are executed at the following events:
/wp-content/uploads/2013/06/28_234322.png
Example: If you want to check a file for existence on the workstation, navigate to “On Installation End” tab and insert a script sample and modify
according to your requirements.
/wp-content/uploads/2013/06/29_234326.png
You can now select or deselect components. Components added will be newly installed on the workstations. Those removed will be uninstalled from the workstations, if they are
not part of any other package marked for installation. When updating a package, the package installation parameters are also refreshed and include new variables or delete those
that belong to components that are no longer part of this package.
/wp-content/uploads/2013/06/30_234327.png
Follow on screen instructions and Save the package when you are finished.
Such a package contains only those files that belong to the components that are a part of the package. Thus, it reduces your network load in certain distribution scenarios where
you previously had to make local copies of your installation source before installing.
This single-file self-installer can also install silently without user interaction.
Following the wizard instructions, you will get a single exe-self-extractor at the end of the process.
On the Packages tab, right-click the package for which you want to create a PDF file and choose Create Package Definition File.
Choose the directory where you want to save the file, enter a file name, and choose Save.
To ensure that the installation server is not in use, the patch now closes NWSAPSetupAdmin.exe before continuing. It restarts NWSAPSetupAdmin.exe after completing the patch.
At the end of the process, you see a message indicating that the patch was successful.
Choose Close.
/wp-content/uploads/2013/06/40_234369.png
If there are errors, you see a link to an Error Report. Any errors are recorded in the following file, which you can view using your normal web browser:
%ProgramFiles%\SAP\SapSetup\Errors\ NWUpdateInstServerErrors_<CurrentDateTime>.xml.
If you have a problem, create a problem message on component BC-FES-INS and attach these files to the message.
Choose Next.
/wp-content/uploads/2013/06/42_234374.png
The wizard prompts you for the credentials of an account that has administrative privileges for all front ends on the network.
/wp-content/uploads/2013/06/43_234375.png
The wizard will be prompted to enter details for the installation service (IS) account, Verify, and choose Next to complete the process.
The wizard displays the success state in starting the distribution service and the status bar at the bottom of NWSAPSetupAdmin.exe displays the service state as Active.
/wp-content/uploads/2013/06/44_234377.png
Test the functioning of the LSH feature by starting NWSAPSetup.exe from this installation server on a front end where the logged-on user has ordinary user privileges (that is, the
user does not have administrative privileges).
If the front-end installer starts successfully and is able to install components available on the installation server, the configuration is successful. If not, you need to reconfigure LSH.
When a user is logged on, the user is informed of update availability and the update happens on the user’s assent. The user is also informed if a reboot is necessary
and the reboot is also only executed on the user’s assent.
If no user is logged on,the update is done automatically and the reboot (if necessary) is done automatically, too.
Note: This service updates itself, when a patch of automatic workstation update is available.
/wp-content/uploads/2013/06/46_234379.png
To make the automatic workstation update service available on workstations, you should create a package using NWSapSetupAdmin.exe on the installation server. This package
should consist of SAP GUI for Windows and SAP Automatic Workstation Update. Once automatic workstation update is installed, then the following programs will run on the
workstation in the background: NWSAPSetupUserNotificationTool.exe and NWSAPAutoWorkstationUpdateService.exe.
Note: The front-end side will query the last 10 installation sources that are network paths.
You have configured the SAP Automatic Workstation Update and made it available on the workstations.
To disable the service, activate the option ‘Disable Automatic Workstation Updates’ in the configuration tool on the installation server (see picture above). This configuration
change is propagated as an update to the workstations at the time of the next update check.
Note: Once disabled, this action cannot be undone until the Automatic Workstation Update Service is reinstalled.
AWUS Notes
Note 1584270 – AWUS & SapSrvSetup.xml
Choose Remote.
Look at the remote workstation log files on your local pc after download.
/wp-content/uploads/2013/06/49_234397.png
Troubleshooting
If you encounter problems with the WMI feature, diagnose WMI connectivity to a remote workstation using the Microsoft tool wbemtest.exe. Note, that you have to supply the
connection namespace as \\WorkstationName\root\cimv2.
Delegation
In order to start an installation on a remote workstation that is located on an installation server, delegation is required to be activated for the client machine(s) in question.
Please, refer to the Microsoft TechNet article at http://technet.microsoft.com/en-us/library/ee692772.aspx, question 10 for further details.
/wp-content/uploads/2013/06/51_234399.png
Installation Process
Installing SAP Front End Components from an Installation Server
This procedure tells you how to install Front end Components from an installation server Start
/wp-content/uploads/2013/06/52_234408.png
Choose Next.
The product list is displayed. Products that have already been installed are pre-selected as shown in the following picture:
Select the products or SAP front-end components that you want to install or deselect the ones you want to remove.
Yellow dots indicate changes in the selection list. The Green plus next to a product name indicates that “This item will be installed” when the user installs the package on his or her
workstation.
/wp-content/uploads/2013/06/54_234422.png
The checkbox with no additional symbols indicates that “This item is already installed” Uncheck the product if you don’t want to reinstall.
/wp-content/uploads/2013/06/55_234423.png
If you deselect a product in this list that has already been installed, a Red minus appears to indicate that “This item will be uninstalled”
/wp-content/uploads/2013/06/56_234424.png
Note: Be careful when removing packages. Make sure you do not mistakenly remove shared components that are used by other packages you want to keep.
Start NWSAPSetup.exe /package from the SETUP folder of the installation server.
/wp-content/uploads/2013/06/57_234425.png
A list of the packages that the user is authorized to install or uninstall is displayed. Packages that have already been installed are pre-selected.
In this case, the BW Package has been selected for installation. The yellow dot indicates a change in the selection list. The green plus next to the product name indicates that this
object will be installed when the user installs the package on his or her workstation. If you deselected a package, you would see a red minus next to the object selected for de-
installation.
Select the components or packages that you want to install or deselect the ones you want to remove.
/wp-content/uploads/2013/06/58_234426.png
Note: If errors occur during the installation, SAPSetup displays a link to a document in which the errors have been logged. Contact the administrator of the installation server or the
network and pass on the information given in this document.
Installing Packages Using the Logon Script
Since the front-end software is normally installed on a large number of computers, NWSAPSetup lets you automate this task.
By inserting a command line into the logon scripts of the computers on which the front-end software is to be installed, you can start a package installation each time the user logs
on.
Enter the following command (both the path and either the package name or unique package identifier must be used):
When you start this command for the first time on a computer, NWSAPSetup installs the specified package.
Updating the front end basically involves the same steps as an installation; see section Installation of the SAP Front End from an Installation Server You have the
For unattended update, use the following command line: \\<server_path>\setup\NWSAPSETUP.exe /UPDATE /silent To update
Or
You will find the command-line name of the package or product in the administrative console NWSAPSetupAdmin.exe.
For automatic update, you can use the SAP Automatic Workstation Update. Whenever the installation server is patched, or the packages installed are updated, this service will
update the workstation(s) and reboot them if necessary. The workstation updater works in two modes – one in the presence of a logged-on user and another in his or her absence
When a user is logged on, the user is informed of update availability and the update happens on the user’s assent. The user is also informed if a reboot is necessary
and the reboot is also only executed on the user’s assent.
If no user is logged on, the update is done automatically and the reboot (if necessary) is done automatically, too.
The SAP Automatic Workstation Update is not SAP GUI-specific, it works with all components available on the installation server. For details, see section 3.9 Configuring SAP
Automatic Workstation Update.
Log Files
All the installation tools described in this document maintain an activity record in log files that you can find here:
%ProgramFiles%\SAP\SAPSetup\Logs
Files
Errors are stored in an XML format in files that you can view in any browser and you can find in the following folder:
%ProgramFiles%\SAP\SAPSetup\Errors
If you have a problem, create a problem message in BC-FES-INS and attach the relevant log files to the message.
Tool Log File Error File
NwCreateInstServer.exe NwCreateInstServer.log NwCreateInstServerErrors_<DateTime>.xml
NwUpdateInstServer.exe NwUpdateInstServer.logNwUpdateInstServerErrors_<DateTime>.xml
NwSapSetupAdmin.exe NwSapSetupAdmin.log NwSapSetupAdminErrors_<DateTime>.xml
NwSapSetup.exe – Single File
NwSapSetup.log SAPSetupErrors_<DateTime>.xml
Installer
Return Codes
The following table describes the return codes for NwSapSetup.exe
Return Codes Description
0 Process ended without detected errors
3 Another instance of SAPSetup is running
4 LSH failed
16 SAPSetup started on WTS without administrator privileges
26 WTS is not in install mode
27 An error occurred in COM
48 General error
67 Installation canceled by user
68 Invalid patch
69 Installation engine registration failed
70 Invalid XML files
129 Reboot is recommended
130 Reboot was forced
144 Error report created
145 Error report created and reboot recommended
146 Error report created and reboot forced
Additional Information
Troubleshooting
References
http://scn.sap.com/community/gui/blog/2013/05/10/sap-gui-branding
***********
Alert Moderator
Alerting is not available for unauthorized users
Assigned Tags
Retagging
required gui
gui package
gui730
installation
installation
server
sap
sap gui
sapgui server
View more...
Related Questions
/
11 Comments
You must be Logged on to comment or reply to a post.
MA JAMIL
June 21, 2013 at 3:53 am
hi thirumal,
You have done great job and it is really good and comprehensive blog because you mentioned maximum configuration of SAP GUI Server. please
keep it up.
Regards,
MA Jamil
Like 0
Share
Right click and copy the link to share this comment
Thirumal Karra
Blog Post Author
June 21, 2013 at 12:27 pm
Thanks Jamil,
Like 0
Share
Right click and copy the link to share this comment
Like 0
Share
Right click and copy the link to share this comment
Like 0
Share
Right click and copy the link to share this comment
Yes, thanks for the guide. I was about to create my own internal guide, but this is as good as it can get!
Once you get to know how it works, the tool/framework is very good.
Like 0
Share
Right click and copy the link to share this comment
Hi ,
i have one query which i have stucked here ,when am trying to install packages from GUI server location to the Remote Server it is not happening.
Execution of C:\GUIADM\Setup\NwSapSetup.exe /Silent /Package="Gui730" on XX.XX.XX.XXX has failed. Check parameters and credentials, and verify
whether the workstation is running.
Like 0
Share
Right click and copy the link to share this comment
You will want to execute NwSapSetup.exe from the remote server location (the one where your "Gui730" package resides), not from your workstation.
I.e. if your Installation Server is on host Server0 and your workstation is Client0, then FROM Client0 execute the command as
Regards,
Matt
Like 0
Share
Right click and copy the link to share this comment
I want to install SAPGUI installation server on my environment but we have several site with low network bandwidth between them.
If we use only one SAPGUI installation server on the corporate site, the installation on client could be be very slow due to network bandwith.
With Microsoft DFS technology for example. If Yes, how to set parameter in config file to find the adress of the Distribution Service.
Second solution:
One master installation server and deploy slave (replicate) installation server on other site.
Like 0
Share
Right click and copy the link to share this comment
Like 0
Share
Right click and copy the link to share this comment
Hello. I'm wonder whether it can be appliable for NWBC as well. Anyone who has tested it before?
Like 0
Share
Right click and copy the link to share this comment
I have question, where or how to get to have in SAP Logon own path to local configuration file? Where to set custom path in package preparation?
BR,
Martin
Like 0
Share
Right click and copy the link to share this comment
Find us on