Cannot get /ard/flow-storage API to start for ARD Hub

Document ID : KB000115554
Last Modified Date : 21/09/2018
Show Technical Document Details
Question:
I get the following error in tomcat manager console:
FAIL - Application at context path [/ard/flow-storage] could not be started FAIL - Encountered exception [org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/ard/flow-storage]]]

I cannot find any log files. I followed the directions found in docops and here is where I strayed from those instructions:
Settings Location: Default: %HOMEPATH%\.ard. Typically, there is no need to change the default value. Even though %HOMEPATH%\.ard resolved to my newly created folder in my user directory, it created a C:\Program Files\Apache Software Foundation\Tomcat 8.5\%HOMEPATH%\.ard directory and none of the services would start. So I redid my config in ARD and hardcoded C:\Users\\.ard and was able to get three of the four working. Verify that the .ard folder contains a file settings.source, and that the file contains the address of the .ard folder. That file was not created. I tried manually creating the settings.source file to see if that would work and it didn't. I undeployed all and redeployed with same result. The IMS db tables are created and that service starts. So I don't think it is an issue with MSSQL
Answer:
When the micro-service initially starts, it pushes out the required tables needed for the database. If it cannot establish a connection with the database, the service will not start. I also found out that the first step in the documentation is wrong. There is no need to create the %HOMEPATH%\.ard. This is a hold over from the beta version. When you launch ARD and enter the needed ARD Hub Configuration information, ARD will create the directory and required files. The default path for this is C:\Windows\System32\config\systemprofile\.ard. Here you should have a conf and logs sub-directories.