Nexus' software components have new names:

Nexus PRIME -> Smart ID Identity Manager
Nexus Certificate Manager -> Smart ID Certificate Manager
Nexus Hybrid Access Gateway -> Smart ID Digital Access component
Nexus Personal -> Smart ID clients

Go to Nexus homepage for overviews of Nexus' solutions, customer cases, news and more.


This article describes how to deploy Smart ID Digital Access component as virtual appliance. If you need instructions for Docker deployment, see here: Deploy Digital Access component on Docker.

Expand/Collapse All

Prerequisites

To see the deployment requirements for Digital Access component, go here.

Deploy Digital Access component

  1. Go to the Nexus Support portal. Find Digital Access component and the latest release.

  2. Open the appliance folder. 

  3. For Hyper-V, download:

    • appliance file: access-gateway.zip

    • digest file: access-gateway-digests.txt 

  4. For VMware, Virtual Box or other virtualization platforms, download:

    • appliance file: access-gateway.ova

    • digest file: access-gateway-digests.txt

  1. In the command-line interface, navigate to the search path where the files are stored.

  2. Verify the checksum for the .zip file or the .ova file with the shasum command:

    Example
    $ shasum access-gateway.ova 
    bdc2a093caef0c0589325d6f509c1b19de1e36d7 access-gateway.ova


  3. Compare the result with the digest file with the grep command.

    Example
    $ grep bdc2a093caef0c0589325d6f509c1b19de1e36d7 access-gateway-digests.txt 
    bdc2a093caef0c0589325d6f509c1b19de1e36d7   access-gateway.ova 
  4. If you are on a Windows machine, you can also check the digest using PowerShell, with the Get-FileHash command:

    PowerShell example
    PS> Get-FileHash -Algorithm SHA1 .\access-gateway.ova 
    
    Algorithm   Hash                                       Path
    ---------   ----                                       ----
    SHA1        bdc2a093caef0c0589325d6f509c1b19de1e36d7   C:\Users\joachim.kessel\
    Downloads\access-gateway.ova
  1. In the virtualization platform, import the appliance file.
  2. Check the network settings, and modify them if needed.
  3. Start the appliance, it boots. 

Troubleshooting: If appliance does not start

To start the virtual appliance on your personal computer, virtualization must be enabled in your BIOS. If the appliance fails to start, please check your virtualization settings in your BIOS: 

  1. Restart your computer. Press the required key(s) to enter the BIOS settings (see your screen at startup).
  2. Go to Security > Virtualization. Set Intel/AMD Virtualization Technology to Enabled.
  3. Save and Exit.
  1. Log in with the agadmin user. Since this is the first time you log in, you must set the password:

    Example: Log in with agadmin user

    ag-appliance login: agadmin
    You are required to change your password immediately (root enforced)

    Enter new UNIX password:
    Retype new UNIX password:

    The license agreement is shown.

  2. Press any key to continue. The console menu opens.

Do basic settings after deployment

The first time you log in you need to do some basic settings, for example set network parameters for the network adapter, and time settings.

  1. In the console menu, choose Setup system > Modify interfaces > [select adapter] 
  2. Either use DHCP or set up the IP address, netmask and default gateway manually:
    1. modify IP
    2. Enter the IP address, received from the IT department. Return.
    3. Check the netmask and default gateway. Modify if needed.
    4. Save
  3. Optional: Modify hostname.
  4. Modify DNS, received from the IT department.
  5. Return to main menu.

Do initial setup

See Do initial setup of Digital Access component.