Install Connect

Version:
2019.3
Last modified: December 13, 2019

Alteryx Connect is an add-on to Alteryx Server and must be installed on a separate node by a member of the Administrators group.

How to Install Alteryx Connect

  1. Review the System Requirements.
  2. Download the Alteryx Connect installation package and open the installer.
    • If Connect is not a downloadable product option for your account, ask your Sales representative to grant you access.
  3. Run the installer on your designated Connect Server.
  4. At the prompt, provide the destination folder for the application.
    • This drive should have at least 100 GB of free space.
  5. Enter the Port, typically 80 for HTTP, and click Next.
    • Port 80 is the default value.
  6. Review the license agreement, accept the license agreement, and click Next.
  7. Click Next to install Alteryx Connect.
    • After the installer is run, the AlteryxConnect and java.exe process will both be running in the Task Manager.
  8. Select Start the Alteryx Connect service now to start the Alteryx Connect service in the background.
    • After startup, you can access the Alteryx Connect instance at http://localhost.
    • You can start Connect at a later time manually in Services.
    • The window will indicate progress for starting the service, loading the configuration, loading content, and starting the service. This step takes approximately 20 minutes to complete.
  9. Click Next.
  10. Access the Alteryx Connect instance at http://localhost:80 is selected by default. Click Finish. The default administrator credentials are:
    • Username: admin
    • Password: Conn3ct!
  11. Enter the User name and Password and Sign In.

SSL Configuration

During the setup process or if you have already installed Connect, you have the option to Configure SSL.

  1. Select Enable SSL on the initial setup screen.
  2. On the next screen, you have two options:
    • Upload existing certificate
    • Generate self-signed certificate
  3. To use an existing keystore or create new one, enter the following:

    • https port. The default is set to 443 unless you specify a different value.
    • Keystore password
    • Keystore file name
    • Path to keystore. You also have the option to browse for the keystore.
    • Redirect http communication (optional): by default, you are redirected to use https if currently using http.
  4. To generate a self-signed certificate, enter the following:
    • Alias - name of the certificate in the keystore; can be random value
    • Domain name - baseurl of your Connect instance; Domain name should match the URL you will use to access Connect
    • Organizational Name
    • Organizational Unit
    • City or locality
    • State or province
    • Two letter country code
  5. To allow Connect to create a new signing request, enter the following:
    • Alias
    • Certificate Signing Request (CSR) file
    • Specify a path to the file
  6. To Import certificates, you will need to manually enter the following information:
    • Alias
    • Certificate file
    • Path to the file
  7. The final screen will state that SSL is enabled.

Configuration

  1. Enter the User name and Password and Sign In.
  2. Connect will then prompt you for initial configuration steps for:
    • Admin Password - enter a password for the default administrator
    • H2 Password - enter a password for the H2 user.
    • Instance Settings - Enter the base URL to access the site. This may be the machine name or a DNS name.
    • SMTP Settings - Enter the SMTP Server Name, Protocol (SSL/TLS), default email to send mail as, and credentials to the SMTP server if required.
  3. Change the default administrator password:
    • Click your icon in the top-right of the screen and select My Profile.
    • In the Superadmin Information section, type the default administrator password and set and confirm a new password.
    • Click Save.

To load data asset metadata, configure users, and perform other administrative tasks, see Administer Connect.  

Installation troubleshooting

I can't access the Alteryx Connect URL

Wait at least ten minutes for the Alteryx Connect service to initialize before trying to access Alteryx Connect. If you still cannot access the URL, check to see if the Alteryx Connect service is running:

  1. Open the Windows Task Manager.
  2. Click the Services tab.
  3. Find AlteryxConnect in the list. Its status should be "Running". If it shows "Stopped", proceed to the next step.
  4. Click Services.
  5. In the list of services, select Alteryx Connect.
  6. Click Start.
Alteryx Connect appears to be frozen​​​

Try the following:

  • Restart the AlteryxConnect service:
    1. Open the Windows Task Manager.
    2. Click the Services tab.
    3. Click Services.
    4. In the list of services, select Alteryx Connect.
    5. Click Restart.
  • Shut down and restart the Alteryx Connect server:
    1. Go to <installation_path>\bin. The default installation path is C:\Program Files\AlteryxConnect.
    2. Execute shutdown.bat, followed by startup.bat.
Was This Helpful?

Need something else? Visit the Alteryx Community or contact support.