Build a build_home¶
To install a fresh installation of IFS Cloud or to perform an upgrade from previous release to latest IFS Cloud version, a build_home has to be available.
The creation of a build_home is handled in the build place Lifecycle Experience, and this is the normal approach.
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 or upgrade.
In agreement with IFS customers can be given the needed credentials to be able to download the binary artifacts using the fetch script.
Preparing a build_home
Create a build structure of the component files by running the script create_build_structure.ps1 from the components folder.
Example: Open a PowerShell window in C:\Work\components\fndbas\build PS C:\Work\components\fndbas\build> .\create_build_structure.ps1 -components "C:\Work\components" -build_home "C:\Work\build_home"
Run the script ifs_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
Run the script ifs_build.cmd to compile all source code. (This will also generate database files to be deployed) Example1 If the build_home is to be used in an upgrade scenario then run the ifs_build.cmd with connection credentials. Example2
Open a command window in C:\Work\build_home\build Example1: C:\Work\build_home\build>ifs_build.cmd Example2: C:\Work\build_home\build>ifs_build.cmd --userName="ifsapp" --password="password" --connectString="jdbc:oracle:thin:@(description=(address=(host=18.104.22.168)(protocol=tcp)(port=1521))(connect_data=(UR=A)(service_name=ifscloud)))"
The build_home is now ready to be installed as a fresh installation or for upgrade.
Using an existing fresh build_home for upgrade¶
When upgrading to IFS Cloud from an earlier release and have a build_home created for fresh install, then run the creation of install.tem within the build home, by calling the create-install-tem.cmd/sh script with database connection information to align the install.tem with the component status in the database to be upgraded.
Example: C:\Work\build_home\ifsinstaller\util> create-install-tem.cmd deliveryPath="C:\Work\build_home" buildhomePath="C:\Work\build_home" userName="ifsapp" password="password" connectString="jdbc:oracle:thin:@(description=(address=(host=22.214.171.124)(protocol=tcp)(port=1521))(connect_data=(UR=A)(service_name=ifscloud)))"
Note! If the build_home should be re used as a fresh install after the create-install-tem script has been run with database connection information, remove the install.ini in the build_home/database folder and run the create-install-tem script again without database connection information. This will create an install.ini and install.tem as FreshInstall.
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