Install OnCommand Workflow Automation on Windows

02/22/2022 Contributors

You can install OnCommand Workflow Automation (WFA) to create and customize storage workflows for automating the storage tasks that are performed in your environment.

You must have reviewed the installation prerequisites.

Prerequisites for installing Workflow Automation
If you are installing WFA on a system where WFA was previously installed and then uninstalled, you must ensure that there are no WFA services on that system.
You must have downloaded the WFA installer from the NetApp Support Site.
If you are installing WFA on a virtual machine (VM), the name of the VM must not include the underscore (_) character.
ActiveState ActivePerl is installed before you install WFA.

This installation does not affect any other instances of ActivePerl that you have installed on your WFA server.
Before you reinstall WFA 4.2 or later, you must delete MySQL data directory if you have uninstalled MySQL.

Steps

Log in to Windows using an account with administrative permissions.
Open Windows Explorer, and then navigate to the directory where the installation file is located.

Install WFA:

Interactive installation
1. Right-click and run the WFA installer executable (.exe) file as an admin user.
2. Click Next.
3. Enter the credentials for the default admin user, and then click Next.
  
  The default admin password must satisfy the following criteria:
  - Minimum of eight characters
  - One uppercase character
  - One lowercase character
  - One numeral
  - One special character
  - The following special characters are not supported in a password and cause installation failure:
    
    `" ; < > , = & ^ |
    
    You must note the credentials of the admin user.
4. Enter a user name and password for the WFA service logon. For a domain user provide a user name in the format DOMAIN\USER. For a local system user the format is just a user name. The default user name is "wfa".
  
  WFA installer creates a local user if one does not exist. If a local user exists and the password entered is different than the existing password, WFA updates the password.
  
  Ensure the password conforms to the password policy configured for local users on the system. If the password does not conform to the password policy, the install fails.
5. Select the ports for the WFA configuration, and then click Next.
6. Enter a site name and your company name, and then click Next.
  
  The site name can include the location of the WFA installation, for example, Pittsburgh, PA.
7. If you want to change the default installation location, select the location where you want to install WFA, and then click Next.
8. If you want to change the default installation location for third party products, select the location where you want to install third party products, and then click Next.
9. If you do not want to change the default location of the WFA database, click Next.
10. Click Install to continue the installation.
11. Click Finish to complete the installation.
12. Verify that WFA was installed successfully by choosing one of the following actions:
  - Access WFA through a web browser.
  - Use the Windows Services console to verify that the NetApp WFA Server service and the NetApp WFA Database service are running.

Silent installation (from the command prompt):

WFA-version_number-build_number.exe /s /v"WFA_ADMIN_USERNAME=wfa_username WFA_ADMIN_PASSWORD=password WFA_ADMIN_CONFIRM_PASSWORD=confirm admin password / WFA_MYSQL_PASS=password CONFIRM_WFA_MYSQL_PASS=confirm MySQL password WFA_INSTALL_SITE=site WFA_INSTALL_ORGANIZATION=organization_name WFA_HTTP_PORT=port WFA_HTTPS_PORT=port INSTALLDIR=install_directory JDKINSTALLDIR=jdk_directory PerlDir=perl_directory MySqlInstallDir=mysql_directory WFA_SERVICE_LOGON_USERNAME=wfa service logon username WFA_SERVICE_LOGON_PASSWORD=wfa service logon user password MYSQL_DATA_DIR= mysql data directory /qr /l*v C:\install.log"

Example

WFA-x64-V5.1.0.0.1-B5355278.exe /s /v"WFA_ADMIN_USERNAME=admin WFA_ADMIN_PASSWORD=Company*123 WFA_ADMIN_CONFIRM_PASSWORD=Company*123 WFA_MYSQL_PASS=MySQL*123 CONFIRM_WFA_MYSQL_PASS=MySQL*123 WFA_INSTALL_SITE=nb WFA_INSTALL_SITE=nb WFA_INSTALL_ORGANIZATION=netapp WFA_HTTP_PORT=80 WFA_HTTPS_PORT=443 INSTALLDIR=\"C:\Program Files\NetApp\WFA\" JDKINSTALLDIR=\"C:\Program Files\NetApp\" PerlDir=\"C:\Perl64\" MySqlInstallDir=\"C:\Program Files\MySQL\"WFA_SERVICE_LOGON_USERNAME=wfa WFA_SERVICE_LOGON_PASSWORD=Wfa*1234\NetApp\WFA\" MYSQL_DATA_DIR=\"C:\Program Files\NetApp\WFA\Database\" /qr /l*v C:\install.log"

The /qn option is not supported by WFA.

The command parameters are as follows:

Parameter

Description

WFA_ADMIN_USERNAME

Admin user name Optional parameter. If you do not specify a value, the value defaults to admin.

WFA_ADMIN_PASSWORD

Admin user password Mandatory parameter. The default admin password must satisfy the following criteria:

Minimum of eight characters
One uppercase character
One lowercase character
One numeral
One special character
The following characters are not allowed and cause password input to fail:

`" ; < > , = & ^ |

WFA_ADMIN_CONFIRM_PASSWORD

Admin user password Mandatory parameter

WFA_MYSQL_PASS

MySQL user password Mandatory parameter

CONFIRM_WFA_MYSQL_PASS

MySQL user password Mandatory parameter

WFA_INSTALL_SITE

Organizational unit where WFA is being installed Mandatory parameter

WFA_INSTALL_ORGANIZATION

Organization or company name where WFA is being installed Mandatory parameter

WFA_HTTP_PORT

HTTP port Optional parameter. If you do not specify a value, the value defaults to 80.

WFA_HTTPS_PORT

HTTPS port Optional parameter. If you do not specify a value, the value defaults to 443.

INSTALLDIR

Installation directory path Optional parameter. If you do not specify a value, the path defaults to "C:\Program Files\NetApp\WFA\".

JDKINSTALLDIR

JDK installation directory path Optional parameter. If you do not specify a value, the path defaults to "C:\Program Files\NetApp\".

PerlDir

Perl installation directory path Optional parameter. If you do not specify a value, the path defaults to "C:\Perl64\".

MySqlInstallDir

MySQL installation directory path Optional parameter. If you do not specify a value, the path defaults to "C:\Program Files\MySQL\".

WFA_SERVICE_LOGON_USERNAME

User name for WFA service logon Optional parameter. If you do not specify a value, the default user name is "wfa".

For a domain user provide a user name in the format DOMAIN\USER. For a local system user the format is just a user name.

WFA installer creates a local user if one does not exist. If a local user exists and the password entered is different than the existing password, WFA updates the password.

Ensure the password conforms to the password policy configured for local users on the system. If the password does not conform to the password policy, the install fails.

WFA_SERVICE_LOGON_PASSWORD

Password for WFA service logon Mandatory parameter

MYSQL_DATA_DIR

Directory for MYSQL data Optional parameter. If you do not specify a value, the path defaults to "C:\ProgramData\MySQL\MySQLServerData"

Available for fresh install only.

Related information

NetApp Support

Install OnCommand Workflow Automation on Windows

Creating your file...