Troubleshooting the product installation

Several problems and solutions are provided to help you troubleshoot your AS4 Microservice installation.

Problems and solutions for file system permissions
System storage uses a shared file system. All of the components that use storage must have read and write permissions to the shared file system.
Problems and solutions for starting catalog and container members
The catalog members must be running for the system to function properly. If the catalog members stop or must be restarted, the corresponding container members must also be restarted.
Problems and solutions for preventing WebSphere eXtreme Scale container OutOfMemory error during startup
Test test When multiple WebSphere eXtreme Scale container members are started concurrently, some containers may become overloaded with data, causing one or more container members to run out of memory and terminate ungracefully. If this occurs, AS4 Microservices may become unavailable.
Problems and solutions for preventing WebSphere eXtreme Scale container from hanging during shutdown
When multiple WebSphere eXtreme Scale container members are shut down concurrently, some containers may become overloaded with data, causing one or more container members to run out of memory and terminate ungracefully. If this occurs, the remaining WebSphere eXtreme Scale container members may hang during shutdown.
Problems and solutions for starting a member of a node
If a member of a node of AS4 Microservice does not start, you can resolve the problem by deleting the workarea subdirectory of the installation directory for that member.
Problems and solutions for starting members when the data grid is not online
The data grid must be online for the members to function properly. If the data grid is online and the members are not functioning properly, the members might not be active.
Problems and solutions for deactivating and enabling catalog members
Cannot enable a Catalog member after it is deactivated.
Problems and solutions for accessing databases
Access to the database that you use with AS4 Microservice is controlled by a password that you configure during the installation of AS4 Microservice.
Problems and solutions for starting or logging into the user interface
If there is a problem with the installation, the user interface does not function properly. The most common symptom is that users cannot log in to the user interface.
Problems and solutions for installing WebSphere MQ
When you install AS4 Microservice, you are prompted for information about WebSphere® MQ. Two of the things you are prompted for are user name and password. These credentials are the user name and password for the box on which WebSphere MQ is installed. These credentials are not the credentials for accessing WebSphere MQ.
Problems and solutions for accessing WebSphere MQ
Access to the WebSphere MQ installation that you use with AS4 Microservice is controlled by a password that you configure during the installation of AS4 Microservice.
Problems and solutions for exchange profile not found for outbound flows
There are several reasons why exchanges might fail, some are system-related, some are network-related, some are configuration-related.
Problems and solutions for outbound side receives business error as response
There are several reasons why exchanges might fail, some are system-related, some are network-related, some are configuration-related.
Problems and solutions for the passphrase for the Sterling B2B Integrator bridge adapters
The system passphrase in AS4 Microservice is set by default to “The default passphrase”. There is no user interface to change this passphrase.
Troubleshooting installation - validate installation
If there are problems with the installation, the symptoms are widespread. Many parts of the system are not going to work and there are various WebSphere MQ and WebSphere eXtreme Scale errors in the logs. If you are having systemic problems, use this list as a set of items to validate to troubleshoot the installation.
Problems and solutions for version mismatch
When a user logs in to AS4 Microservice, the version number of the user interface must match the version number of the database schema of the informational member.
Problems and solutions for upgrading
You might not be able to run AS4 Microservice if an upgrade does not delete the temporary workarea directory for all members of the installation.
Problems and solutions for opening the Install Manager during an installation on Linux
You are unable to execute the launchpad.sh file to install, run, or configure the Installation Manager on a Linux system.

Parent topic: Troubleshooting