Skip to content
Getting Started

First Time Setup

Creating an account

  1. Visit 3forge.com/signup to create an account if you do not already have one for your current organization. Note that you should use your employer email, not your personal email.

  2. After you submit, 3forge will send you an email to activate your account.

  3. Once you've activated your account, a 3forge employee will contact you to assign a version and license.

Installing AMI

  1. Go to 3forge.com/login and login to your account, then click on Files in the left menu and download your relevant version:

    • For Mac: ami_macos_some_version.dmg
    • For Windows: ami_windows-x64_some_version.exe
    • For Unix: ami_unix_some_version.sh

  2. If installing on a server, copy the downloaded file from step 1 onto the server and logon to that server

  3. Run the downloaded file from step 1 and follow the installation wizard instructions

  4. After startup is complete visit http://localhost:33332 on browser. If installed on separate server replace "localhost" with the server's hostname or ip address

  5. Log in to AMI, the default login is username demo and password demo123

Starting AMI

  • Unix or Mac: Run the amione/scripts/start.sh and amione/scripts/stop.sh script files
  • Windows: Run AMI_One.exe (on older versions there may be .bat files in amione/scripts/ available too)

Note

If AMI fails to start, please see the Startup Failure troubleshooting page.

Creating a license

Licenses can be created from the 3forge.com/secure_licenses website (recommended) or through AMI itself.

  1. Visit 3forge.com/secure_licenses, the page should look similar to below:

  2. Check the AMIone checkbox

  3. Enter the hostname in the Host(s) field. You can determine the hostname by starting AMI and reading the red warning on the login page

  4. Click create and copy the contents into your clipboard

  5. Create a file under the amione/ folder called f1license.txt and paste the content inside the file.

  6. Restart AMI for the license to take effect.

  1. Click Help in the top menu bar and select Enter/Update License

  2. If you already have a license key generated and copied from the 3Forge website, paste the key onto the Enter License Key field. Click on the submit button and restart AMI for the new license to take effect. Continue onto step 3 if you want to generate a new license key.

  3. To generate a new license key, click on the Generate License Key button.

  4. A login form will appear which asks for your 3Forge website credentials.

  5. Enter the credentials and request a license key by clicking on the Request License Key button.

  6. A dialog box with the new license key will appear. Click on the Update License Key button to apply the newly generated key.

  7. Finally, click on the submit button to finish the license creation process.

  8. Restart AMI for the license to take effect.

Minimum Environment

Minimum Operating Environment

Component Minimum Requirement
OPERATING SYSTEM Ubuntu, Fedora/Red Hat, CentOS, Mac OS X, Windows Certified (Full support for Java 1.8 or later)
RAM 4GB
DISK 20GB
PROCESSOR 2GHZ CPU (Intel & AMD Certified)
CLIENT BROWSER Up-to-date version of: Microsoft Edge, Chrome, Firefox or Safari
ACCESS Must have permissions to install software
NETWORK Server must have access to data sources. Firewalls should also be enabled to allow connections to port 33332

Suggested Operating Environment

Component Suggested Requirement
OPERATING SYSTEM Unix environment with Java 1.8 or later
RAM 32GB or more
DISK 100GB or more
PROCESSOR 3GHZ CPU, 8 cores or more
CLIENT BROWSER Up-to-date version of: Microsoft Edge, Chrome, Firefox or Safari
ACCESS Must have permissions to install software (often requiring Admin rights on Windows)
NETWORK Server must have access to data sources. Firewalls should also be enabled to allow connections to port 33332