Domibus v4.0-RC1 Admin Console Help
Login
To login to the Administration Console, go to the console URL address.
Default location is http://localhost:8080/domibus/login.
The version number of the Domibus/Administration Console is displayed at the bottom of the Login screen (see picture below):
Connect to the administration console using the credentials of the administrator user (by default: user = admin; password = 123456).
After your first login with the admin user credentials, the system will advise you to change the default password:
Note that it is highly recommended to change the default password for the admin user, for security reasons.
Once you are successfully logged in, the system leads you to the Messages page:
Left Sidebar Menu
The console left sidebar menu provides navigation to all screens available in the Administration Console, as shown below:
Hereafter, a brief description of each main menu items is described:
Messages
On this page, the administrator can see the details of the messages and re-process them if required. The administrator can also navigate through the messages history and download specific messages if needed.
Message Filter
On this page, the administrator can set defined filters and access them individually for edition directly in the list.
Error Log
On this page, the administrator can view the list of application errors, make searches on error messages and filter them.
PMode
On this page, the administrator can upload or download the PMde file. The administrator can edit the list of parties configured in the PMode and access them individually for modification purposes.
JMS Monitoring
On this page, the administrator can monitor and manage the contents of the JMS queues.
Truststore
On this page, the administrator can upload a new truststore to replace the current one.
Users
On this page, the administrator can create and manage users including: grant access rights, change passwords, assign roles, etc.
The Administration Console
Logout
The user needs to first click on the menu icon located at the top right corner of the screen .This menu can be accesssed from any of the Administration Console page.
To log out from the Administration Console, click on the Logout button displayed. Once logged out, the Login Screen is redisplayed.
Filtering
The Administration Console provides a filtering functionality: to activate the filters, click on the Advanced button at the top of the screen, to deactivate them, click on Basic:
Sorting on column
Sorting on columns is available on every screen of the Administration Console. Click on the arrow on the colum header to sort on the needed information.
In the example below, in the Messages page, the list of processed messages can be sorted on any of the columns on the table. By default, messages are sorted with the most recent message at the top.
If you click on the Received column header as shown below, you can sort on the oldest or on the newest message in the list:
Adaptable Columns
Show/Hide columns
The user can adapt the Administration Console screens to display or hide the columns.
Click on Show Columns/Hide Columns at the top right of the screen to see the list of available columns, then check/uncheck the boxes for the columns you wish to hide (uncheck) or show (check) on the screen:
Moving columns on the Administration Console screens
Columns on the Administration Console screens can be moved left or right by simply dragging-and-dropping the column header from one place to another.
Note that the changes you make on the Administration Console screens are not saved if you logout or refresh the screens.
Number of displayed rows
On every screen of the Administration Console you can change the default number of displayed rows (10) by clicking on the drop down arrow located on the upper left part of the screen, just below Row as shown below:
Messages
By default, the Messages screen is displayed after a succesful login to the Administration Console. Details of messages are displayed on the screen, such as party ID, Message ID, Message Status etc.
Use the filtering functionality described above to find a specific message.
To display details of a message, double-click on it:
Re-sending messages
On the Messages screen you can re-send messages. To do so, select the message and click on the Resend button located on the bottom left side of the screen or click on the Action arrow
and then on Resend:
Downloading messages
On the Messages screen you can download messages to a zip file via the browser. To do so, select the message and click on the Downlaod button located on the bottom left side of the screen or click on the Action arrow and then on Download:
Message Filter
On the Message Filter screen, you can define how messages are routed once they have been received. The available options will depend on the plugins you installed.
The two common ones are Web-services plugin and JMS plugin. You can set criterias for each filter you create.
To create a new message filter, click on the New button, fill in the message filter criterias and save by clicking on the OK button:
You can also define the order in which the messages are processed, if there are more than one plugins installed. To do so, create a new message filter with a new selection criteria ( as described above) and then move it up or down as required.
Use the Move up button or up arrow on the filter entry as shown in the image below:
Error Log
On the Error Log screen you have access to the list of application errors. You can apply filters on the displayed errors, define which columns you want to display or hide in the list, etc.
PMode
On the PMode screen, you can modify the party list and/or connection details as needed. To do so you can either upload a new PMode file with the required changes or download the exisiting one, modify it and upload it again.
Uploading PMode
To upload the PMode, click on the Upload button at the bottom of the page, then click on choose file to navigate to the location of the PMode file you want to upload. Click on OK after selection.
Downloading PMode
To download the PMode, click on the Download button at the bottom of the page. The PMode file is automatically downloaded to the download folder of the computer.
JMS Monitoring
In the JMS Monitoring page you can view, monitor, manage and navigate through the content of JMS queues.
All queues and their contents are viewable. You can change the default queue by clicking on the dropdown arrow, below Source:
Messages in the JSM queues can also be deleted or moved to another queue. Note that these actions take effect immediately and cannot be undone.
Delete Messages in a queue
To delete a message, select the message and click either on the Bin icon on right side of the message, or click on the Delete button at the bottom of the page:
Move messages from on queue to another
To move a message, select the message and click either on the Move icon on right side of the message, or click on the Move button at the bottom of the page:
Truststore
In the Truststore screen, you can manage the trusted certificates. You can upload a new truststore to replace the current one and define its password.
Upload New Truststore Certificates
To upload a new Truststore, click on the Upload button and navigate to the location of the file with pop up menu, enter truststore password and click on OK:
Users
On the Users screen, you can create and manage users:
Add a new user
To add a new user, click on the New button at the bottom of the page, fill in the pop-up box with the required values (username, email address, password etc.) and click on the OK button:
Edit a user
To edit a user, select the user, click on the Edit button at the bottom of the page or click on the Edit icon in the Actions column. Make the necessary changes in the pop-up box (username, email address, password etc) and click on the OK button to save your changes.
Delete a user
To delete a user, click on the Delete button at the bottom of the page or select the message to be deleted and click on the Bin icon in the Actions column.
Click on the OK button to delete the user.
Acccount Lockout procedure:
A user account lockout policy has been implemented on Domibus Admin Console. By default, if a user tries to log to the Admin Console with a wrong password 5 times in a row, his account will be suspended (locked):
You can define in the domibus.properties file the number of failed attempts after which a user’s account will be locked.
By default, a user remains suspended during one hour before his account is automatically unlocked and the user can try to log again.
If the user wants his account to be unlocked without waiting the default one hour, he can ask his administrator to unlock the account. To unlock the account, the administrator must change the user’s status on the Admin Console from Suspended to Active.
Select the suspended user and click on Edit:
Re-activate the user (unlock it) by checking the Active status and confirm with OK:
IMPORTANT: Save the changes by clicking on Save on the next window and then on Yes to confirm the change.