9.1

Edit

Workfusion

Service overview

Software owner The Apache Software Foundation
Version 9.0.x
Management

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

Access logs: ${install_dir}/supervisord/log/workfusion.out.log
Error logs: ${install_dir}/supervisord/log/workfusion.err.log
Startup scripts ${install_dir}/supervisord/apps/workfusion.ini
${install_dir}/workfusion/bin/catalina.sh
Configuration files

General configuration: ${install_dir}/workfusion/conf/
Startup parameters: ${install_dir}/workfusion/bin/setenv.sh
Default Ports

tcp 7080

Default parameters

Configuration fileNameDefault valueDescription
config.ymlinstall_dir/opt/workfusionDirectory to put user files, logs and configs
config.ymlworkfusion_min_memory2GMinimum RAM is required for service
config.ymlworkfusion_max_memory8GMaximum RAM can be allocated per process
secrets.ymlworkfusion_license_filelicense.propertiesSPA license key
secrets.ymlworkfusion_db_userworkfusionDatabase username
secrets.ymlworkfusion_db_passworkfusionPassword for database username
secrets.ymlworkfusion_datastore_userworkfusionDatastore username
secrets.ymlworkfusion_datastore_passworkfusionPassword for datastore username
secrets.ymlworkfusion_nexus_userworkfusionNexus username
secrets.ymlworkfusion_nexus_passworkfusionPassword for nexus username
secrets.ymlwf_tableau_automation_usernametableau_userTableau username for WEB UI
secrets.ymlwf_tableau_automation_passwordtableau_passPassword for Tableau username for WEB UI
secrets.ymlwf_tableau_dashboard_usernametableau_userTableau username for WEB UI
secrets.ymlwf_tableau_dashboard_passwordtableau_passPassword for Tableau username for WEB UI
secrets.ymlwf_sso_saml_idp_file_metadatametadata_file_pathPath to SSO metadata file
secrets.ymlwf_sso_saml_sp_metadatasome_unique_nameSSO metadata
secrets.ymlwf_sso_saml_username_attributeuidSSO username attribute
secrets.ymlwf_usernameworkfusionWEB UI username for CT
secrets.ymlwf_passwordworkfusionPassword for WEB UI username for CT
secrets.ymlwf_ldap_server_urlldaps://ldap.example.com:636ldap server url. ldap settings will be ignored if ldap_enabled is set to false in config.yml
secrets.ymlwf_ldap_bind_dnUser_distinguished_nameUser distinguished name
secrets.ymlwf_ldap_bind_passwordUser_passwordLdap user password
secrets.ymlwf_hazelcast_group_nameha_wf_userHA (hazelcast) username
secrets.ymlwf_hazelcast_group_passwordha_wf_passwPassword for HA (hazelcast) username
secrets.ymlwf_secure_storage_userworkfusionSecure storage username
secrets.ymlwf_secure_storage_passworkfusionPassword for secure storage username

Troubleshooting

  • Check if TCP port 7080 is available.

    Ports may be custom:

    netstat command output

    $ netstat -lntp | grep 7080
tcp6       0      0 127.0.0.1:7080          :::*                    LISTEN      4112/java

    ss command output

    $ ss -ltn | grep 7080
LISTEN     0      100       ::ffff:127.0.0.1:7080                    :::*

    lsof command output

    $ lsof -P -n -i :7080 | grep LISTEN
java    4112 wfuser   56u  IPv6  26539      0t0  TCP 127.0.0.1:7080 (LISTEN)

  • Check if main services are available:

    workfusion/login

    $ curl -sI https://app.example.com:8443/workfusion/login
HTTP/1.1 200
<DATE>: Fri, 22 Jun 2018 12:35:35 GMT
Content-Type: text/html;charset=UTF-8
Connection: keep-alive
Set-Cookie: JSESSIONID=8B76D843CB407F5E956DEB4CD86FF4CA; Path=/workfusion; HttpOnly
Server: Workfusion
ALLOW-FROM: ec2-18-208-35-145.compute-1.amazonaws.com
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Content-Type,Accept
Access-Control-Allow-Methods: GET, POST, HEAD, PUT, DELETE
Pragma: no-cache
Strict-Transport-Security: max-age=31536000; includeSubdomains;

    workfusion/login

    $ curl -sI http://localhost:7080/workfusion/login
HTTP/1.1 200
X-Powered-By: JSF/2.0
Set-Cookie: JSESSIONID=AB860CB04E2D3CB8323C23E3D9D5EE12; Path=/workfusion; HttpOnly
Content-Type: text/html;charset=UTF-8
Transfer-Encoding: chunked
<DATE>: Fri, 22 Jun 2018 12:34:36 GMT

    workfusion/public/HTMLRenderer

    $ curl -sI https://app.example.com:8443/workfusion/public/HTMLRenderer
HTTP/1.1 200
<DATE>: Fri, 22 Jun 2018 12:39:51 GMT
Content-Type: text/html;charset=ISO-8859-1
Connection: keep-alive
P3P: CP='IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT'
Server: Workfusion
ALLOW-FROM: ec2-18-208-35-145.compute-1.amazonaws.com
X-Content-Type-Options: nosniff
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Content-Type,Accept
Access-Control-Allow-Methods: GET, POST, HEAD, PUT, DELETE
Pragma: no-cache
Strict-Transport-Security: max-age=31536000; includeSubdomains;

    workfusion/public/HTMLRenderer

    $ curl -sI http://localhost:7080/workfusion/public/HTMLRenderer
HTTP/1.1 200
P3P: CP='IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT'
Content-Type: text/html;charset=ISO-8859-1
Transfer-Encoding: chunked
<DATE>: Fri, 22 Jun 2018 12:40:34 GMT

  • Check the default log files:

    • Access logs: ${install_dir}/supervisord/log/workfusion.out.log
    • Error logs: ${install_dir}/supervisord/log/workfusion.err.log
    $ tail -f ${install_dir}/supervisord/log/workfusion.err.log ${install_dir}/supervisord/log/workfusion.out.log

  • Check workfusion out log using the Wfmanager util:

    wfmanager tail workfusion

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

    ${install_dir}/workfusion/logs/

    audit.log
automation.log
batch-operations.log
catalina.<DATE>.log
composite.log
configuration.log
crowdcontrol.log
gc.log
hibernate_sql.log
host-manager.<DATE>.log
localhost.<DATE>.log
localhost_access_log.<DATE>.txt
manager.<DATE>.log
performance-metrics.log
priceRules.log
quartz-processing.log
recorderPlugin.log
rest-api-rqrs.log
rules.log
saml-security.log
scheduledUpload.log
selenium.log
stripes.log
syncQualifications.log
taskRedistribution.log
taskRedistribution_trace.log
throttling.log
webharvest-config.log
webharvest.log
wf-rest.log

  • Check the permissions and full path access to the files accessed by WorkFusion:

    $ ls -lah /opt/workfusion/workfusion/webapps/workfusion/WEB-INF/WEB-INF/web.xml
← PreviousNext →