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

From Swivel Knowledgebase
Jump to: navigation, search
m (Admin moved page V3ApplianceQuickStart to V3 Appliance Quick Start: add spaces)
(import changes from kb2)
Line 1: Line 1:
 
{{template:default}}
 
{{template:default}}
 
[[Category:Version 3 Appliance]]
 
[[Category:Version 3 Appliance]]
 +
[[Category:Version 4 Appliance]]
  
  
Line 6: Line 7:
  
 
[[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 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 45: Line 46:
 
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 74:
  
 
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 79:
 
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]]

Revision as of 09:10, 18 May 2017


Quick Start

Single V3 Appliance.JPG

This guide is a quick start guide to the Version 3 and 4 Swivel 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 your 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 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.

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

username:admin

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>


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