Build a Delivery¶
To install a service update, as well as customizations, is through deliveries.
The creation of deliveries is handled in the build place Lifecycle Experience, and that is the normal approach.
For customers that has been granted to build manually, the script create_build_structure should be used.
Prerequisites and Settings¶
Make sure to read the install notes before you start. In some cases there are additional steps necessary before and/or after the installation.
In agreement with IFS customers can be given the needed credentials to be able to download the binary artifacts using the ifs_fetch.cmd
The changed source files that should be included in the delivery should be at hand.
To do this:
- Makes sure to have cloned your customer solution Git repository locally.
- Get the changed source files from your local Git repository using Git diff.
Example: git fetch script example
You need to have full access to the build_home folder containing all source code.
¶
Preparing a Delivery
Create a delivery structure of the component files by running the script create_build_structure.ps1 from the build_home.
Example:
Open a PowerShell window in C:\Work\build_home\build
PS C:\Work\build_home\build>.\create_build_structure.ps1 -components "C:\Work\git-diff-components" -delivery "C:\Work\delivery_001"
Run the script fetch.cmd with the arguments "user" "password" ifs_fetch.cmd/sh
Example:
Open a command window in C:\Work\build_home\build
C:\Work\build_home\build>ifs_fetch.cmd --user read_user --password DeYsdfIZxjl64th7eGhfd4qKu1 --delivery "C:\Work\delivery_001"
Define the parameter delivery and run the script ifs_build.cmd and accept the default values to compile all source code. (This will also generate database files to be deployed)
Example:
Open a command window in C:\Work\build_home\build
C:\Work\build_home\build>set DELIVERY=C:\Work\delivery_001
C:\Work\build_home\build>ifs_build.cmd
The delivery is now ready to be installed where all components are set to VersionUpToDate, which means that no *.cre or *.upg files will be executed with content.
Note! If the delivery contains new components or components that should be upgraded from earlier releases, the run the ifs_build.cmd with connection credentials instead to align the install.tem with the component status in the database
Example:
Open a command window in C:\Work\build_home\build
C:\Work\build_home\build>ifs_build.cmd --userName="ifsapp" --password="password"
--connectString="jdbc:oracle:thin:@(description=(address=(host=1.2.3.4)(protocol=tcp)(port=1521))(connect_data=(UR=A)(service_name=ifscloud)))"
Create build_home in Linux¶
All examples above are applicable for the Linux bash ( .sh ) scripts as well. To avoid execute privilege's issues start the script with a bash command
Example
$ bash ifs_build.sh