Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This article is valid until Digital Access 6.0.3

Note

...

The Digital Access virtual appliance is not supported anymore. See Deploy Digital Access component for other ways to deploy Digital Access.

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.

Prerequisites

Expand
titlePrerequisites

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

Deploy Digital Access component

Expand
titleDownload appliance files
  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


Expand
titleVerify checksum
  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:

    Code Block
    titleExample
    $ shasum access-gateway.ova 
    bdc2a093caef0c0589325d6f509c1b19de1e36d7 access-gateway.ova

     

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

    Code Block
    titleExample
    $ 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:

    Code Block
    languagebash
    titlePowerShell example
    PS> Get-FileHash -Algorithm SHA1 .\access-gateway.ova 
    
    Algorithm   Hash                                       Path
    ---------   ----                                       ----
    SHA1        bdc2a093caef0c0589325d6f509c1b19de1e36d7   C:\Users\joachim.kessel\
    Downloads\access-gateway.ova



Expand
titleDeploy appliance file
  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. 
Tip
titleTroubleshooting: 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.



Expand
titleLog in to console menu and set initial password
  1. Log in with the agadmin user. Since this is the first time you log in, you must set the password:

    Panel
    bgColorwhite
    titleBGColor#f1f1f1
    titleExample: 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.

...

Basic settings after deployment

Expand
title

...

Basic settings

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.

...

Initial setup

See Do initial setup of Digital Access component.

...

Related information

Links