The OEMANAGER utility requires two web applications be deployed for access to the management APIs of a Progress Application Server (PAS) for OpenEdge instance. These are the Tomcat Manager (manager.war) and OpenEdge Manager (oemanager.war) web applications.

As a prerequisite, the oemanager command-line utility requires _progress executable. The _progress executable is not packaged along with the PAS for OpenEdge license and you must have one of the following components installed to use the oemanager utility on the same machine:
  • 4GL Dev System
  • Client Networking
  • Query/RESULTS
  • Progress OpenEdge DataServer for Oracle
  • Progress OpenEdge DataServer for MS SQL
  • Progress Developer Studio for OpenEdge
  • Progress Application Server for OpenEdge
  • All four RDBMS products—Personal, Workgroup, Enterprise, or Advanced Enterprise
Note: If it is not possible to install the required component on the same machine, you can run the oemanager utility against a remote PAS for OpenEdge instance from a machine that has the necessary components installed. For example, run the oemanager utility from a development or staging environment which has the necessary licenses and network access to the target PAS for OpenEdge instance.
To use the OEMANAGER utility, follow these steps:
  1. Deploy the manager and oemanager web applications.

    You can use the -f switch to deploy both web applications when you create the instance using pasman or you can use the tcman deploy command for an existing instance.

    The following example uses pasman to create a new PAS for OpenEdge instance and deploys the required web applications using the -f switch:
    pasman create -v -f -p 8820 -P 8821 -s 8823 C:\OpenEdge\WRK\oepas2
    The following example uses tcman for deployment:
    tcman deploy DLC/servers/pasoe/extras/manager.war
tcman deploy DLC/servers/pasoe/extras/oemanager.war
  2. Secure the Tomcat Manager (manager.war) and OpenEdge Manager (oemanager.war) web applications.

    The OEMANAGER utility is a wrapper which accesses the underlying Tomcat Manager and OpenEdge Manager services. You must secure these services first. For more information, see Secure the Tomcat Manager and OpenEdge manager web applications.

  3. Secure the OEMANAGER utility.
    Although you can set the userid and passwd properties to values in the oemanager.properties file (located in the bin directory of the PAS instance), you should not do so, especially on production systems.
    Important: As a best practice, you should only pass the userid and passwd via the command line when executing the utility. To ensure this behavior, set the userid and passwd to blank values in oemanager.properties:
    userid=
passwd=
  4. Start the PAS for OpenEdge instance.

    Navigate to the CATALINA_BASE/bin directory of the PAS instance you created and start it. For example:

    cd C:\OpenEdge\WRK\oepas2\bin
tcman oeserver -start