Skip to content

ICAM Installer Plugin Actions

ICAM Fetch

Inputs

icamfetch:
  host: <host>
  username: 
  password: 
  coreRepository: <specify which repository to check for vanilla upgrade binaries>
  custRepositroy: <specify the repo contains customizations. This is a customer specific repo. This can be null as well.>

These values needs to be in values.yaml file in order to execute.

Installer action

installer.cmd --values values.yaml 
   --set dbInstaller.deliveryPath=<Delivery Path location> 
    --set action=icamfetch 
    --set logFileLocation=<log file location>

If you don’t provide the icamfetch details in values.yaml, you can pass the values during the installer call. Refer the example below.

installer.cmd --values C:\Development\InstallerTest\custom_values.yaml 
  --set dbInstaller.deliveryPath=C:\Development\InstallerTest\Delivery 
  --set action=icamfetch 
  --set logFileLocation=C:\Development\InstallerTest 
  --set icamfetch.host=ifsclouddev.jfrog.io 
  --set icamfetch.username=automation 
  --set icamfetch.password=automationpw 
  --set icamfetch.coreRepository=ifs-binaries 
  --set icamfetch.custRepositroy=icam-cust-test

MTXDBUPGRADE

This executes Jasper SU/RU upgrade. Jasper upgrade package also needs to be in \icam\mx-database\jasperdbupgrade. You can fetch the package using icamfetch.

installer.cmd 
  --values D:\ifs\IFS_CLOUD\environment\custom_values.yaml 
  --set action=mtxdbupgrade 
  --set dbInstaller.sysPassword=<SYS password> 
  --set dbInstaller.deliveryPath=<Delivery path>  

Additionally, Jasper DB credentials need to be added in values.yaml or passed during plugin execution as below.

installer.cmd
--set action=mtxdbupgrade
--set dbInstaller.deliveryPath=<Delivery path> 
--set logFileLocation=${LOGS_DIR}
--set dbInstaller.jdbcUrl=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.xx.xx.xx)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=XXXX)))
--set dbInstaller.ifsmtxappPassword=MTX_APP_PASSWORD

MTXJASPERUPGRADE

This executes Jasper SU/RU upgrade. Jasper upgrade package also need to be \icam\mx-database\jasperdbupgrade. You can fetch the package using icamfetch.

installer.cmd 
   --values D:\ifs\IFS_CLOUD\environment\custom_values.yaml 
   --set action=mtxjasperupgrade 
   --set dbInstaller.sysPassword=<SYS password> 
   --set dbInstaller.deliveryPath=<Delivery path>

Jasper DB credentials need to be added in values.yaml or passed during plugin execution as shown below.

installer.cmd
--set action=mtxjasperupgrade 
--set dbInstaller.deliveryPath=<Delivery path> 
--set logFileLocation=${LOGS_DIR}
--set dbInstaller.jdbcUrl=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.xx.xx.xx)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=XXXX)))
--set dbInstaller.ifsmtxappPassword=JASPER_PASSWORD

MTXDBCUSTOMIZE

This will deploy Maintenix DB customizations. DB customizations Package also needs to be \icam\mx-database\mtxdbcustomize. You can fetch the package using icamfetch.

installer.cmd
--set action=mtxdbcustomize
--set dbInstaller.deliveryPath=<Delivery path>

Additionally, Maintenix DB credentials need to be added in values.yaml or passed during plugin execution as shown below.

installer.cmd
--set action=mtxdbcustomize
--set dbInstaller.deliveryPath="${ICAM_CUST_DELIVERY}"
--set logFileLocation=${LOGS_DIR}
--set dbInstaller.jdbcUrl=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.xx.xx.xx)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=XXXX)))
--set dbInstaller.ifsmtxappPassword=${MTX_APP_PASSWORD}

MTXREPORTIMPORT

This will import the Maintenix report Templates into Jasper DB. Report Import package also needs to be \icam\mx-database\reportimport. Can fetch the package using icamfetch.

installer.cmd
--set action=mtxreportimport
--set dbInstaller.deliveryPath="${ICAM_CUST_DELIVERY}"
--set logFileLocation=${LOGS_DIR}
--set dbInstaller.jdbcUrl=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=xx.xx.xx.xx)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=XXXX)))
--set dbInstaller.ifsmtxreportPassword=${MTX_JASPER_PASSWORD}