Skip to content

Installing Maintenix

The IFS Cloud installer installs the IFSApps database schema, IFS Cloud application, Maintenix application, and the Maintenix Reporting application.

The Maintenix and Maintenix Reporting database schemas are installed manually.

These are the high-level steps and information sources you use to install IFS Cloud and Maintenix:

Installing the co-deployed databases

You start by installing the IFSApp database schema using the IFS installer. See IFS Installation Guide for information on prerequisites and the IFS Build home that contains scripts and artifacts required for the installation.

  1. Prepare servers. See Preparing Servers.

  2. Read about how the installer works and about installing the IFSApps database with the dbinstaller action. See Deploying IFS Cloud.

  3. Go to the <build_home location > ifsinstaller folder and edit the ifscloud-values.yaml file. Note the following:

    • The values file also requires middle tier parameter values which you can provide now. See Installation Parameters, and note the Maintenix-specific tables, IFSMAINTENIXAPPSERVER and IFSMAINTENIXREPORTSERVER for the middle tier.
    • Your edited values file must be referenced by the deployment.
  4. Run the installer in the dbinstaller action mode with the following command to install the IFSApps database schema to the database server:

    .\installer.ps1 --set logFileLocation=<log file location> --values <yaml file location>/ifscloud-values.yaml --set action=dbInstaller --set dbInstaller.deliveryPath=<Build_Home location> --set dbInstaller.sysPassword=<DB sys pwd>
    
  5. Install the version of the Maintenix Database Tools that corresponds with the IFS Cloud version you are using. See the IFS Maintenix Database Installation Guide.

  6. Install the Maintenix database schema to the same database server that the IFSApps schema is installed on. See the IFS Maintenix Database Installation Guide. In this guide, when you get to the following topics, in addition to the documented privileges, you must also grant the following:

    Topic: Required Oracle privileges for the SYSTEM user
    GRANT SELECT ON sys.dba_pending_transactions TO SYSTEM;
    GRANT SELECT ON sys.pending_trans$ TO SYSTEM;
    GRANT SELECT ON sys.dba_2pc_pending TO SYSTEM;
    GRANT EXECUTE ON sys.dbms_xa TO SYSTEM;
    
    Topic: Oracle privileges of the IFS Maintenix user
    For the AQ_USER_ROLE: FORCE ANY TRANSACTION
    
  7. Install the Jaspersoft database schema to the same database server. See the IFS Maintenix Installation and Configuration Guide / "Import the Jasper Reports database schema" topic.

  8. In the Maintenix <database_install>/install folder, open and edit the co-deployed.properties file:

    Section Property Default value and notes
    Ifsapp account information ifsapp.username =
    No default set in properties file. This is the name of the IFSApps database schema user/owner. Set it to IFSAPP unless you specified a different name for this user in the ifscloud-values.yaml file for theifscore.users.ifsappUser.data parameter. The name used in this properties file must match the value used for the IFSApp database installation.
    ifsapp.password =
    No default set in properties file. This is the password of the IFSApps database schema user/owner. Enter the same value that you specified in the ifscloud-values.yaml file for the dbInstaller.ifsappPassword parameter. The password used in this properties file must match the value used for the IFSApp database installation.
    Disconnected Operations Configuration baseline.transfer.state.changes =FALSE
    Default in properties file and in Maintenix database is false. Value should be false for all installations except when you are deploying IFS Cloud to the Central Engineering Authority instance.
    baseline.transfer.with.assets =52
    Default in properties file and in Maintenix and IFSApp databases.
    If you change the value in this properties file, this updates both database schemas.
    technical.record.transfer.days =365
    Default in properties file and in Maintenix and IFSApp databases.
    If you change the value in this properties file, this updates both database schemas.
    disco.default.location =
    No default set in properties file. Specify the airport location code for this instance to update the default placeholder value in the Maintenix and IFSApp databases. Database default is ToBeUpdated.
    Common properties ifs.codeployed.entity.sync.mode = ASYNC
    Default value in properties file is the recommended setting.
    enforce.signatures = FALSE
    Default in properties file is FALSE and must be FALSE to ensure that the value in the Maintenix database is set to false.
  9. In the same location, run the codeployed-set-up.bat script. This script applies the values you specified in the co-deployed.properties file.

Installing the middle tier

If you did not edit the ifscloud-values.yaml file in an earlier step to include the IFSMAINTENIXAPPSERVER and IFSMAINTENIXREPORTSERVER parameter values, you must do so now.

Go to the <build_home location > ifsinstaller folder and run the installer in the mtinstaller action mode with the following command to install the middle tier applications:

installer.cmd --set logFileLocation=<log file location> --values <yaml file location>/ifscloud-values.yaml -set action= mtinstaller

Note: Only one replica of the Maintenix container is possible.