This document describes some utilities that can be invoked using the scripts from the webAppOS/dist/bin directory.
This is the main script, which launches the webAppOS server.
This script is useful to generate Java classes from the given ECore metamodel. The generated Java classes can then be used as a means to access web memory objects as if they were native Java objects.
ecore2java [metamodel].ecore [directory/for/generated/src]
The nsPrefix value from the .ecore file will be used as a package name for the generated Java classes.
This script is useful to generate Java classes from the given metamodel in the .mmd format. The generated Java classes can then be used as a means to access web memory objects as if they were native Java objects.
The .mmd format is a textual format developed at the Institute of Mathematics and Computer Science, University of Latvia, by Sergejs Rikacovs. We use a subset of that format. The whole description can be found at https://www.lu.lv/materiali/apgads/raksti/733_pp_75-102.pdf.
mmd2java [metamodel].mmd [directory/for/generated/src] [java.package.name]
Since the .mmd file does not have a construction to specify any prefix or package name, the mmd2java utility expects that you provide as the third argument a package name for generated Java classes.
The mmd2java utility uses mmd2ecore and ecore2java. Normally, you should not invoke mmd2ecore by hand.
The adminutil tool is a convenience tool for webAppOS server administrators. It provides functionality to modify the webAppOS registry to perform some specific tasks such as user management and mount point management for remote file systems. For instance, the administrator can obtain the list of registered, but blocked users waiting for the manual approval. Then the administrator can unblock them (either one-by-one or as the list).
The adminutil tools comes with the built-in documentation. The following command displays it.
adminutil help
This utility is useful when you wish to edit the webAppOS registry manually, e.g., to generate some ws_tokens for webAppOS users. It is also useful to generate password hashes manually. To generate a password hash, invoke sha256gen on a string, which is a concatenation of the desired password + salt (the salt has to be stored along with the generated hash in the xusers branch for the given user in the webAppOS registry).
sha256gen some-string