Skip to content

You are here: Hostname/Port changes for Tomcat Application Server

FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that you may encounter during installation.

  • Issue: If you have upgraded from Foundry V8.x or lower versions to V9 GA or higher versions, some of the services fail to work because of an internal authentication error. These services, such as the Foundry Admin Adapter, Email Adapter, and Workflow Email services, fail with the following error:

    {
        returned HTTP [400], Response Body [{"details":{"message":"Could not find trust security group for given envId","errcode":0,"errmsg":"Could not find trust security group for given envId"},"httpstatus":"Bad Request","requestid":"5e36d604-09ab-4fbb-9437-42c1d828140f;98","domain":"AUTH","code":-65,"mfcode":"Auth-65","message":"Some of the input parameters provided are invalid"}]
        }

    Workaround

    To avoid the error, you must perform the following:

    1. Log in to Foundry Console which you upgraded for V9.x.
    2. In your Volt MX Foundry account, click Environments. The Environments page appears.
    3. Click MODIFY for the environment. The Modify Environment page appears, shown below:

    4. In the Modify Environment page, click SAVE.

  • Issue: While upgrading from Foundry 7.3 to Volt MX Foundry V9 and then upgrading to a version after V9, the upgrade fails due to the following error:"java.sql.SQLSyntaxErrorException: Table 'prefixidglobaldbsuffix.schema_version' doesn't exist".

    Workaround

    To avoid this issue, perform the following step:

    • Delete the idglobaldb schema before upgrading to the version later than V9.
  • Issue

    The upgrade installation from v8.2.1.3 to v9.x rolls back.

    Workaround

    Before the upgrade, execute the following SQL statement from admin database:

    For MySQL
    ------------
    delete from .schema_version where script = 'V62.1__voltmxadmin-mysql-8.2.0.0.sql';

    For SQLServer
    ---------------
    delete from .schema_version where script = 'V62.1__voltmxadmin-sqlserver-8.2.0.0.sql';

    For Oracle
    ----------
    delete from .schema_version where script = 'V62.1__voltmxadmin-oracle-8.2.0.0.sql';

  • Issue

    If you upgrade the integration service or install on new server using the existing database but with a different server details like fully qualified URL port, and when you publish an app, the app publish fails.

    Workaround

    You must update management server details in the server_configuration table in admin database.

  • How to change the Hostname/IP address and port details of the existing Volt MX Foundry Server.

    After the installation of Volt MX Foundry, if you want to change the existing Hostname/IP address that was used during the installation of Volt MX Foundry, follow these steps:

    1. Go to your Volt MX Foundry install folder.
    2. Go to scripts folder - for example, <MFinstallfolder>/scripts. The scripts folder contains a .sql file for the database type that you selected while installing Volt MX Foundry.
    3. Open the .sql file in a text editor.

      Important: If you want to access Volt MX Foundry Console with a new port, change the value for the NEW_PORT with the new value. Otherwise, assign the value of the OLD_PORT to the NEW_PORT variable.

      Important: If you want to access Volt MX Foundry Console with a hostname/IP address, change the value for the NEW_HOST with the new value. Otherwise, assign the value of the OLD_HOST to the NEW_HOST variable.

    4. Change the values for the following variables.

      • For MySQL, MariaDB, DB2, and SQL Server, replace the values for the NEW_HOST and the NEW_PORT with new values.
      • For Oracle, replace all the occurrences of the NEW_HOST and the NEW_PORT with new values.

      Important: If you have selected your database as DB2, follow the steps provided in the .sql file in the <MFinstallfolder>/scripts folder.

    5. Run the SQL script on the database where you have installed Volt MX Foundry.

  • Issue

    If the java.sql. BatchUpdateException: Prepared statement needs to be re-prepared error is logged in the Identity service logs or if certain operations fail to work properly when an identity service is invoked, do the following.

    Workaround

    Add the following server variable in MariaDB ini file located in the MariaDB installation folder.

    
        table_open_cache=64
    

    Path for MariaDB ini file, <USER_INSTALL_DIR>\MariaDB 10.1\data\my.ini

  • Issue

    If you face the error dialogue "Windows error 2 occurred while loading the Java VM" while launching the Volt MX Foundry Patch Installer, because of the following:

    Volt MX Foundry Patch Installer runs with your system's default Java. If an user machine has Java 8 installed, then check if the machine's System Environment Path for Java  or  JAVA_HOME  is set to c:\programdata\oracle\java\javapath

    Workaround

    1. Remove the current path from JAVA_HOME and set the new path as C:\Program Files (x86)\Java\jre1.8.0_40\bin
    2. Launch the Volt MX Foundry Patch Installer.
    3. After the installation completed, reset the machine's  System Environment Path for Java  or  JAVA_HOME path to it's original path. For example c:\programdata\oracle\java\javapath
  • Issue

    If your service provider's certificate is not configured, the system displays an error - "peer not authenticated."

    Workaround

    For trusted certification issues, refer to SSL Certificate Issues.

  • Issue - When you publish a number of apps, the system throws the error - too many open files.

    For example:

    Workaround

    Update some of the default kernel parameter settings in your Linux environment. For more details, refer to Tuning File Descriptor Limits on Linux

  • Issue

    When customer wants to install Volt MX Foundry with Oracle as database type, the system throws the error: Invalid Data Type SDO_GEOMENTRY

    Workaround

    Install Oracle locator, which is required for Volt MX Foundry installation. For more details, refer to Pre-installation Tasks > Create Locator Component for Oracle Database

  • Issue

    Upgrading from Foundry 6.5.2, 7.0.1 or 7.1.1 with MS SQL Server fails. Installer is rolling back, as the schema version table is not migrating properly while upgrade.

    Workaround

    To avoid this issue, follow these step:

    Remove the version_rank column from schema_version table in each schema by following queries before upgrade.

    {
        drop index schema_version_vr_idx on master..schema_version;
        alter table master..schema_version drop column version_rank;
    }

  • Issue

    Auth (VoltMX Identity Service) datasources are not created when upgraded from Foundry 6.5.2.GA to 7.2.GA.

    Workaround

    Create datasource for authconfigdb and authglobaldb. For more details, refer to Configuring_JNDI_for_Database > Data Source for Single Node and Multinode > VoltMX Identity Service Data Source section.

  • Issue

    If you have installed Foundry 7.3 or older, and when you use the existing database for Volt MX Foundry V8 on JBoss, the Web Application publish fails.
    Workaround
    Update the management_server_port in the server_configuration table of admindb with the jboss.management.http.port in the <USER_INSTALL_DIR>\jboss\standalone\configuration\standalone.xml.

  • Issue

    If you do not want to use a DB user with DBA role or Equivalent privileges for the Volt MX Foundry installation on ORACLE database, follow these steps:


    Workaround


    Manual Steps:

    1. Create Component Users (schema) with the required grants as below.

      {
          CREATE USER MFCONSOLEDB identified by  default tablespace  profile default;

      ALTER USER MFCONSOLEDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO MFCONSOLEDB;

      GRANT CREATE JOB TO MFCONSOLEDB;

      GRANT MANAGE SCHEDULER TO MFCONSOLEDB;

      CREATE USER MFACCOUNTSDB identified by default tablespace profile default;

      ALTER USER MFACCOUNTSDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO MFACCOUNTSDB;

      GRANT CREATE JOB TO MFACCOUNTSDB;

      GRANT MANAGE SCHEDULER TO MFACCOUNTSDB;

      CREATE USER MFREPORTSDB identified by default tablespace profile default;

      ALTER USER MFREPORTSDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO MFREPORTSDB;

      GRANT CREATE JOB TO MFREPORTSDB;

      GRANT MANAGE SCHEDULER TO MFREPORTSDB;

      CREATE USER IDCONFIGDB identified by default tablespace profile default;

      ALTER USER IDCONFIGDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO IDCONFIGDB;

      GRANT CREATE JOB TO IDCONFIGDB;

      GRANT MANAGE SCHEDULER TO IDCONFIGDB;

      GRANT CREATE TABLE TO IDCONFIGDB;

      GRANT CREATE ANY INDEX TO IDCONFIGDB;

      GRANT ALTER ANY TABLE TO IDCONFIGDB;

      CREATE USER ADMINDB identified by default tablespace profile default;

      ALTER USER ADMINDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO ADMINDB;

      GRANT CREATE JOB TO ADMINDB;

      GRANT MANAGE SCHEDULER TO ADMINDB;

      CREATE USER VPNSDB identified by default tablespace profile default;

      ALTER USER VPNSDB QUOTA UNLIMITED ON USERS;

      GRANT CONNECT,RESOURCE,CREATE VIEW TO VPNSDB;

      GRANT CREATE JOB TO VPNSDB;

      GRANT MANAGE SCHEDULER TO VPNSDB;

      }

    2. Create a non DBA user with the below grants. This user will be given to the Installer.

      {
          CREATE USER  IDENTIFIED BY ;
          GRANT CREATE SESSION TO  WITH ADMIN OPTION;
          GRANT SELECT ANY DICTIONARY TO ;
          ALTER USER  QUOTA UNLIMITED ON ;
          ALTER USER  QUOTA UNLIMITED ON ;
          ALTER USER  QUOTA UNLIMITED ON ;
          }

    Note: The password for the component users and the installer user have to be same.

  • Issue 

    For storage services to work, change the following storagedb entries in the admindb.


    Workaround

    Manual Steps:

    {  
    storage_database_type - oracle
    storage_database_hostname - Database hostname/IP
    storage_database_port - Database Port
    storage_database_username - DBA username
    storage_database_password - DBA Password
    storage_database_instance - service ID/service name
    storage_data_tablespace - Data Tablespace name
    storage_index_tablespace - Index Tablespace name
    storage_lob_tablespace - Lob Tablespace name }

  • Issue

    If you do not want to use a DB user with DBA role or Equivalent privileges for the Volt MX Foundry installation on MSSQL, follow these steps:


    Workaround


    Manual Steps:

    
            Create database mfreportsdb;
            Create database mfaccountsdb;
            Create database mfconsoledb;
            Create database admindb;
            Create database vpnsdb;
            Create database idconfigdb;
            CREATE LOGIN loginId WITH PASSWORD = 'loginpwd'
            GO
            use msdb
            GO
            create user userId from LOGIN loginId;
            GO
            EXEC sp_addrolemember 'SQLAgentUserRole', 'userId'
            EXEC sp_addrolemember 'SQLAgentReaderRole', 'userId'
            EXEC sp_addrolemember 'SQLAgentOperatorRole', 'userId'
            GO
            use mfreportsdbAN
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT ALTER ANY DATABASE DDL TRIGGER TO userId
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER,VIEW Definition TO userId
            GO
            use mfaccountsdb
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT ALTER ANY DATABASE DDL TRIGGER TO userId
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER,VIEW Definition TO userId
            GO
            use mfconsoledb
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT ALTER ANY DATABASE DDL TRIGGER TO userId
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER,VIEW Definition TO userId
            GO
            use admindb
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER TO userId
            GO
            use vpnsdb
            GO
            CREATE SCHEMA vpnsdb;
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER TO userId
            GO
            use idconfigdb
            GO
            create user userId from LOGIN loginId;
            GO
            GRANT CREATE TABLE,CREATE TYPE,CREATE PROCEDURE,SELECT,UPDATE,DELETE,INSERT,EXECUTE,REFERENCES,CREATE VIEW,ALTER TO userId
            GO
        

    Note: The whole script must be run at once.

    Note: The loginId and password must be the same as used for Volt MX Foundry Installation.

    Note: The and provided must be the same across the script and must also be provided at the time of the Volt MX foundry Installation.

    Note: You can use the same loginId and userId to avoid confusion.

    Note: The userId must be same across the script.

  • Issue

    If you do not want to use a DB user with DBA role or Equivalent privileges for the Volt MX Foundry installation on IBM DB2, follow these steps:


    Workaround

    Manual Steps:

    Important: Only DB2 database administrator (DBA) or equivalent DB user will have access to a create database.

    1. Create a user based on your Operating System level.

      • Refer for linux: Creating group and user IDs for a DB2 database installation (Linux and UNIX)
      • Refer for Windows: Creating a dedicated DB2 user (Windows)

        1. Create databases by logging as Admin with following queries:
          {

        CREATE SCHEMA ADMINDB AUTHORIZATION userid
        CREATE SCHEMA MFCONSOLEDB AUTHORIZATION userid
        CREATE SCHEMA MFACCOUNTSDB AUTHORIZATION userid
        CREATE SCHEMA MFREPORTSDB AUTHORIZATION userid
        CREATE SCHEMA VPNSDB AUTHORIZATION userid

        CREATE SCHEMA IDCONFIGDB AUTHORIZATION userid
        }
        3. Grant database level permissions to the user:

        {  
        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA ADMINDB TO userid;
        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA MFCONSOLEDB<suffix TO userid;
        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA MFACCOUNTSDB TO userid;
        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA MFREPORTSDB TO userid;
        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA VPNSDB TO userid;

        GRANT CREATEIN,ALTERIN,DROPIN ON SCHEMA IDCONFIGDB TO userid;
        }
        4. Grant schema level permissions to the user:

        {
        GRANT createtab,CONNECT,DATAACCESS,IMPLICIT_SCHEMA,ACCESSCTRL ON database TO USER userid;
                }

    Note: The loginId and password must be the same as used for Volt MX Foundry Installation.

    Note: The and provided must be the same across the script and must also be provided at the time of the Volt MX foundry Installation.

  • Issue

    After entering Database details the DB connection fails with the following error:


    Workaround

    The password used for the Database must not contain exclamation marks (!).

  • Issue

    If you are using any lower versions of MySQL 5.7 such as v5.7.12 or lower during installation, you may encounter an error due to which the installation rolls back. This error occurs due to a bug in the MySQL database.
    For more information, refer MySQL Bugs

    Following are the error details:

    • Error: Migration V810_27_01__DeleteDuplicateAcsUserIdProviderGuidRowsAddUniqueConstraint.sql failed
    • SQL State: HY000
    • Error Code: 1093
    • Error Message: You can't specify target table 'users' for update in FROM clause
    • Location:


    Workaround

    To resolve this issue, refer Prerequisites for Volt MX Foundry with MySQL- Applicable for Identity Services.

Hostname/Port changes for Tomcat Application Server

Volt MX Foundry On-Premises Installer provides a script to change the Hostname or Port of the installed Volt MX Foundry instance. In your installed Tomcat Application Server, you must also perform the following changes:

In //tomcat/webapps/apiportal/WEB-INF/classes/config.properties, replace the existing URL with the new URL in the following fields:

  • VOLTMX_ACCOUNT_API_BASE_URL=
  • VOLTMX_DEVELOPER_PORTAL_BASE_URL=

In //tomcat/webapps/mfconsole/WEB-INF/classes/config.properties, replace the existing URL with the new URL in the VOLTMX_ACCOUNT_API_BASE_URL= field.

In //tomcat/conf/server.xml, replace the port number with the new port number in the <Connector server="VoltMX" port= field.

In //tomcat/webapps/accounts/WEB-INF/classes/accounts.properties, replace the port number with the new port number in the following fields:

  • VOLTMX_INTEGRATION_SERVICE_PORT=
  • VOLTMX_MESSAGING_SERVICE_PORT=

Hostname/Port changes for JBoss Application Server

Volt MX Foundry On-Premises Installer provides a script to change the Hostname or Port of the installed Volt MX Foundry instance. The script can be found in the installation folder. In your installed JBoss Application Server, you must follow the instructions in the script and also perform the following steps:

  1. In the standalone.xml file replace the IP address/port number with the new IP address/port number.
  2. In mfconsole.war\WEB-INF\classes\config.properties, replace the existing URL with the new URL in the VOLTMX_ACCOUNT_API_BASE_URL= field.
  3. In apiportal.war\WEB-INF\classes\config.properties, replace the existing URL with the new URL in the following fields:
    • VOLTMX_ACCOUNT_API_BASE_URL=
    • VOLTMX_DEVELOPER_PORTAL_BASE_URL=
  4. In accounts.war\WEB-INF\classes\accounts.properties, replace the port number with the new port number in the VOLTMX_INTEGRATION_SERVICE_PORT= field.

How to Configure JBoss Cluster

How to Configure Heap and PermGen Size

Configuring Heap and PermGen Size for Tomcat

By default, the heap settings for Tomcat allocated are Min -Xms1024m / Max - Xmx2048m, and default permgen settings are: -XX:PermSize=1024m -XX:MaxPermSize=1024m

For better performance in case of several publishes, update the following heap and permgen settings  in the file: {Installation directory}/tomcat/bin/catalina.sh

  • heap settings: Min -Xms1024m / Max - Xmx1024m.

    Important: While installing Volt MX Foundry Components including Integration services, set the heap settings to: Min -Xms2048m / Max - Xmx2048m.

  • permgen settings : -XX:PermSize=1024m -XX:MaxPermSize=2048m

Configuring Heap and PermGen Size for JBoss

In case of multinode, do the following:

  • Configure the Min -Xms2048m / Max - Xmx4096m heap settings in the file: { Server directory }/domain/configuration/host.xml
  • Configure the Min -Xms2048m / Max - Xmx4096m heap settings in the file: { Server directory }/domain/configuration/domain.xml
  • Configure permgen settings : -XX:PermS