Starting the Admin Tool

Login

Most of the ConSol CM system is managed using the Admin Tool. By default, the Admin Tool is available as a Java Web Start application on the start page of the CM application server. To start the Admin Tool, you can either use the link on the page, or you can store the jnlp file locally and start it there.

If Java Web Start is not available on your computer, please contact the ConSol CM support or your ConSol CM consultant. They can provide a local Java application which does not require Java Web Start. Remember to set the host name and port of your ConSol CM installation and, if you are using a Windows operating system, the path to the Java Runtime Environment in the start script delivered with the application.

After clicking cm-admin-tool.jnlp, the jnlp file is downloaded, the Admin Tool is started, and the login window is displayed.

Refer to the Troubleshooting: When the Admin Tool Does Not Start section, if the Admin Tool does not start.

Enter your login data (user name and password) to get access to the Admin Tool functions. An initial user name and password are created during system set-up. Further admin users can be configured later on in the Admin Tool.

After you have logged in successfully, the start page of the Admin Tool with basic information about the system is displayed.

Troubleshooting: When the Admin Tool Does Not Start

Correct Process Using Java Web Start

If everything is set up properly, clicking on the Admin Tool hyperlink leads to the following:

1. In a pop-up window, you are prompted as to whether you would like to open the jnlp file - Java (TM) Web Start Launcher should be offered as default application for that - or to download the jnlp file to your system.
   Confirm with Open with Java (TM) Web Start Launcher.
2. The download of the Admin Tool jnlp file is started. During this process, the ConSol CM logo is displayed.
3. Java Web Start starts the Admin Tool. In a pop-up window the Verifying application message is displayed.
4. If the Java Web Console is activated, the console is opened and you can follow the progress.
5. The Admin Tool GUI is displayed with the login window in the foreground.

Process with Errors Using Java Web Start

If the Admin Tool cannot be started, check the following settings:

1. Problems with step 1:
   1. Is a supported version of Java installed on your machine?
      You can find a list of supported Java versions in the System Requirements.
   2. Is the correct Java version activated?
      Under Microsoft Windows use System settings -> Java -> Java -> Display ...
2. Problems with step 2:
   1. Can your client machine connect to the ConSol CM server over the network? Can the jnlp file be downloaded by the web browser?
   2. Check the Java Network connection settings.
      Under Microsoft Windows use System settings -> Java -> General -> Network settings.
3. Problems with step 3:
   1. Does Java Web Start load and verify all Admin Tool application files? If not, check the network connection.
   2. For all other errors, a pop-up window with a detailed error message will be displayed.
4. Notes concerning step 4:
   1. To find the cause of a problem, activate the Java Console.
      Under Microsoft Windows use System settings -> Java -> Extended -> Display console, Debugging: Tracing enabled, Debugging enabled.
5. Problems with step 5:
   
   1. When the login window is displayed, enter your login data. If a connection error occurs then, check the proxy settings.

Correct Process Using the Local Java Application

Before starting the Admin Tool for the first time, you need to perform the following steps:

1. Unzip the file which you obtained from the ConSol CM support or your ConSol CM consultant.
2. Open the start script with a plain text editor, e.g., Notepad++. For Windows, the file is called start_admintool.bat and for Linux it is called start_admintool.sh.
3. Make the following settings:
   • Enter the path to your Java Runtime Environment executable (java.exe) in the line containing Java= (only Windows).
   • Enter the name of the host (without the protocol) in the line containing Host=.
   • Enter the port in the line containing Port=.

Start the Admin Tool:

• On Windows: Double-click the start_admintool.bat file. A command line window is opened and the Admin Tool is started. Do not close the command line window, as this will close the Admin Tool.
• On Linux: Execute the start_admintool.sh with the -java command. The JRE executable needs to be part of the path. The Admin Tool is started.

Process with Errors Using the Local Java Application

If the Admin Tool cannot be started, check the following:

• Is a supported version of Java installed on your machine?
  You can find a list of supported Java versions in the System Requirements.
• Is the correct Java version activated?
  Under Microsoft Windows use System settings -> Java -> Java -> Display ...
• Is the correct Java version set in the start script (Windows) or part of the path (Linux)?

If the Admin Tool can be started, but you cannot log in, check the following:

• Are the correct host name and port set in the start script?
  Remember to provide the host name without protocol, e.g., myhost.consol.de.
• Do you have the Java application for the correct CM version?
  The CM version is stated in the file name of the jar file.
• Does the CM version set in the start script match the version of the ConSol CM server which you are connecting to?
• Can your client machine connect to the ConSol CM server over the network?