Hyper-V How To Guide
From Swivel Knowledgebase Wiki
Contents |
Overview
The PINsafe virtual appliance is available as a Hyper-V appliance. This document is to aid in the initial deployment of the virtual appliance on the Hyper-V platform.
Downloading the VM Appliance
After purchasing the appliance via a reseller or channel partner, you will receive a download email containing the Hyper-V download. The download method is FTP and we recommend that you use a web browser to download the files by pasting the links into your browser address bar. We recommend this because the FTP directory in which the PINsafe software resides is not viewable and will appear empty in an FTP client.
Virtual Machine Specification
General Specification (applies to all VM formats)
These figures apply to the Single Appliance:
- 40GB Hard Disk (The standalone appliance initially consumes 2.5GB disk space)
- 1024MB RAM
Hyper-V Requirements
- We recommend that you avoid the use of dynamically expanding storage by allocating the 20GB disk space at the deployment stage.
- Verify that ETH0 and ETH1 are available. If the machine definition is imported then these network interfaces will be predefined. Once installed, you can configure the network interfaces through the CMI. It is recommend that the network interfaces (configurable within Hyper-V itself) are set to Legacy mode.
Deployment Methods
Begin by unzipping the download(s) and running the self extraction tool:
Run Hyper-V Manager, select a host in the left hand column that you'd like to import the VM to.
Then select Action -> Import Virtual Machine.
Ensure that you have the 'Copy...' Radio Button selected. Then point to the folder you extracted previously which contains the 'Snapshots', 'Virtual Hard Disks' and 'Virtual Machines' directories contained within. Once you've selected the directory, click 'Import' to start the import process.
You may or may not receive a warning at this point. To start the machine right click on it and select 'Start'.
You can also use the same right click menu to select 'Connect' to gain console access to the machine:
Troubleshooting
Cannot download Hyper-V Image
PINsafe appliance download directory appears empty. The directory cannot be viewed. The URL must be directly accessed. This can be done though IE by clicking on the Appliance URL or pasting the URL into the URL bar.
If that does not work try entering the username and password as part of the URL:
ftp://username:password@URL
Can you ping fs.swivelsecure.com
If you ftp fs.swivelsecure.com is there a login prompt (You will noot be able to see the file but it will test that FTP access is available)
Is there a proxy server blocking connectivity?
Next Steps - Configuring PINsafe
Having successfully installed the virtual machine, the next step is to login to the CMI though the virtual machine console or by SSH to the default IP address to configure the appliance.
When the Networking has been configured and Tomcat restarted/started, then PINsafe can be configured through the PINsafe Administration Console, see How to initially configure PINsafe
