User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

OnlineCtl

OnlineCtl is a command line tool used mostly for performing ONE Runtime Server-related tasks. It is launched by running <ATACCAMA_HOME>/bin/onlinectl.[bat|sh].

If you run OnlineCtl without any parameters, you get a short summary of options and commands available to you depending on your product, like the one shown here.
Autogenerated OnlineCtl options and basic commands
Usage: java com.ataccama.dqc.server.bin.OnlineCtl <options> <command>
  Options:
    -hostname       hostname or IP address of the online server
    -port           service port used for internal communication
    -secret         secret used for secret authentication method
    -username       user for password authentication method
    -password       password used in password authentication method
    -config         path to configuration file with server details
    -license        path to license file which should be used for online
                    mode
  Basic commands:
    listServices    Displays list of services being hosted.
    password [-aes|-des|-desede] passphrase
                    Uses DES or AES cipher to create the hash for the
                    password given as second argument.
    refresh         Refreshes versioned filesystem folders.
    reloadServices  Reloads the configuration for online services.
    start           Starts the online services.
    status          Displays whether the server is online or not.
    stop            Stops the online services.

The target server always has to be specified. This can be done in one of two ways:

  • Using a path to the server configuration (the config option; only applicable for servers running on your local machine).

  • Using -hostname and -port options.

OnlineCtl commands

The following are basic OnlineCtl commands available with any product. Product-specific commands are described in the documentation for these products. A Linux OS is assumed.

start

Starts the online server and services defined in the configuration files described in the given server configuration file.

onlinectl.sh -config default.serverConfig start

stop

Stops the currently running online server and all its services. In the first example here, the server configuration file is provided in order to get the server port number and authentication configuration.

onlinectl.sh -config default.serverConfig stop
onlinectl.sh -hostname localhost -port 7777 stop

refresh

Instructs the server to load data from folders specified under Versioned File System Component. Once the new versions of files are completely loaded and validated, the server (online services, plans) starts using them.

onlinectl.sh -config default.serverConfig refresh

reloadServices

Instructs the sever to reload the online service configuration. The server looks for files with a .online extension in the configFolder of the Online Services Component.

The services defined in the files that have been deleted are stopped, the services defined in the new files are started, and the services defined in the files that existed before the refresh command was executed reload all of their configuration files (.comp or .plan files).

While the modified services are being reloaded, all services still respond to incoming requests with the old configuration until the new configuration is successfully loaded. Once it is loaded, service requests are redirected to the new configuration and the old one is released from memory.

If it is not possible to load some of the new configuration (for example, because of a configuration error, insufficient memory or disk space, network problems when connecting to the databases), the server switches completely to the previous configuration that worked before the command was invoked. That is, all changes in the services defined in all .online files remain in the same state as before and you have to invoke the refresh command again after you fix the problem.

onlinectl.sh -config default.serverConfig reloadServices

status

Indicates whether the online server is running or not.

onlinectl.sh -config default.serverConfig status

listServices

Lists the services running on the online server (when the server is running).

onlinectl.sh -config default.serverConfig listServices

password

Prints an encoded password to the output. Optionally, it is possible to select the encryption method used.

You can use this encoded password string in the configuration of FileBasedIdentityProvider to set the password for a user.

onlinectl.sh  [-aes|-des|-desede] passphrase

OnlineCtl security

If the Server Configuration file defines the usage of password-protected access to the server and services, you have to use the -secret or -user and -password command line options for all commands except the start command. Otherwise, the command is not executed and a "Not authorized access" error is reported in the log. See Server Security.

Use the Authentication Service Component, which is the recommended solution for password-protected access to the server.

Was this page useful?