Hosted Server
The following guides provide information on how to access Formbird admin functions on the hosted Formbird Server.
Commands
The following are a list of command line, shell script commands that directly relate to the administration of the Formbird hosted server environment. The shell scripts are located in the directory /formbird/utils
fb
By starting a command with "fb" will operate that comand under the formbird user. The formbird user is a restricted account that does not have shell login for security purposes. Therefore by using the "fb" before the command the following command runs under the formbird user. Particularly useful for monitoring the pm2 (node) processes running under the formbird user.
fb pm2 list
fb pm2 kill
fb pm2 monit
fb pm2 logs
fb pm2 logs system-actions
fb pm2 help
fb-app-restart
Restarts the formbird application server and oter related processes controlled by the PM2 processes.
fb-app-restart
fb-db-restore
Initialises an environment by loading the dump file and performinig an elasticsearch indexing on the newly imported database. Parameters: dbName dbDumpDirectory
fb-db-restore formbird-dev ./formbird-dev-dmp
fb-db-reindex-dump
Performs an elasticsearch reindex by mongo dumping, removing the db and re-importing the dump. As this performs the initial dump - the mongo indexes are maintained. Parameters: dbName
fb-db-reindex-dump formbird-dev
gui-resart
Perform a restart on the gui. This may be required from time to time if you have in-advertantly locked it up, or multiple users are accessing the single environment. The restart of the gui does not cause any data loss.
gui-resart
gui-stop
Used to totally stop the gui. Reducing load on the server and further increasing security ie. by removing a potential access point.
gui-stop
server-name
Display the full server name from a database backup point of view. Servers are backed up based on the name of the server and the mac address of the primary interface.
server-name
Log Files
Log files are located under /formbird/logs each are symbolic links to the real log directory. eg. the formbird app logs can be found at /formbird/logs/formbird-app listed based on the name of the pm2 process and either -out or -error
BIRT Report Files
The BIRT report files can also be found under /formbird/reports this too is a symbolic link to the default directory for birt reports under the web BIRT web server.