Startup and Configuration : Running My webMethods Server from the Command Line : Creating a New Server Instance
Creating a New Server Instance
You can run multiple instances of My webMethods Server on the same machine, but each server instance must have its own external resources. For more information, see Guidelines for Multiple My webMethods Server Instances.
When you start a new instance of My webMethods Server the first time, it takes about five minutes to initialize. The server then shuts down automatically.
Use the following command-line syntax to create an instance of My webMethods Server on the current machine.
To create an instance of My webMethods Server from the command line
1. If you have not already done so, use the Database Component Configurator to create a unique database or tablespace for this server instance, as described in Installing Software AG Products. This step is not required if the server is using the embedded database.
2. At a command line prompt, type the following command to move to the server’s bin directory:
cd Software AG_directory\MWS\bin
3. Type the following command:
mws new [-Dparameter=value...]
where parameter is any of the following:
Parameter
Description
server.name
Name of the server instance. The name must be unique among server instances on the machine. If you do not specify a custom name, the name of the server instance is default.
http.port
Port number on which the server instance listens. The port number must be unique among server instances on the machine. The default port number is 8585.
install.service
Optional. Specifies whether to install a new My webMethods Server instance as an application or a service. The choices are:
*true - install as a service.
*false - install as an application. This is the default value.
db.type
Required for all databases except the embedded database. The type of database used by the server instance. The choices are:
ms
Microsoft SQL Server
oracle
Oracle
db2
DB2
db.url
Required for all databases except the embedded database. Database connection URL, based on the type of database and the driver.
On UNIX systems, you must escape all semicolon characters in the database connection URL with backward slashes, or enclose the whole database URL parameter in double quotes, as follows:
"-Ddb.url=jdbc:wm:database://
host:port;databaseName=name"
db.username
Required for all databases except the embedded database. User name assigned to the My webMethods Server database.
db.password
Required for all databases except the embedded database. Password of the My webMethods Server database user.
https.port
Optional. The HTTPS listener port. A value of 0 disables the listener.
debug.port
Optional. The Java debug port. The default port number is 10033.
http.proxy.host
Optional. The proxy host name.
http.proxy.port
Optional. The proxy port number.
http.proxy.user
Optional. The proxy user name.
http.proxy.password
Optional. The proxy password.
http.proxy.hosts
Optional. Bypass proxy hosts. Separate the entries omitting any spaces and using a vertical bar(| symbol).
server.features
The set of component features configured with the server instance: The choices are:
core
The minimum set of features needed to support development of JSR 168 portlets using Software AG Designer. This is a pure runtime, with a single skin and shell, and no administration or configuration features.
default
The standard set of My webMethods Server features, but without extras or development tools found in the MWS/components folder. This is the default value.
fabric
The default My webMethods Server taxonomy with all installed My webMethods Server user interfaces.
all
The standard set of features plus all components found in the MWS/components folder.
The command creates the instance of My webMethods Server based on the input parameters you have provided.
4. At the same command prompt, initialize the server instance using the following command:
mws -s serverName init
Use the -s serverName option if this is not the default server instance, or you specified a custom name for the default instance during installation. After the database is initialized, the server automatically stops.
5. Start My webMethods Server.
Examples:
Example with an external database:
Server name: test
HTTP port: 8090
Database server (SQL Server): db_server
Database name: my_wm_msql
Database user name: mws_user
Database password: password
> mws new -Dserver.name=test -Dhttp.port=8090
-Ddb.type=ms -Ddb.url=jdbc:wm:sqlserver://db_server:1433;
DatabaseName=my_wm_msql;SelectMethod=direct;MaxPooledStatements=100
-Ddb.username=mws_user -Ddb.password=password
[Configuration output displayed in console window....]
> mws -s test run
Same example, but with the embedded database:
> mws new -Dserver.name=test -Dhttp.port=8090
Copyright © 2004-2017 Software AG, Darmstadt, Germany. (Innovation Release)
Product LogoContact Support   |   Community   |   Feedback