Public Repository

Last pushed: a month ago
Short Description
OSCM enables turning on-premise software into Software as a Service for using it in the Cloud.
Full Description

Welcome to Open Service Catalog Manager!

Open Service Catalog Manager (OSCM) is a set of services which provide all business-related functions and features required for turning on-premise software applications into Software as a Service (SaaS) offerings and using them in the Cloud. This includes ready-to-use account and subscription management, online service provisioning, billing and payment services, and reporting facilities. For quickly getting an idea of what OSCM is capable of, please watch the videos. More details can be found in the OSCM documentation.

How to Use this Image?

To pull the image from the DockerHub repository:

The following description is intended also for people without previous Docker experience and is exemplified using Docker Toolbox on a Windows machine.
The OSCM Docker image requires at least 4GB RAM and at least 3GB disk space, so please ensure that the machine hosting the Docker environment supports it.

  1. To install a Docker environment, if you do not already have one, please use one of the supported installation options, depending on the platform where you want to host the image. More about the docker hosts can be found in the docker official documentation.

  2. Once the installation is complete, start the Docker Quickstart Terminal of the Docker Toolbox.

  3. Connect to the Docker virtual machine:
    docker-machine ssh default

  4. Test the DockerHub connection:
    docker search hello
    The output you'll see should look like:
    hello-world Hello World! (an example of minimal Docker... 26 [OK]

  5. Pull the OSCM Docker image from DockerHub to your Docker virtual machine:
    docker pull servicecatalog/oscm
    If everything worked so far, you're ready to run the OSCM Docker image, please see the related section below.

NOTE: If you have connection problems, the cause may be an incorrect or missing proxy configuration. Please see the proxy configuration guide in this case.

To run the OSCM Docker container:

docker run -it -p 8080:8080 servicecatalog/oscm

ATTENTION: Please do not press ENTER, otherwise you will stop the Docker container. Use <ctrl><p> <ctrl><q> instead.

NOTE: If you need to use your own custom ports or expose the HTTPS or Glassfish administration ports, please see the host and ports setup guide.

To configure OSCM to be accessible by localhost:8080:

OSCM is configured by default to be accessed using localhost:8080. Since we use Docker on a Windows host machine (and we want to access the Docker virtual machine using a browser located on the Windows host machine), we need to map the localhost:8080 of the Docker virtual machine to the localhost:8080 of the Windows host machine. To that, you can use the VBoxManage application contained by the Docker Toolbox, by default located in:
c:\Program Files\Oracle\VirtualBox>VBoxManage

Please enter the following command:
c:\Program Files\Oracle\VirtualBox>VBoxManage controlvm default natpf1 "rule1,tcp,,8080,,8080"

NOTE: If you want to access OSCM using the IP address of the Docker virtual machine instead of localhost, you need to first configure OSCM to use it. Please see the host and ports configuration guide for that.

To use OSCM:

Great! So you finished setting up OSCM. What next?
The servicecatalog/oscm image contains test data which allow you to carry out the basic usage scenarios of OSCM.

The simplest way to start clicking around in the OSCM marketplace, to subscribe to the offered services, register users for the organization and assign them to the created subscriptions, is to login as an administrator of a customer organization with customer/secret to the:

If you would like to act as technology manager and service manager in order to import/define services on the platform, prepare them for publishing on a marketplace (define their price model, resale model) and finally activate them to be ready for subscription, please use admin/secret to login to:

Log in as a platform operator using administrator/admin123 in order to configure OSCM, register new organizations with different roles, create marketplaces and so on:

For quickly getting an idea of what OSCM is capable of, please watch the videos. For more detailed information please see the OSCM documentation.

To use the OSCM emails:
Some of the operations in OSCM require using e-mail (e.g. getting the initial password for a registered user, being notified after successfully subscribing to a service, ...). For this purpose, the servicecatalog/oscm image has an integrated mail server. To check these emails:

  1. start a bash session on your running servicecatalog/oscm image container
    docker exec -it <CONTAINER_ID> bash

  2. and list the files in the /opt/james-<user> directory, where <user> is one of the test users given in the table below. To read an e-mail, simply use:
    $ less <filename> (use q for quit)

User Id Password E-mail
administrator admin123
admin secret
customer secret

We hope you will enjoy OSCM! Have fun!

Docker Pull Command

Comments (0)