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.
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.
Once the installation is complete, start the Docker Quickstart Terminal of the Docker Toolbox.
Connect to the Docker virtual machine:
docker-machine ssh default
Test the DockerHub connection:
docker search hello
The output you'll see should look like:
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
hello-world Hello World! (an example of minimal Docker... 26 [OK]
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
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
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:
Please enter the following command:
c:\Program Files\Oracle\VirtualBox>VBoxManage controlvm default natpf1 "rule1,tcp,127.0.0.1,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:
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:
start a bash session on your running servicecatalog/oscm image container
docker exec -it <CONTAINER_ID> bash
and list the files in the /opt/james-18.104.22.168/apps/james/var/mail/inboxes/<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
We hope you will enjoy OSCM! Have fun!