9.2

Edit

WorkSpace

Service overview

Software owner The Apache Software Foundation
Management

wfmanager (start | stop | restart | status) workspace_sandbox

wfmanager (start | stop | restart | status) workspace_production
Log files

Access logs:
<INSTALL_DIR>/supervisord/log/workspace_sandbox.out.log
/supervisord/log/ workspace_production .out.log
Error logs:
<INSTALL_DIR>/supervisord/log/workspace_sandbox.err.log
/supervisord/log/ workspace_production .out.log
Startup scripts /supervisord/apps/ workspace_sandbox.ini
<INSTALL_DIR>/supervisord/apps/workspace_production.ini
<INSTALL_DIR>/workspace_sandbox/bin/catalina.sh
/ workspace_production /bin/catalina.sh
Configuration files

General configuration:
<INSTALL_DIR>/workspace_sandbox/conf/
/ workspace_production /conf/
Startup parameters:
<INSTALL_DIR>/workspace_sandbox/bin/setenv.sh
/ workspace_production /bin/setenv.sh
Default Ports

tcp 5080, 6080

Default parameters

Configuration file Name Default Value Description
config.yml

install_dir

 /opt/workfusion Directory to put user files, logs and configs
config.yml

workspace_min_memory

 512M Minimum RAM is required for service
config.yml workspace_max_memory 2G Maximum RAM can be allocated per process
config.yml workspace_sandbox_min_memory 512M Minimum RAM is required for service
config.yml workspace_sandbox_max_memory 2G Maximum RAM can be allocated per process
secrets.yml workspace_license_access_key C7DB7B1B-5CE3-4795-9367-DC4AEAC5E07D
secrets.yml workspace_license_secret_key 00FD8028-3724-47F8-B12B-0CFB0D4502C0
secrets.yml

workspace_db_user

 workspace Database username
secrets.yml workspace_db_pass R^Ie4MBT7^ Password for database username
secrets.yml workspace_sandbox_db_user workspace-sandbox Database username
secrets.yml workspace_sandbox_db_pass NJ%haCuW0w Password for database username
secrets.yml workspace_root_requester_user workfusion Username for requester
secrets.yml workspace_root_requester_pass I#U#koa9Jo Password for requester username

Troubleshooting

  • Check if TCP ports 5080 and 6080 are available.

    Ports may be custom:

    netstat command output

    $ netstat -lntp | egrep '5080|6080'
tcp6       0      0 127.0.0.1:6080          :::*                    LISTEN      4110/java
tcp6       0      0 127.0.0.1:5080          :::*                    LISTEN      4107/java

    ss command output

    $ ss -ltn | egrep '5080|6080'
LISTEN     0      100       ::ffff:127.0.0.1:6080                    :::*
LISTEN     0      100       ::ffff:127.0.0.1:5080                    :::*

    lsof command output

    $ lsof -P -n -i :5080 -i :6080 | grep LISTEN
java    4107 wfuser   56u  IPv6  16130      0t0  TCP 127.0.0.1:5080 (LISTEN)
java    4110 wfuser   56u  IPv6  12187      0t0  TCP 127.0.0.1:6080 (LISTEN)

  • Check the default main log files.

    Access logs:

    • /supervisord/log/workspace_sandbox.out.log
    • /supervisord/log/workspace_production.out.log

    Error logs:

    • /supervisord/log/workspace_sandbox.err.log
    • /supervisord/log/workspace_production.out.log
    $ tail -f <INSTALL_DIR>/supervisord/log/workspace_sandbox.err.log <INSTALL_DIR>/supervisord/log/workspace_sandbox.out.log

    $ tail -f <INSTALL_DIR>/supervisord/log/workspace_production.err.log <INSTALL_DIR>/supervisord/log/workspace_production.out.log

  • Check workspace out (access) log using the Wfmanager util.

    wfmanager tail workspace_sandbox

    wfmanager tail workspace_production

    Additional logs are stored in the service's log directory:

    ${install_dir}/workspace_*/logs/

    catalina.DATE.log
gc.log
host-manager.DATE.log
localhost.DATE.log
localhost_access_log.DATE.txt
manager.DATE.log
workspace-sandbox.log
workspace-production.log

  • Check the permissions and full path access to the files accessed by WorkSpace.

    $ namei -om /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox/WEB-INF/web.xml
f: /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox/WEB-INF/web.xml
 dr-xr-xr-x root   root   /
 drwxr-xr-x root   root   opt
 drwxr-x--- wfuser wfuser workfusion
 drwxr-xr-x wfuser wfuser workspace_sandbox
 drwxr-x--- wfuser wfuser webapps
 drwxr-x--- wfuser wfuser workspace-sandbox
 drwxr-x--- wfuser wfuser WEB-INF
 -rw-r----- wfuser wfuser web.xml
← PreviousNext →