Web Services API (mPower) Server

Server Preparation

System Requirements

Review the mPower Server hardware and software requirements in mPower System Requirements. You must install and configure all required software before installing the mPower program files.

LeasePak Server

The mPower server requires an installed and working LeasePak server. Refer to documentation in the System Administration Guide for more information.

Web Services API (LinkIT) User

mPower applications require setting up a LinkIT user on the LeasePak Server.

To set up a LinkIT user:

1. Set up a typical LeasePak user.
2. Add access to Application Tracking by giving the user a profile in Application User Profile [U0831].
3. On the mPower server, after installing the mPower software , configure the web.xml file (located in the mpower/WEB-INF directory) with the LinkIT user name (the apiuid) and password (the apipwd). For more information, refer to mPower Configuration (select from the navigation on the left).

mPowerd Daemon on the LeasePak Server

You can install the mPower server on its own machine or on the same machine as the LeasePak server. In either case, you must set up the mPowerd daemon on the LeasePak server. For more information about daemons and services, refer to the System Administration Guide.

On the LeasePak server:

All OS Platforms: create entry in /etc/services

official_service_name port_number/protocol_name [aliases] [#comment]

Create an entry in the /etc/services file using the following format:

official_service_name

Must be unique for the server. For example, mPowerd__.

port_number/protocol_name

The port number must be greater than 1023 and unique for the server. By default . The protocol name is tcp.

Example:

mPowerd__ /tcp  # mPower  mPowerd /opt/msi/

Multiple concurrent versions: if you have more than one version of mPower installed on the same server, each installation requires its own entry in /etc/services with a unique service name and port number.

  HP and Sun: inetd.conf or xinetd.d

Create an entry in the /etc/inetd.conf file. The entry or file consists of one line. Delimit fields with a space or tab. If you need to continue the entry on a second line, end the first line with a backslash (\).

Example:

mPowerd__ stream tcp nowait root \
	/opt/msi//live/bin/mPowerd mPowerd \
	-d /opt/msi/ -l /opt/msi//log/mPowerd.log -f /opt/msi \
	//etc/hostname__rt.lpkd

where hostname is the name of your LeasePak server machine.

 Linux: service_name in /etc/xinetd.d directory

Create a file in /etc/xinetd.d where service_name is the official service name (official_service_name) from /etc/services. From the above example the name would be mPowerd__.

Example:

# mPowerd v53a daemon
service mPowerd__{
	  disable         = no
	  id              = mPowerd__	  socket_type     = stream
	  user            = root
	  server          = /opt/msi//live/bin/mPowerd
	  wait            = no
	  protocol        = tcp
	  port            = 	  server_args     = -d /opt/msi/ -l /opt/msi//log/mPowerd.log -f /opt/msi//etc/hostname__rt.lpkd
}

where hostname is the name of your LeasePak server machine.