Difference between revisions of "V3 & V4 Appliance Quick Start"

From Swivel Knowledgebase
Jump to: navigation, search
(add spaces to category)
(Accessing Appliance Menus)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{template:default}}
 
 
[[Category:Version 3 Appliance]]
 
[[Category:Version 3 Appliance]]
 
+
[[Category:Version 4 Appliance]]
 
+
[[Category:Pinsafe]]
 +
[[Category:Sentry]]
 
== Quick Start ==
 
== Quick Start ==
  
 
[[File:Single V3 Appliance.JPG|thumb|400px]]
 
[[File:Single V3 Appliance.JPG|thumb|400px]]
This guide is a quick start guide to the Version 3 Swivel Appliance.
+
This guide is a quick start guide to the '''Version 3 and 4''' Swivel Secure Appliances.
  
A reference guide that describes the meaning for all the menus is also available [[V3ApplianceReference | here]].
+
A reference guide that describes the meaning for all the menus is also available [[V3 Appliance Reference | here for version 3]] and [[V4 Appliance Reference | here for version 4]].
  
  
Line 24: Line 24:
  
  
If this IP address is your compatible with your network you can plug an ethernet cable into eth0 (labelled Gb1) and access the appliance via SSH.
+
If this IP address is compatible with your network you can plug an ethernet cable into eth0 (labelled Gb1) and access the appliance via SSH.
  
  
Line 32: Line 32:
 
== Accessing Appliance Menus ==
 
== Accessing Appliance Menus ==
  
To access the appliance menus you secure-shell onto the appliance.  From a window machine you can use a terminal emulator such as putty.  From a Linux you can simply use the ssh command.  SSH access is via the standard port 22.
+
To access the appliance menus you secure-shell onto the appliance.  From a Windows machine you can use a terminal emulator capable of SSH connections, such as putty.  From a Linux machine you can simply use the ssh command.  SSH access is via the standard port 22.
  
 
When you access the appliance you will be prompted for a username and password.  The default settings for this are:
 
When you access the appliance you will be prompted for a username and password.  The default settings for this are:
  
username:admin
+
* V3 and V4.0 appliances:
 +
 
 +
'''username:admin'''
 +
 
 +
'''password:lockbox'''
 +
 
 +
* V4.1 and later appliances:
 +
 
 +
'''username:admin'''
 +
 
 +
'''password:securebox'''
  
password:lockbox
 
  
 
Once you have logged on you will be presented with the top level menu.  Sub-menus are accessed by simply pressing the number of the item required followed by <Enter>
 
Once you have logged on you will be presented with the top level menu.  Sub-menus are accessed by simply pressing the number of the item required followed by <Enter>
Line 45: Line 54:
 
On certain actions you will be asked to enter Y to continue.  Entering any other character or just entering return will cause the action to be cancelled. To maintain compatibility with v2, entering “yes” will also work.
 
On certain actions you will be asked to enter Y to continue.  Entering any other character or just entering return will cause the action to be cancelled. To maintain compatibility with v2, entering “yes” will also work.
  
 +
<p class="note">'''NOTE''' Refer to our [[PuTTY How To Guide]] for detailed instructions and screenshots.</p>
 +
 +
== Updating Appliance ==
 +
<p class="warning">'''Important''' You should update an appliance prior to installation to ensure it is running the optimum versions and settings </p>
  
 +
A [[V3ApplianceUpdate|reference guide that details the options available for Appliance updating is available]].
  
 
== Webmin ==
 
== Webmin ==
  
 
+
You can find the [[Webmin How To Guide|Webmin guide here]].
Webmin has remained pretty much unchanged in version 3
 
 
 
https://kb.swivelsecure.com/wiki/index.php/Webmin_How_To_Guide
 
  
  
  
 
== Setting Hostname IP Address ==
 
== Setting Hostname IP Address ==
 
  
 
'''If you are using an Cloud-based appliance, IP addresses must be set by DHCP.'''
 
'''If you are using an Cloud-based appliance, IP addresses must be set by DHCP.'''
 
  
 
You will need to set the IP address(es) of the appliance.  To do this use the access the Network Menu and do the following
 
You will need to set the IP address(es) of the appliance.  To do this use the access the Network Menu and do the following
 
  
 
# Use the change hostname to set the hostname. Recommended to make this a meaningful, eg swivel.yourcompany.  If this appliance is part of an HA installation include the appliance type eg primary.swivel.yourcompany.
 
# Use the change hostname to set the hostname. Recommended to make this a meaningful, eg swivel.yourcompany.  If this appliance is part of an HA installation include the appliance type eg primary.swivel.yourcompany.
 
# Set the Network settings for ETH0.  This is the main interface, you may not need to change the ETH1 settings as this is used for database replication (ref Setting up HA)
 
# Set the Network settings for ETH0.  This is the main interface, you may not need to change the ETH1 settings as this is used for database replication (ref Setting up HA)
 
# Set DNS servers.  This may not be required at this stage but will be required if the Swivel Appliance will need to perform DNS resolution, eg for sending emails or SMS messages via named hosts.
 
# Set DNS servers.  This may not be required at this stage but will be required if the Swivel Appliance will need to perform DNS resolution, eg for sending emails or SMS messages via named hosts.
 
  
 
== Starting and Stopping Tomcat ==
 
== Starting and Stopping Tomcat ==
Line 75: Line 82:
  
 
Should you need to manually start or stop Tomcat, this is possible from the Tomcat menu.
 
Should you need to manually start or stop Tomcat, this is possible from the Tomcat menu.
 
  
 
== Accessing the Swivel Applications ==
 
== Accessing the Swivel Applications ==
Line 81: Line 87:
 
With the ETH0 address set to <IP Address> you will be able to access the following applications from a browser:
 
With the ETH0 address set to <IP Address> you will be able to access the following applications from a browser:
  
 
+
Swivel Core admin console <span style="color:blue"><nowiki>https://<IP Address>:8080/pinsafe</nowiki></span>. For version 4, this should be <span style="color:blue"><nowiki>https://<IP Address>:8080/sentry</nowiki></span>.
Swivel Core admin console <span style="color:blue"><nowiki>https://<IP Address>:8080/pinsafe</nowiki></span>
 
  
 
Swivel User (Self Service) Portal <span style="color:blue"><nowiki>https://<IP Address>:8443/userportal</nowiki></span>
 
Swivel User (Self Service) Portal <span style="color:blue"><nowiki>https://<IP Address>:8443/userportal</nowiki></span>
  
 
Swivel Proxy <span style="color:blue"><nowiki>https://<IP Address>:8443/proxy</nowiki></span>
 
Swivel Proxy <span style="color:blue"><nowiki>https://<IP Address>:8443/proxy</nowiki></span>
 
  
 
*The Swivel Proxy has no user interface but acts as a proxy for image and message requests e.g. <span style="color:blue"><nowiki>https://<IP Address>:8443/proxy/SCImage?username=test</nowiki></span> should result in a TURing image being displayed.
 
*The Swivel Proxy has no user interface but acts as a proxy for image and message requests e.g. <span style="color:blue"><nowiki>https://<IP Address>:8443/proxy/SCImage?username=test</nowiki></span> should result in a TURing image being displayed.
  
 
[[Image:Turing.jpg]]
 
[[Image:Turing.jpg]]

Latest revision as of 11:10, 11 November 2020

Quick Start

Single V3 Appliance.JPG

This guide is a quick start guide to the Version 3 and 4 Swivel Secure Appliances.

A reference guide that describes the meaning for all the menus is also available here for version 3 and here for version 4.


The appliance will come with a pre-configured IP address depending on appliance type:


Stand-alone (192.168.0.35)

HA Primary (192.168.0.36)

HA Standby (192.168.0.37)

Amazon/Cloud (DHCP)


If this IP address is compatible with your network you can plug an ethernet cable into eth0 (labelled Gb1) and access the appliance via SSH.


Alternatively you can access by plugging in an ethernet cross-over cable into eth0


Accessing Appliance Menus

To access the appliance menus you secure-shell onto the appliance. From a Windows machine you can use a terminal emulator capable of SSH connections, such as putty. From a Linux machine you can simply use the ssh command. SSH access is via the standard port 22.

When you access the appliance you will be prompted for a username and password. The default settings for this are:

  • V3 and V4.0 appliances:

username:admin

password:lockbox

  • V4.1 and later appliances:

username:admin

password:securebox


Once you have logged on you will be presented with the top level menu. Sub-menus are accessed by simply pressing the number of the item required followed by <Enter>


On certain actions you will be asked to enter Y to continue. Entering any other character or just entering return will cause the action to be cancelled. To maintain compatibility with v2, entering “yes” will also work.

NOTE Refer to our PuTTY How To Guide for detailed instructions and screenshots.

Updating Appliance

Important You should update an appliance prior to installation to ensure it is running the optimum versions and settings

A reference guide that details the options available for Appliance updating is available.

Webmin

You can find the Webmin guide here.


Setting Hostname IP Address

If you are using an Cloud-based appliance, IP addresses must be set by DHCP.

You will need to set the IP address(es) of the appliance. To do this use the access the Network Menu and do the following

  1. Use the change hostname to set the hostname. Recommended to make this a meaningful, eg swivel.yourcompany. If this appliance is part of an HA installation include the appliance type eg primary.swivel.yourcompany.
  2. Set the Network settings for ETH0. This is the main interface, you may not need to change the ETH1 settings as this is used for database replication (ref Setting up HA)
  3. Set DNS servers. This may not be required at this stage but will be required if the Swivel Appliance will need to perform DNS resolution, eg for sending emails or SMS messages via named hosts.

Starting and Stopping Tomcat

Swivel applications run within Tomcat so you will only be able to access them when Tomcat is running. Tomcat will start automatically when the appliance starts and the status of Tomcat is shown on the main screen and on the Tomcat menu screen.

Should you need to manually start or stop Tomcat, this is possible from the Tomcat menu.

Accessing the Swivel Applications

With the ETH0 address set to <IP Address> you will be able to access the following applications from a browser:

Swivel Core admin console https://<IP Address>:8080/pinsafe. For version 4, this should be https://<IP Address>:8080/sentry.

Swivel User (Self Service) Portal https://<IP Address>:8443/userportal

Swivel Proxy https://<IP Address>:8443/proxy

  • The Swivel Proxy has no user interface but acts as a proxy for image and message requests e.g. https://<IP Address>:8443/proxy/SCImage?username=test should result in a TURing image being displayed.

Turing.jpg