Starting and stopping the BMC Digital Workplace Catalog server
A system administrator can run these commands to start and stop the BMC Digital Workplace Catalog server to refresh an installation, to correct configuration issues, or for other administrative reasons.
To start and stop the server
Note
If you installed BMC Digital Workplace Catalog as a non-root user, then a non-root user must start the application server. If you start or restart the application server as the root user, then the root user writes the lock files to create a mixed installation directory, and prevents a non-root user from being able to upgrade the application later.
Change to the
installLocation
folder specified in options.txt.Replace
installLocation
with the value specified in options.txt, for example,/opt/bmc/digitalworkplace.
Example[root@server-example install]# cd /opt/bmc/digitalworkplace
Run one of the following commands:
Command Description ./dwpcontroller start
To start the server and be prompted for credentials, see To start the server with manual prompting (below).
To start the server without prompts, see To start the server without being prompted for credentials (below).
Note: If BMC Support is helping you to migrate your data, start the system by using the
./bin/arsystem start
command../dwpcontroller stop
Stops a running server instance. ./bin/arsystem start
Start the platform server without starting the application, for the purpose of migrating data from an earlier release.
To start the server with manual prompting
To show you what to expect when you start or restart the server, see the following for typical messages from a healthy startup.
Run the command to start the server.
Example[root@server-example digitalworkplace]# ./dwpcontroller start
Enter the
BMC_DWP_USER
andBMC_DWP_PASSWORD
, for example,dwpadmin
/dwppassword
.
The system shows diagnostic messages as it waits for resources to become available. After about 15 minutes, the system should return to the terminal prompt.Note
The following messages are normal and are not cause for alarm.
Message Comment 9988 not yet up
The installer polls the application server port repeatedly during startup. Command: SET ESCALATION ... ReturnCode: ERROR Status List : 1 items Status Struct : Message type : ERROR Message number : 366 Message: Escalation does not exist on server Appended: RSR:TriggerUserSync
The missing escalation is not related to the application. After the startup process completes, open the application URL in a web browser to test the application.
Browser location: http://BMC_DWP_SERVER_NAME:8008/myitsbe
Examplehttp://digitalworkplace_catalog-example.com:8008/myitsbe
To start the server without being prompted for credentials
For security reasons, the dwpcontroller start
command prompts you to enter the credentials for the administrative user and password specified in the options.txt file as BMC_DWP_USER
and BMC_DWP_PASSWORD
.
To avoid these prompts, you can include the credentials when you run the command to start the server.
Note
The value for BMC_DWP_PASSWORD
must not be blank.
Stop the running application.
Example[root@server-example digitalworkplace]# ./dwpcontroller stop
Run the command appended with user credentials.
Example[root@server-example digitalworkplace]# ./dwpcontroller start -u <BMC_AR_USER> -p <BMC_AR_PASSWORD>
In the following example, the
<BMC_DWP_USER>
is "dwpadmin
" and<BMC_AR_PASSWORD>
is "dwppassword
". Encrypted passwords are not supported.Example[root@server-example digitalworkplace]# ./dwpcontroller start -u dwpadmin -p dwppassword
The server should start up without prompting you for credentials.
After the startup process completes, open the application URL in a web browser to test the application.
Browser location: http://BMC_DWP_SERVER_NAME:8008/myitsbe
Examplehttp://digitalworkplace_catalog-example.com:8008/myitsbe
Troubleshooting startup issues
If you experience any issues with system startup, review the file /opt/bmc/digitalworkplace/db/sb-start.log for errors. For examples of log messages that can assist your troubleshooting, see Troubleshooting common BMC Digital Workplace Catalog issues by using log files.
Comments
Log in or register to comment.