OperetoBox is delivered as a virtual appliance / container and based on ubuntu operating system . All required libraries and configuration are already fixed and the user only needs to start the virtual machine / container and get working. However, some operations are still requiring the administrator to log into the server host via ssh. Opereto built-in operating system user is opereto


Following are few important opereto related commands:

 Command
Description 
sudo service opereto {start|stop|restart|status}
Start, stop or get the status of opereto service.
tail -f /var/log/opereto/server.log
View local opereto server log.
operetoadmin -h
Opereto server admin utility commands.



Opereto configuration file


Opereto allows to override some system setting by adding custom setting to a YAML based config file located at /var/opereto/lib/opereto.conf as follows:

cluster_storage_type: s3
cluster_storage_name: my-services
cluster_storage_ak: MY_ACCESS_KEY
cluster_storage_sk: MY_SECRET_KEY


Following are optional configurations:

cluster_storage_type
The cluster services storage. Valid values are:
  • local (default) to store on local file system
  • s3 to store on remote AWS s3 storage
cluster_storage_name
cluster_storage_ak
cluster_storage_sk
The bucket name, access key and secret key of the AWS s3 storage for production services. Must be defined if storage type is s3.
cluster_dev_storage_name
cluster_dev_storage_ak
cluster_dev_storage_sk
The bucket name, access key and secret key of the AWS s3 storage for development (sandbox) services. If not specified, production bucket will be used to store also the sandbox services.


cluster_exports_storage_name
cluster_exports_storage_ak
cluster_exports_storage_sk
The bucket name, access key and secret key of the AWS s3 storage to store the export data.


cluster_debug_mode
If true, add debug messages to server/cluster log 
cycle_debug_mode
If true, add cycle engine debug messages to server/cluster log
es_debug_mode
If true, add Elasticsearch debug messages to server/cluster log
testplan_debug_mode
If true, add test plan engine debug messages to server/cluster log
system_log_level
The log level. Valid values are: info, error, warn, debug, fatal. Default is error.
process_ttl
The persistency duration of processes and logs in days. Default is 60d.
registered_processes_timeout
The timeout in seconds for registered processes that did not start by any agent. Default is 600.
keep_unused_agents_timeout
How long to keep offline agents (in seconds). Default is 1200.
keep_unused_envirnments_timeout
How long to keep offline environments (in seconds). Default is 1200.
cookie_expires_days
How many days to keep session cookies before expired. Default is 7.



Opereto license file

Opereto license file should be copied to /var/lib/opereto/.opl



Opereto server must be restarted after configuration or license modifications for the changes to take affect.

service opereto restart