The dm Server Admin Console is a Web application for managing a single instance of dm Server. Using the Admin Console, you can:
- View an overview of the dm Server properties.
- View and manage the lifecycle of artifacts already deployed to the dm Server instance. Artifacts include bundles, configuration files, PARs, and plans. Lifecycle management tasks include starting, stopping, refreshing, and uninstalling the artifacts.
- Install new artifacts to dm Server. .
- View the properties of the configuration artifacts deployed to dm Server.
- View details of dump files that dm Server might have generated after encountering a problem. This feature is particularly valuable if dm Server fails to install a new artifact due to resolution failures; the dump inspector can help you discover the exact artifact causing the resolution failure.
- View an overview and details of the OSGi State of dm Server, or in other words, a list of all bundles currently installed in dm Server and their state. You can then then drill down into the details of each bundle, such as its symbolic name, packages it imports and exports, services it provides and consumes, and so on. You can also view the bundles that were deployed when an exception that generated a dump occurred.
To use the SpringSource Admin Console, start the SpringSource dm Server and then enter the following URL in your browser of choice.
http://localhost:8080/admin
Replace localhost with the hostname of the computer on which the SpringSource dm Server is running if it is not the same as the computer on which you are running your browser.
The Admin Console uses basic authentication, therefore you will need to enter the default administration ID and password.
ID: admin Password: springsource
The following graphic shows the main page of the Admin Console.
Use the links at the top of the console to perform various tasks, such as viewing and managing artifacts (Artifacts), viewing the properties of deployed configuration artifacts (Configuration), viewing details of dumps (Dump Inspector), and viewing the OSGi state of the dm Server instance (OSGi State).
You can always return to the main Admin Console page by clicking Information in the top right-hand corner.
The Server Properties section provides information about dm Server itself, such as details about the Java Virtual Machine (JVM), the operating system on which dm Server is installed, the time zone configured for the computer, and the complete version of dm Server.
To change the ID and password for the Admin Console, update the SERVER_HOME/config/com.springsource.kernel.users.properties file. First specify the administration username by changing the value of the role.admin property. Then set the password of this new user by adding a new property called user.username, where username refers to the actual name of the user. Finally, restart dm Server for the changes to take effect.
For example, if you want change the administration username to juliet with password capulet, change the file as follows:
################## # User definitions ################## user.juliet=capulet ################## # Role definitions ################## role.admin=juliet
The Admin Console always runs against the admin role.