Starting and stopping the CM server
There are two levels to consider for starting and stopping ConSol CM:
- The basic start and stop commands of ConSol CM are adapted start and stop commands of the respective application server, which can be executed on the command line.
- The integration of these commands into an environment which allows automatic system start and stop. You might want to write an init.d or systemd script for a Linux system, or configure CM as a service on a Windows system.
The following section provides information about the simple command line parameters which can be used to start and stop the system.
If the database system has to be restarted, stop the ConSol CM system first, wait until the database system is available again, and then start the ConSol CM application server.
JBoss on Windows
Starting JBoss on Windows
Run the following command to start the JBoss server. Alternatively you can configure JBoss to run as a service (see Installing JBoss EAP as a Windows service).
<JBOSS_HOME>\bin\standalone.bat -P <JBOSS_HOME>\bin\cm6-config.properties -c cm6-<DB>.xml
Replace cm6-<DB>.xml with the configuration file for your database:
- cm6-mysql-5.xml for MySQL 5
- cm6-mysql-8.xml for MySQL 8
- cm6-oracle.xml for Oracle
- cm6-mssql.xml for Microsoft SQL Server
- cm6-postgresql.xml for PostgreSQL
Shutting down JBoss on Windows
Run the following command to stop the JBoss server. Alternatively you can put it into the configuration of the Windows service.
<JBOSS_HOME>\bin\jboss-cli.bat --controller=localhost:9999 --connect --command=:shutdown
If you did not set a system environment variable for the Java home directory, add the path to the JDK to <JBOSS_HOME>\bin\jboss-cli.bat. This prevents Java warnings.
Example for JDK version 11.0.17, replace by your Java version.
set "JAVA_HOME=C:\Program Files\Java\jdk-11.0.17+8"
In case the JBOSS_HOME environment variable is already set in the system, you can specify the server-specific path at the beginning of JBOSS_HOME>\bin\jboss-cli.batin the following syntax:
set JBOSS_HOME='<JBOSS_HOME>'
JBoss on Linux
Starting JBoss on Linux
Run the following command to start the JBoss server for a setup with ConSol CM without CMRF. Alternatively you can put it into a start script (usually init.d or systemd).
<JBOSS_HOME>/bin/standalone.sh -P <JBOSS_HOME>/bin/cm6-config.properties -c cm6-<DB>.xml
Replace cm6-<DB>.xml with the configuration file for your database:
- cm6-mysql-5.xml for MySQL 5
- cm6-mysql-8.xml for MySQL 8
- cm6-oracle.xml for Oracle
- cm6-mssql.xml for Microsoft SQL Server
- cm6-postgresql.xml for PostgreSQL
If JBoss starts normally (ConSol CM Startup appears in the server.log file) but localhost:8080 cannot be reached, try setting <CM_HOST_IP> to 0.0.0.0.
Shutting down JBoss on Linux
Run the following command to stop the JBoss server. Alternatively you can put it into a stop script (usually init.d or systemd).
<JBOSS_HOME>/bin/jboss-cli.sh --controller=localhost:9999 --connect --command=:shutdown
If you did not set a system environment variable for Java, add the path to the JDK to <JBOSS_HOME>/bin/jboss-cli.sh. This prevents Java warnings.
Example for JDK version 11.0.17, replace by your Java version.
JAVA_HOME="/opt/java/64/jdk-11.0.17+8"
In case the JBOSS_HOME environment variable is already set in the system, you can specify the server-specific path at the beginning of <JBOSS_HOME>/bin/jboss-cli.sh in the following syntax:
JBOSS_HOME='<JBOSS_HOME>'
General settings
- In case -b=localhost or -b=127.0.0.1 is set as parameter, ConSol CM is only accessible from the same server, where JBoss is running.
- Enter the network IP or the network name to make ConSol CM accessible from outside the sever. In this case ConSol CM URL is not accessible from the inside using the localhost URL.
- If you enter -b=0.0.0.0 the server is accessible from the outside and inside using the server URL or using the localhost URL (take care of all required security-related precautions!).
- After the server has started, open a browser window and type the server URL to start the ConSol CM setup, see section Setting up the ConSol CM application.