Technical Articles
Repeating a SUM run using a configuration file
Scenario
You want to repeat a Software Update Manager (SUM) ABAP run on a system with identical parameters, and do not want to have to re-enter the values again.
Note: for SUM Java, check the guide, section “Performing an Automated Update”.
Feature
SUM 1.0 SP 20 offers the possibility to provide processing parameters by means of a file, so that it is no longer necessary to display the dialogs for entering these parameters.
Note that transitions to the following roadmap steps cannot be automated and have to be confirmed manually. In addition, important dialogs are still displayed (like the decision to enter the downtime – makes sense?)
- Note: this procedure is not a batch procedure, it does not make the SUM process run “silent”!
- Note: this procedure is described in the SUM guide, section
“Running the Software Update Manager Again Using a Configuration File”
Approach
Sequence
- Execute the standard SUM run on the respective system as usual
- Generate the configuration file after the first SUM run
- Start the subsequent SUM run with the configuration file located in the SUM/abap/control directory
Details
- Execute the Standard SUM run on the respective system as usual
If you have finished the complete SUM run, the configuration file will contain all respective variables.
You can as well generate the configuration file for a run that has not reached 100 %, but the file will then not contain all possible variables. - Generate the configuration file after the first SUM run
Use the following command to generate the configuration file:
SUM\abap\bin\SAPup genconfiginput
The SAPup generates the configuration fileConfigInput.xml
in the current directory.
Note: For passwords, the generated XML-file contains the respective tags, but no content. You may enter the password into the file manually.
The password has to be provided in clear text, so please use this tag only for uncritical test systems. - Start the subsequent SUM run with the configuration file located in the SUM/abap/control Directory
For the subsequent SUM, copy or move the configuration file to the SUM\abap\control directory on the same (or identical) system.
[Edit 2019 12 11: directory must be control, not bin]
Afterwards start the SUM run as usual from a browser window, using the URL. - You may adapt the parameters in the configuration file with an editor of your choice.
- With a new SUM SP-version, in general the parameter names will be kept, but you should check this, as this cannot be guaranteed.
Note:
If you fill the ConfigInput.xml with wrong data, the SUM will show the respective dialog. Don’t forget then to adapt the value in the ConfigInput.xml as well! Otherwise in case that the SAPup is stopped, it will read the wrong value from the file when starting up!
Hi Boris,
Thanks again!
I believe we can still modify the value even we start SUM using the configuration file?
For example, we would like to adjust no of processes, spdd TR and etc..
Thanks,
Nicholas Chang
Hi Nicholas,
yes: after starting the SUM using the configuration file, you can still use the options offered in menu More / Utilities to adapt the parameters.
Regards, Boris
Hi Boris,
Is it possible to run SUM in a silent mode without going through the GUI in the first round? We have got customers who are interested in automate the process using scripts or similar tools. I checked the SUM guide but didn't find such option. What would be your advice to automate SUM in a batch process?
Thanks,
Sherry
Hi Sherry,
this is not offered.
Regards, Boris
Hi Boris,
I can't find any documentation/guide about the parameters and their values which are used in the parameter file.
Could you offer one?
We actually use SUM 2.0 SP06 Patchlevel 2.
Thank you very much.
Regards,
Mike
Hi Mike,
indeed there is no documentation. I guess as you have to execute a run (before you let SUM create the ConfigInput.xml file), you should anyhow know which parameters show which values.
Regards, Boris
Hello Boris,
Good day!!
We would like to upgrade JVM and igs helper for the JAVA systems.
Is it possible to repeat the SUM using config file, If yes please guide us.
Thank you
Regards
Sugan
Hello Sugan,
well, I guess you overlooked the note in the first section "Scenario", is that possible?
Regards, Boris
Hi, we are planning to set up the configuration file in our development system and redeploy the maintenance in our QA and PRD. If we have XML for each system or systems with same software modules versions, this approach can work?
Hi Gustavo,
should work.
The configuration file is a kind of field:value list. So if the UI elements (field) are the same (because you use the same SUM SP-version) and the content is appropriate to the system (value), you can reuse the file from one run for another system, maybe with partial manual adaption.
Regards, Boris
Hello Boris,
We were trying to using ConfigInput.xml for one of our environment but got below error:
Any suggestions?
[ConfigInput.xml was not edited at all]
Regards
Vipin
Hi Vipin,
you state that the file was not edited, but the error message indicates that the XML does not contain correct UTF-8 data, please check the content.
Regards, Boris
Hello Boris,
Thanks for your comment.
Yes, XML was not edited. we were trying to test this feature in one of our environment.
I think sum is trying to convert XML (utf-8) to UC (unicode) but fails to do so.
Please find below dedicated link of XML for you :-
https://sap-my.sharepoint.com/:u:/p/vipin/EaBPig8hnQxBsuLMHF6mQncBfdx8lD-6xsJeEqUAY-Pxfw?email=boris.rubarth%40sap.com&e=SFjTry
Regards
Vipin
Hello Vipin,
looks like you have to create an incident on that, thanks.
Regards, Boris