Installing Faspex

The following instructions describe how to install IBM Aspera Faspex on your machine:

Launch the Faspex installer.

Double-click the Faspex installer to begin the installation process.

Note: If your Windows Operating System has User Account Control (UAC) enabled, confirm or enter the administrator's password to allow the installer to make changes to your computer.

After the license agreement screen, select your desired setup type. You may select Typical or Custom. Setup types are described below:

Option	Description
Typical	Install all required components, including the Faspex application, common files (Ruby and MySQL) and the Faspex MySQL database.
Custom	Select individual components to install; in which event, you may use your existing installation(s) of Ruby, MySQL, or the Faspex MySQL database.

If you selected the Custom setup type, identify which optional features you want to install.

Associate the Aspera services with a User Account

Create or update an Aspera service account. If the existing user's password you have entered is incorrect, or you wish to change the Aspera service user, refer to Updating Aspera Service Account. By default, the user name is svcAspera.

OS	Instructions
Windows XP 64-bit, Vista, 2003, 2008, and 7:	The installer will prompt you to create or update an Aspera service account that runs the services for Aspera products (if installed). If the server is configured to accept the domain user login, use a domain account that has been added to the local administrator's group to run the services.
Windows XP 32-bit:	Instead of creating a user account, you may check the option Run Aspera services as a local SYSTEM account to run these services with the local user "SYSTEM". Otherwise, enter the Aspera service account username and password that you created for your installation of Aspera Enterprise Server or Aspera Connect Server and click the Next button.

Important: If installing on a Windows 7 machine, you may run into the following error:

There was a problem setting up the user account that runs the
Aspera services.

       Error adding local user scvAspera (Access denied)


Go back and either specify a local user account to be created, 
or an existing local or domain account.

Right-click Command Prompt and select "Run as administrator." Then, launch the installer from the command line. For example:

> c:\Users\aspera\Desktop > AsperaFaspex-<version>-windows-32.msi

Use a Managed Service Account (MSA): Select Use Managed Service Account (MSA) and enter your MSA user name in the form: "identity$@domain" (For example: AsperaMSA$@msa.test.local). For more information on MSA, refer to the Managed Service Accounts page on the Microsoft website.

Launch asctl to continue Aspera Faspex setup process.

Once the "IBM Aspera Faspex Setup Wizard" completes, you will receive a prompt with a checkbox and a Finish button.

By default, the Launch asctl to continue the Faspex setup checkbox is turned on. Once you click Finish, the installer will automatically run the setup command. If you do not want to run the setup command automatically, then uncheck (turn off) the Launch asctl to continue the Faspex setup checkbox.
Follow the onscreen configuration instructions to complete the setup. These instructions include identifying whether you want to perform a streamlined (s) setup or a detailed (d) setup. Select detailed (d) to view and edit advanced configuration options.

If Faspex doesn't automatically run the setup command or an error halts the process, then you can run the command manually, as shown below.
```
> asctl faspex:setup
```
Restart the Aspera Node Server.

In order to use Aspera Faspex, the Aspera Node Server must be running. If you did not choose to restart the Aspera Node Server when prompted during the setup process, or if it has been stopped, you must restart it before using Faspex.

To check whether the Aspera Node Server is running or to restart it, open the Services window from Control Panel > Administrative Tools > Services.

Your Faspex installation is now complete. To access the Faspex web interface, go to the following address within a browser window: http://server-ip-or-name/aspera/faspex.

As an Aspera Faspex Administrator, you can log in without activating Faspex. You must, however, have a valid license key to configure your users and begin sending or receiving packages. For more information on installing your license key, refer to Updating Your License.