Designed to save developer time and effort, there are only a few simple steps to download and install Passport in your test or production environment. The following tutorial will explain how to install Passport on a Linux system and be up and running in just a few minutes. This is one aspect that makes Passport unique. Most existing identity technologies have a complex hierarchy of realms, principals, and distinguished names that restricts where they can be installed and requires extensive configuration. Passport will install and run on a wide variety of systems including:
- Linux – all distributions (64-bit)
- Mac OS X 10.8 (Mountain Lion) or newer
- Windows Server 2008 SP2 (64-bit) w/ Windows Management Framework 3.0 or newer
- Windows Server 2008 R2 (64-bit) w/ Windows Management Framework 3.0 or newer
- Windows 7 SP1 (64-bit) w/ Windows Management Framework 3.0 or newer
We will share tutorials for these systems in the near future, but please contact us at email@example.com if you need help before they are released.
Before you start installing onto Linux, do a quick check on your system to make sure it meets the minimum requirements. You will need:
- A 64-bit linux build of an RPM or Debian-based distribution.
- A MySQL or PostgreSQL database
Refer to the latest documentation on Inversoft.com/docs for minimum versions. If you don’t yet have a database installed, do this first before you continue.
Download and Install Passport
Start by going to Inversoft.com and logging into your account. (Use the Passport Setup Wizard to establish your account.) On your accounts page you will see your licenses. On the right side select the Download button. This will take you to the product download page. In this example we are installing onto Ubuntu Linux, so we will download the Debian packages.
Passport is comprised of two web services, the Passport backend and Passport search engine. The Passport Backend bundle provides access to the API and the web-based user interface. The search engine is required by Passport and provides full-text search uses Elasticsearch. In this video we will download and install both services.
We will be using Wget to download the packages. If you do not have the command line tool Wget available you may optionally download the packages via a browser and transfer them to the target system.
First, you’ll want to right-click on the file and copy the destination to your clipboard. Then, paste it at the end of your Wget command. Once you have the backend bundle downloaded, repeat the same steps for the search engine files.
Next, you will need to install the two packages that you just downloaded. I am using the “dpkg -i” command to install backend and search engine. Finally, you will need to start these services. IMPORTANT: Start the Passport Search Engine before the Passport back end.
Complete the Passport Setup
Now that both services have been started. You will complete the setup using the browser. In your browser you will navigate to the IP address or hostname of the server where you installed Passport. This may be localhost if you are installing locally. By default Passport Backend will be listening on port 9011 so we will add that to the address. When the page loads you will be prompted for your license key.
If you do not have the key handy, you can find it on your Inversoft account page.
Once the key is verified you will be prompted to complete the database configuration in order to finish the setup. If you need any help with these steps, you can refer to our installation documentation at Inversoft.com, or feel free to email firstname.lastname@example.org.
Video: Download and Install Passport – Linux
Learn More About Passport
Passport is designed to be the most flexible and secure Customer Identity and Access Management solution available on the market. More than a login tool, we provide registration, data search, user segmentation and advanced user management across applications. Find out more about Passport and sign up for a free trial today.