User Manual - Get Console
Contents
1. User Manual Get Console Private Server Version 1 5 1 Date 5 December 2013 User Manual Get Console Private Server CONTENTS REVISION PISTON Y un 3 What Is Get Console Private Server scccssscccsssccssscccessceeesceoees 3 Get Console ADD een 3 GET Console SEIVEF ee 4 Obtaining the Private Server Software ccsccsccssccsscescesccsccecces 6 Virtual Appliance REQUIFEMENKS cccccssssecceeeeseeceeseeeeees 6 Firewall Port REQUIFEMENTS ccccsssscccccsssseceeceeeeeeeeaeeeees 6 Common Deployment Architecture ccsscssccsccssccsccescesccsccecees 8 Installing VMWare Appliance ccsccsccssccsccsccesccscceccesccsccecceses 9 Installing with VMWare S rvel cccccccsssseeceeceeseeeeeseeeeees 9 Installing with VMWare VSphere ccccccsssseceesesseeeeeeeees 10 Initial Network Configuration sccsccsccssccsccecccsccsccescesccsccecces 12 Private Server Licensing anne 13 HOW licensing Works ccccccccssececcceesecceceeeeseeeeseaaeeeeeseees 13 LICENCE ACTIVATION procedure ccceecceesecceseeeeeeeeeeeeeeenes 14 OBEN NEL ICE ER ee 14 Activating Private server LICENSE nennen 15 Private Server Web Administration ccsssccssssccssscccsssscessceoees 16 HOME Poren en E ee eon 16 Network Settings cccsccccccsssssccceseseeceeseeseeesseeaeeeeeseees 16 FES DOCH ON ee en 17 PCG NS cee cer cies aie ee einen 19 SSL Certificate sun 192. 2 1 Download Private Server update to version 1 2 1 Download Update 1 2 1 After downloading the dialog box will allow for installing 5 September 2011 Version 1 20 Update Private Server To update your Private Server click here Get Support Read the User Manual See the Private Server FAQ here Visit the Community Forum here Our Contact Details Customers with a valid support contract can contact us at Page 25 User Manual Get Console Private Server Download Private Server update to version 1 2 1 Download Update 1 2 1 Update file was downloaded successfully Install Private Server version 1 2 1 Install update Clicking on Submit button under Install Update will install the downloaded patch file The patch file will unpack and install the changes to the Virtual Appliance The last line should say DB successfully updated Install Private Server version 1 2 1 Install update Update Log Archive var www update gcprsupdatei 2 1 zip inflating var www functions_mgmt php inflating var www update_db php inflating var www htmi css style css extracting var www htmi img button png inflating var www html ima files button 1 jpg inflating var www htmi img files buttoni1_active jpg extracting var www htmi img files form_button png extracting var www htmi img files form_button_over png extracting var www html ima files icons png inflating var www html
3. Possibly invalid certificate Private Server will revert to self sign state automatically in 5 minutes GENERATE CERTIFICATE SIGNING REQUEST Apple iOS device can now user secure connection toggle in App Settings To enable SSL encryption in the Get Console Private Server the first step is to Generate a CSR Certificate signing request 5 September 2011 Version 1 20 Page 20 User Manual Get Console Private Server Home Network SSL Certificate Accounts Console SSL Certificate Gat Support To make the connection between the Apple iOS device and the Private Server more Read the Lice secure upload a SSL certificate to your private server here and then enable the Manual Secure Connection option in the Get Console app 2 Upload Certificate Files visit the Community Forum here Our Contact Details Customers with a valid support contract can contact us at Current certificate User Certificate getconsole ssl cert ps1 cloudstore co nz_Sergey crt Valid SSL Certificate Running The Secure Connection option on the Apple iOS Get Console app CAN be used p 6492804521 The following form will be presented complete this form using your own company and Common Name information SSL Certificate gt Generate CSR Please fill the form below to generate the Certificate Signing Request CSR Country Name United States of America State or Province Name eg Florida Au
4. img files Thumbs db inflating var www htmi img files transparent gif inflating var www htmi img files upload button active jpg inflating var www htmi img files upload button jpg extracting var www html img login background png inflating var www htmi index php DB was successfully updated MANUAL UPDATES The Manual Update process requires the download of the update package from the get console com private server webpage and then uploading this package to the Private Server Generally the Manual Update method will be needed when many O S level files need to be patched or added This means that the server will be rebooted during the upgrade process 5 September 2011 Version 1 20 Page 26 User Manual Get Console Private Server Update Options gt Update your Private Server manualy To manualy update your Private Server visit our website http www get console com and upload an update file using the form below 1 Click on Choose File button to choose Update File and then click Upload re psupdate_v1 5 zip After uploading click Submit button under the Install update heading Note the checkbox to perform the install unattended Clicking submit button will reboot the server and during the reboot the server will unpack the update zip file and run the associated install scripts This process can be viewed via the VMWare console if If the unattended install check box is NOT ticked then the update script
5. Generate Certificate Signing Request 2uuessneeseeeeneennnn 20 Obtaining SSL Certificate cccecccceescccceeeceeeeseceeeeseeenees 22 Upload SSL Certificate to Private SErver ccccseeceeseeeeees 23 Updating the Private Server Software sccsccssccsccescesccsccesees 24 Software Updates eessscseesnessessnessesnnnnnnsnnnnnnnnnnnennnnnnnnenn 24 Automatic UBER ACER 25 5 September 2011 Version 1 20 Page 2 User Manual Get Console Private Server ManlallPlatesn arsseenan nennen 26 Configuring iOS Device Get Console App to use Private Server 27 Troubleshooting Connectivity to Private Server sscssscssees 30 General Connectivity ISSUES eeeneeeeesnsseesnnsseennnnnennnnnnennnnnnenn 30 Server Not Recognized by License Server eccere 30 Incorrect Username or Password ccccsseseeeeeeeeeseeseees 30 License sel seen 31 REVISION HISTORY 5 May 2011 First Release SH RP 30 August 2011 Second Release for Private Server v1 2 SH RP 4 December Update for Private Server version 1 5 WHAT IS GET CONSOLE PRIVATE SERVER There are 2 Components to the Get Console solution 1 The Get Console App which runs on Apple iPads and iPhones 2 The Get Console Server which can be either the Public or Private version The below drawing summarizes the components of Get Console 3G WIFI cisco router Serial Cable Get Console App Hoeren BeA Remote PC juniper firewall Senar Web or Te
6. Private Server along with Generic text files Configuration Scripts and the ability to search within log files Private Server Web Manager Network Files SSL Certificate Accounts Web Console Files Terminal Logs from sessions to remote iPhones iPads etc that are generated by the Web Terminal on Private Server 1 Web Console Log File Terminal Logs from remote iPhones iPads etc that are uploaded by these devices to Private Server script files to run using the Get Console Script Manager 3 Terminal Scripts De Allows to upload text files for cutting pasting into terminal 4 Text Files n or for pushing down to remote iPads and iPhones 5 Search Log Files Allow to search any Web console or Uploaded terminal log aeann ioa file Log Files from Private Server processes ie Tomcat and also the logs from any upgrade process The 3 types of log files are 1 Web Console Log Files 1 these are web terminal session log files generated by a web user accessing an iPad iPhone in the field via the Private Server s Console web page The logs are stored by session time and by the user that was logged into the shared session from the Private Server web console 5 September 2011 Version 1 20 Page 17 User Manual Get Console Private Server 2 3 Files gt Remote Console Log File Remote Console Log File File Name File Owner Action 20110826 0097571 log webadmin delete file The files are owned by the Private Serve
7. Private Server 121 79 197 233 Secure Connection Username Password DROPBOX SETTINGS Dial al Am mn nam tthe Once these settings have been configured return to the main terminal window in the App and press the Connect Session button top nav bar in Terminal window second from left button and then select Share Session Camer 7 a You are Sharing your Terminal Sharing with Private Server The session code is 985846 The remote user can enter this code at 121 79 197 233 to access your current session Session Manager Telnet 10 64 3 25 Not Shared Copy tap to share with Private Server Email Connection Manager OK Once the session is shared a pop up appears in the iOS device provides the allocated session code Session codes to Private Servers always start with O The Globe icon will be green when session is being shared Session Manager F Telnet 10 64 3 25 Session Code 0985946 5 September 2011 Version 1 20 Page 28 User Manual Get Console Private Server The remote PC user can now see the remote iOS device in the Private Server home page and also in the Console page Network SSL Certificate Accounts Console Active Proxy Sessions Remote Host Device Name Device System Model Connected 115 189 129 158 Simon Hope s IPhone iPhone 2011 04 29 17 09 31 The PC user can also use a generic telnet client to access to remote iOS device terminal session using po
8. Server more secure Upload a SSL certificate to your private server here and then enable the Secure Connection option in the Get Console app Current certificate User Certificate fgetconsale ssl cert ps1 cloudstore co nz_Sergey crti Valid SSL Certificate Running The Secure Connection option on the Apple 105 Get Console app CAN be used Once the SSL Certificate has been successfully installed the SSL Page will show the green User Certificate as above 5 September 2011 Version 1 20 Page 23 User Manual Get Console Private Server The in the field Apple iOS devices will now be able to use the Secure Connection setting If this setting is selected while a self signed certificate is still installed on the Private Server an error about invalid Private server will appear Remote Settings Remote Server Private Server gt Private Server ps1 cloudstore co nz ATON Username simon ipguys com Password essesss B a UPDATING THE PRIVATE SERVER SOFTWARE Starting from Private Server version 1 2 the Virtual Appliance and Database files can be updated without re installing the Virtual Appliance This feature will be used to non distruptively update Private Servers from version 1 2 to version 1 3 and later There are 2 methods to update the Private Server software 1 Semi Automatic Updates 2 Manual Updates Although the Get Console developers test all Private Server updates
9. TIFICATE REQUEST MIIC4 0 CCAcg CAG Aw gZoxCZAIBGNVBAYTAk SaMREwDwy DVO GIEwhBdWArbGFuZDER MASGALUEBY MIOR Vja 2xhbmOxFDASHQNYBAcTCOd Id CBDb25zb2xIMRQwEgyDYOOL EwtFbrmdpbm lcemluZzzERMASGALUEAxMISm IFA ySaAx JAK Bk ghkiGdwOBCOEW FSNicHBycnRAZZVOLW Hybond b lu 2 Sth TIBIANBgk ghkiSGdwOBAGEFASOCAGEA MIIBCgKCAGEASYSU gt vUuPLIBsbRMHOg WOSpgPksAsGuwcabs TevimfSrGpTestr Tr GIT 6TweSqgStu 2HapB4 rgothskg sV9LknlliZIRsekK4dalScnGe nealulysez2 Yok Selet 7bwh4OsbhS xlfakuFeRT225 IFdG8O2wrER codubsacksquaqxBkgPFSLryey ednBluda 30QiikeryNNMiglcP WB Sy6VR zt gPltE2RDYpogluumoajrskh4e2q fglUwhSo22cHAC Vs Woof F398 F7hOpzJZsZ2ZcmukKKxSIPxjrHoeyzilIbthve RSGOF4d6 6u vTSIKVR RS 9euxPSSyxNaSCIsGztPrmkKvwIDAQABoAAWD OY KoZIhycHAQEFBOAD QgEBABAW Om YSqwpJ dnkGc8apZuwnatbiTwigFHOsebEl2ruduyyryyjow Tio Un HY Ley FYudtgelYjyduMSrr RNAUEIRT HHIGFzZFURhaWwWHMSsmBeg4uNDppwl saxr MVISZASEbkKOSGcNsNzFSRDGDFTwrea4slT 4 USE FH WZeEScHFbWwoMmkKfuASSsef o ShPzBg4jirxKbivyaZFALmSLFLTOSSErFhITCyloH1Smb dERNiFFYVEkRSSYUgJzimo FHa wxMlnceNPOLEIF41 amp StEHSUK3LE lt HchWergo g lhzPvkowvgg3lauvus98G8ry3 bFEZIUSKAAEkMEMOxBUuSkF ZIgI nn END CERTIFICATE REQUEST OBTAINING SSL CERTIFICATE Next you will need to contact a Certificate Authority Different Certificate Authorities have different processes for submitting CSRs and in turn issuing the SSL Certificate However generally the process follows as below Once you have paid for the certificate and subm
10. There is currently NO option to rollback an update after it has been installed Because of this we recommend using the VMWare or Snapshot facility to take a Snapshot of the Virtual Appliance before applying the update Should an update cause corruption to the Private Server revert to that VMWare snapshot and contact Get Console support SOFTWARE UPDATES There are 3 options on the Software upgrade page Update Options 1 Update your Private Server automatically Internet connection required 3 Update web server to the latest version Internet connection required 1 Upgrades between a point release can generally be performed automatically for example an upgrade from version 1 5 1 to version 1 5 2 2 Upgrades between major releases 1 5 1 gt 2 0 0 and some minor releases 1 5 1 gt 1 6 0 can only be performed via the manual method This will be noted on the www get console com private server page 3 Upgrades to the underlying Apache server can be performed automatically and independently of the Private Server We recommend checking and patching the webserver regularly to keep web security vulnerabilities minimized 5 September 2011 Version 1 20 Page 24 User Manual Get Console Private Server AUTOMATIC UPGRADES The Semi Automatic update process involves checking the Get Console com website for new Private Server sub versions for the Major minor release currently installed if anew version exists downloading it and the
11. al home screen above is displayed The home page gives an overall view of server and the session status The running status of the Get Console Private Server can be seen here as well as the incoming telnet and outgoing remote device telnet sessions Should there be connecting to sessions select the restart button The active session from remote Apple iOS devices iPad or iPhone are listed in the Remote iOS Device Sessions table If these iOS device sessions have been matched to a PC or Mac user connecting to the Private Server ie through the Private Server web site or via a telnet client then these are listed in the Matched Telnet Sessions table Note to update the Private Server software to the latest version use the link in the right side bar as identified above NETWORK SETTINGS This page allows the IP address netmask and default gateway settings to be manipulated through the web page These are the same settings initially made via the Command Line interface 5 September 2011 Version 1 20 Page 16 User Manual Get Console Private Server Private Server Web Manager Network Logs SSL Certificate Accounts Current Network Settings Click on device name to change settings Hardware Intel Corporation 82545EM Gigabit Ethernet Controller Copper Device etho IP Address 121 79 197 232 Mask 255 255 255 240 Default Gateway 121 79 197 225 FILES SECTION The main Files page provides access to the 3 types of Log files stored on
12. ckland Locality Name eg Miami Auckland Organization Name eg Miami Field Services Inc Cloudstore Organizational Unit Name eg Engineering Test Common Name eg the Fully Qualified Domain Name you have given to this Private Server for example getconsole miamifieldservices com ps l cloudstore co nz Email Address Generate CSR Fill in the details of you country location organization name and email address The Common Name of your organization must be a fully qualified domain name FQDN that you will allocate to the Private Server This 5 September 2011 Version 1 20 Page 21 User Manual Get Console Private Server is the most important part of the form as the certificate authority will run a query to find out who the owner is ofthe domain and email them to authorise the certificate request Also the FODN defined must be resolvable in DNS by the iOS devices Once this form has been filled in correctly a message will be displayed that the Certificate Signing Request has been successfully generated Click OK age at psl cloudstore co nz says Certificate signing Requst successfully generated In the window that opens up the CSR will be listed Copy and store this text to clipboard Include the BEGIN CERTIFICATE REQUEST nn END CERTIFICATE REQUEST lines in the your clipboard copy CSR Use following CSR for generating SSL certificate for your Get Console Proxy Server See BESIN CER
13. d proxy between the Apple iPad iPhone terminal session and the remote users sitting at PCs allowing the remote PC user to control the terminal session connected to the Apple iPad iPhone Public versions of the Server are hosted in US UK and New Zealand These can be used at no charge by any registered purchasers of the Get Console App to allow any remote PC to access the terminal session via the public website www get console com The performance of the end to end terminal varies greatly on the current load of the server and the latency of both the Apple device and the Remote PC users from the selected public server The Get Console Private Server extends the functionality of the Get Console solution by allowing end users or corporations to deploy their own privately hosted version of the Get Console public server component This has the following benefits Increased Security as the Private Server and Remote PC user are located behind the corporate firewall so no potentially sensitive field device configurations or data is transmitted through or stored on the public Get Console servers In addition the Private Server can install a valid corporate SSL certificate to allow the Apple device to Private Server connection to use SSL encryption Increased Performance as the latency between the Remote PC user and the Private Server is greatly reduced meaning the end to end performance of the remote control terminal session is fast and smooth Inc
14. enses available and if so will store the iOS device UDID against that Private Server and decrement the number of free licenses available The Private Server owner can delete unwanted UDIDs consuming CAL s by contacting us at support get console com a self service web portal for this purpose will become available later in the year 5 September 2011 Version 1 20 Page 13 User Manual Get Console Private Server LICENCE ACTIVATION PROCEDURE After purchasing licenses from the www get console com shop the purchaser can obtain their license key and then apply it to their installed server There are 2 parts to licensing Get Console Server 1 Obtaining License Key from www get console com redeem 2 Activating License against particular server at www get console com activation OBTAINING LICENSE KEYS After purchasing Private Server licenses or Airconsole Pro or XL products that contain bundled Private Server licenses the Get Console website sends an email to the purchasers provided email account with their order details attached To obtain license key go to the www get console com redeem page and enter the Get Console shop order number not invoice number and the surname as recorded on the email into this page Airconsole Pro Private Server License Redemption and Activation Use this page to Redem your Airconsole Pro included Licences Get Console Shop Order 4535 Number Surname on Order Mo If successfully matches the ord
15. er number and purchasers surname in our shop then a 15 character license key will be generated and optionally emailed to the user An example license key is hQivOFTE5synSno The single license key contains all of UDIDs Airconsole Pro Private Server License Redemption and Activation DO NOT LOSE THIS CODE Your License Key for 2 VER m UDID Licenses is Email Address for sending mam test com code optional 5 September 2011 Version 1 20 Page 14 User Manual Get Console Private Server ACTIVATING PRIVATE SERVER LICENSE The www get console com activation page allows for the binding of a Private Server license key to a particular Private Server On this page enter the license key obtained from the earlier process and the IP address and optionally the FODN of the Private Server that the license should be applied to Airconsole Pro Private Server License Redemption and Activation Use this page to activate your Private Server Licence Key License Key RETURN Private Server IP Address 213 44 234 7 Private Server FQDN if used The IP address or FODN IP Address are used in the Get Console or from v2 0 Airconsole Settings in order to share terminal sessions from these devices with Private Server The first time the Get Console app attempts to share its terminal window with Private Server it communicates with our license server to validate that the IP Address or FODN IP Address match up with a licensed server
16. erver uses a self signed certificate however this will not allow Secure Connection to be enabled on the iOS device until a valid certificate has been issued by an issuing authority and installed on the Private Server To enable SSL encryption between Apple iOS device and the Private Server a valid SSL certificate issued by a Certificate Authority trusted by Apple must be installed on the Private Server It is not possible to issue a Certificate from a private CA and use it on Private Server unless that private CA is trusted by all in the field iPads iPhones Generally it is much easier to buy and install on Private Server a low cost 10 SSL Certificate that is natively trusted by iPad iPhone The following flowchart summarizes the process of obtaining and installing an SSL Certificate in the Private Server and then enabling the Secure Connection in the iOS device App Settings After the flow chart a detailed example of obtaining and installing an SSL certificate is covered 5 September 2011 Version 1 20 Page 19 User Manual Get Console Private Server Complete CSR in Private Server Cut Paste CSR into Certificate Authority web portal ie RapidSSL com Verisign Comodo etc Cert Authority emails owner of domain for authorization domain owner authorizes via return mail Certificate Authority issues certificate via mail Upload Certificate to Get Console Private Server web interface Doesn t Work
17. gered by Completed At Select the vmx file from the unzipped package from the get console web site and click open The appliance will install The VM status must display a Success status at the bottom of this page to have been correctly loaded Select the play button to start the appliance Follow the Initial Network Configuration Instructions and Web administration sections below to complete the installation INSTALLING WITH VMWARE VSPHERE To setup the Private Server with vSphere download the image to a datastore repository visible to the vSphere server s Either the VMX VMDK or OVF package will work with vSphere The instructions below use the OVF package 5 September 2011 Version 1 20 Page 10 User Manual Get Console Private Server Cloudstore vSphere Client File Edit View Inventory Administration Plug ins Help tory DB En Ps and Templates Browse YA Marketplace Print Maps AM apie Select the OVA file from the downloaded package for method to install vmx use the New Virtual Machine wizard using the vmx vmdk as the existing VM disk Open Ei x Look ir E CCC Backend VA new do fe m Ez My Recent Documents seven v1 DL ova GetCons My Documents My Computer T Mo Hetwork File name E etConsole PrivateServer v1 01 ova T Places Files of type OV packages ovf oval Cancel Follow Deploy OVF Template Wizard dH Deplo
18. itted the CSR the Certificate Authority organization will perform a WHOIS on the domain owner and then email the FQDN common name owner for authorization to issue a certificate Once the domain owner has mailed an approval back to the Certificate Authority usually by clicking a link in an authorisation request email they will send through a certificate in crt 5 September 2011 Version 1 20 Page 22 User Manual Get Console Private Server format Ifthe Certificate Authority offers an option as to the format of the Certificate then choose Apache crt format Upload this certificate using the process as below UPLOAD SSL CERTIFICATE TO PRIVATE SERVER Using the upload certificate file link on the SSL Certificate page will take you to a page where you can select and upload the certificate you have been issued and upload it to the Private Server SSL Certificate gt Upload Certificate Current SSL Settings Virtual Appliance 55L Settings Click on SSL setting name in the table above to change it SSLCertificateFile Click on Choose File button to choose new SSL Certificate File and then click Upload Choose File Upload Once you have done this you will need to reload the server on the original SSL Certificate page If the certificate is invalid the server will automatically revert to a self signed certificate status within 5 minutes SSL Certificate To make the connection between the Apple 105 device and the Private
19. ivate server or disable Secure Connection in settings then try again SERVER NOT RECOGNIZED BY LICENSE SERVER Console Companion ps1 get console com Is not a valid remote server Please choose a valid server from the settings page OK The above message will be displayed on the Apple iOS device when although there is internet connectivity for the iOS device the Private Server IP address or Hostname has not yet been enabled on our license server Please purchase a license from the www get console com shop or if one has been purchased already please provide the server details to activations get console com to ensure it has been activated INCORRECT USERNAME OR PASSWORD 5 September 2011 Version 1 20 Page 30 User Manual Get Console Private Server Console Companion Error logging in to remote console Logon failed Please check your username and password match those configured in your private server OK This error occurs when username has either not been defined on Private Server Accounts tab or has been defined but the password is wrong Note that both Username and Password are case sensitive LICENSE ISSUES Where the Private Server is defined on our License Server but does not have any available licenses then when connecting the user will receive an error like below Console Companion ps1 cloudstore co nz is not a valid remote server Please choose a valid server from the settings page Additio
20. lnet MAC based User sun server etc Telnet SSHv2 over mobile termina ees WIFI 3G Field Device C2 RJ45 Apple iPad runing Local Terminal Tunnels serial session session via HTTPS l Remote PC directly controls Field Device GET CONSOLE APP The Get Console app provides iPads and iPhones with terminal connectivity via Serial Telnet or SSH v2 to IT equipment for example a Cisco router or a Linux Server This allows a field engineer to configure such IT equipment in the field using the apps intuitive terminal window The app can then optionally act as a 5 September 2011 Version 1 20 Page 3 User Manual Get Console Private Server terminal server to share its serial Telnet SSH sessions with remote users via a Get Console Server Public or Private The app is designed primarily to be a mobile terminal it enables field engineers connect to and configure network devices and servers via these devices serial console ports or SSH Telnet server and then if required use the Apple 3G or WIFI connection to share the terminal window GET CONSOLE SERVER There are 2 versions of the Get Console Server 1 The publicly available Get Console Servers hosted at the website www get console com 2 The private version which is hosted on a customers own network and secured by their own network security policy the subject of this user manual Both versions of the Get Console Server acts as a connection broker an
21. n if downloaded successfully installing it No restart of the Private Server is generally required To check for new versions of Private Server click the Check for Updates button on the home page or any of the other Private Server pages located on right hand side bar Private Server Web Manager Network Files SSL Certificate Console Welcome to the Get Console Private Server This web interface allows you to manage your Get Console Private Server Use this management interface to change network settings view system and uploaded from your devices logs manage SSL certificates and User accounts In addition this interface allows direct console access to remote iOS devices currently available as below Get Console Server Status Running Tn rectart ctart the Get Concnle Private Server click here Update Private Server To update your Private Server cic here et Support Read the User Manual Select option 1 Automatic Updates Requires Internet Connectivity Home Network SSL Certificate Accounts Update Options Logout Update Private Server To update your Private Server click here If a new update is available then it will be presented as available to download in the case below version 1 2 0 can be upgraded to 1 2 1 is available Update Options gt Update your Private Server automatically Internet connection required Check for updates The latest Private Server version is 1
22. nal information Could not authenticate licence The licensing server returned code 0003 All UDID licenses are in use i aT OK The possible error codes useful for Get Console Support are 0001 Private Server Defined but no License Assigned 0002 Private Server Defined License Assigned but no un expired licenses available 0003 Private Server Defined License Assigned but all existing licenses are used up by other devices Other error codes maybe added in the future In all these cases if you have purchased a Private Server license from the Get Console shop and requested its activation assignment but are still receiving this error then please contact Get Console support via email at support get console com When using the www get console com activation method to load licenses onto Private Servers the process takes around 2 minutes For manually activated licenses there is a lead time of 4 hours from purchase for our staff to upload the CAL license details to the license server 5 September 2011 Version 1 20 Page 31 User Manual Get Console Private Server 5 September 2011 Version 1 20 Page 32
23. ng mapped to the VLAN or Virtual NIC that was allocated during the OVF or VMX installation this CLI wizard is used to set the initial network configuration As DHCP is disabled this initial network configuration must be provided via the VMWare web console with CLI interface GCPS V1 01 on 10 64 0 100 File View VM a u ys 82 amp Re Q Welcome to the Private Server CLI Manager Private Server IP Address 111 112 113 114 Private Server Network Mask 255 25 255 248 Private Server Default Gateway 111 112 113 113_ NOTE the above IP address details in the graphic are examples only Use addressing as per your deployment design After completing this script the Private Server will start with the configured IP settings After this step all remaining configuration can be completed via the web interface by navigating to http ip address given to server PRIVATE SERVER LICENSING HOW LICENSING WORKS The Get Console Private Server is freely accessible to download from the web site however each unique iOS device wishing to connect to the Private Server uses a Client Access License CAL that must be purchased in advance of use from the Get Console com shop The CAL is enforced when the Apple iOS device tries to connect to the Private Server for the first time On first connection the Apple iOS device will initially make a check with our license server to see if the Private Server as configured in the Apple iOS device has free lic
24. nual Get Console Private Server OBTAINING THE PRIVATE SERVER SOFTWARE The Get Console Private Server software is a free download available from the www get console com private server website The file is packaged as either an OVF Open Virtualization Format package or a VMWare vmx vmdk package While the download is free the Server will not work with Apple iOS devices until it is licensed see licensing section below Get Console offers support for VMWare Server 2 0 or vSphere 4 0 and above installation of the vmx vmdk package The OVF format package is supplied for other non VMWare virtualization hypervisors however it has not been tested on other hypervisors If you are running VMWare we recommend downloading the VMX VMDK zip file and install as per the instructions in the later sections VIRTUAL APPLIANCE REQUIREMENTS The Get Console Private Server Appliance has the following minimum specification Operating System Centos 5 5 64 bit CPU 1 Processor Memory 1 GB HDD 5 GB VMWare Hardware Version Support Required version 7 As the Get Console Private Server is a 64 bit Guest OS appliance It will only run on a 32 bit host operating system if the underlying CPU of the physical host machine is 64 bit capable See the following table from vmware com to understand compatibility 32 Bit Guest OS 64 bit Guest OS a Get Console Po 64 Bit Host OS Supported roe GE 64 Bit Host OS Supported Er Private Server
25. options selected Deploy OYF Template Iof x Ready to Complete Are these the options you want to use Source OVE Template Details Name and Location Host Cluster Resource Pool When you click Finish the deployment task will be started Deployment settings Download Size 945 MB Size on disk 5120 MB Datastore Name GetConsole PrivateServer v1 01 Network Mapping Folder Cloudstore Colo1 Ready to Complete Host Cluster Cloudstore Cluster Datastore QNAP FTP1 NFS Network Mapping dyportgroup 39538 to Distributed VL99 OUTSIDE INTERNET Help lt Back Finish Cancel Post installation start the Virtual Appliance with the power on button then open the web console for the virtual machine to complete the initial network configuration steps as described in the next section INITIAL NETWORK CONFIGURATION After deciding on the deployment design the first task in configuring the Private Server is to set the IP address and default gateway This is done by following the steps below Once the Private Server is available in VMWare and has been booted launch the Virtual machine Web Console A Centos console will be presented with a login and password prompt The default username and password are USERNAME webadmin 5 September 2011 Version 1 20 Page 12 User Manual Get Console Private Server PASSWORD w3badmin As the virtual appliance comes up with no network configuration apart from bei
26. or use on field equipment Files gt Command Script Files Command scripts File Name File OQwrer Action Priv Exec Prompt Commands txt webadmin delete file 3750 1 vlans txt sergey delete file ASA5510 tet sergey delete file Upload Cmd Script Click on Choose File button to choose Cmd Script file and then click Upload Choose File Upload 5 September 2011 Version 1 20 Page 18 User Manual Get Console Private Server Use the Choose File and the Upload to upload config scripts templates to the Private Server Note that all in the field iOS devices will be able to see these files and download them ACCOUNTS This section of the server will allow additional user accounts to be added on the server You can add a new username and delete usernames except the webadmin user Accounts are used for in the field iPad and iPhone users to connect to the Private Server A valid username and password must be entered in the Get Console App settings and will be checked when connecting to the Private Server Private Server Management Accounts Username Change Password Delete Account webadmin Change Password not available SSL CERTIFICATE By default the sessions between the Private Server and the remote Apple iOS device are transmitted using HTTP packets This allows faster transfer of packets from the web interface to the remote device and back and therefore faster response to key strokes By default the Private S
27. r user logged in and connected to the remote session Clicking the file name link will download it iOS Device Log Files 2 these are terminal session log files generated on iPads iPhones in the field that can if the user chooses to be uploaded from the iOS device to the Private Server so that the Private Server has a centralized record of all in the field terminal activities Files gt iOS Device Log File iOS Device Log File File Name File Owner Action harbourOl txt webadmin delete file log 2011 08 13 121857 1xt sergey delete file log 2011 08 13 125325 txt sergey delete file The files are owned by the Private Server user entered on the iOS device settings at the time they were uploaded Clicking the file name link will download it System Log files 6 these are the log files used by the Private Server itself For example the Tomcat logs Apache logs and logs from upgrade process These are generally for Get Console support to review during any system troubleshooting and are not that useful to end users In addition to these log files the Files section allows for web users to upload text files generally for cutting and pasting into terminal windows or specialized configuration scripts that can be run by the Get Console app s Scripting engine Script Manager Once uploaded and stored on Private Server the iPad iPhone users in the field can browse and download these text or script files over the air WIFI 3G f
28. reased Flexibility as the Remote PC user can use either the Private Servers built in Web Terminal or any Telnet client of their choosing such as SecureCRT or puTTy Increased Ease of Use as the Private Server displays all currently available sessions and the name of the mobile terminal associated generally the field engineers name The field engineer does not need to pass the session code number to the remote PC user as the remote PC user can see all the sessions and quickly identify the session he wants to connect to Upload and Manage corporate configuration templates for field devices and download them to the iPad iPhone in the field Keep log files of all field terminal sessions and upload them automatically for audit trail and troubleshooting 5 September 2011 Version 1 20 Page 4 User Manual Get Console Private Server https getconsole yourcompany com Field Device is Cisco Router Local Console Session Ponmenneers u Serial Telnet SSH Terminal Window 15 oO 5 A E j 7 _ Encrypted Ss 3 Transport 515 H Edit Configuration Templates Upload Log Files Existing Configuration Repository Seng Top LEP LLLP Firewall es e Get Console Field Engineer Private Server View and Update Service Desk Software Requests Incident Tickets WAN h private or Your Field Force at Client Site internet Your Company HQ 5 September 2011 Version 1 20 Page 5 User Ma
29. rt 2323 To use a third party telnet client rather than the web client simply telnet to the Private Servers IP address or domain name on TCP port 2323 A session code prompt will be presented where the PC user can enter the code of the remote iOS device to be connected The Console page will allow the PC based user to access the console session of the remote iOS device Once you select this page you will be prompted for a session code however simply clicking on one of the available session codes displayed above the console window will automatically enter the code and connect to the remote iOS device session 5 September 2011 Version 1 20 Page 29 User Manual Get Console Private Server TROUBLESHOOTING CONNECTIVITY TO PRIVATE SERVER GENERAL CONNECTIVITY ISSUES Console Companion Failed to connect to remote server OK The above message will be displayed on the apple iOS device when 1 There is no connection to the internet or private network where the Private Server resides or 2 The FQDN of the Private Server if configured as FQDN rather than IP address cannot resolve to an IP address via the iOS device or 3 The Private Server is nor reachable switched off not routable or possibly firewalled on ports 80 or 443 4 Where Secure Connection is selected in the Get Console App but no valid SSL Certificate has been installed on the Private Server Please correct the connectivity issues for the iOS device or Pr
30. so it is important that these values match and are correct 5 September 2011 Version 1 20 Page 15 User Manual Get Console Private Server PRIVATE SERVER WEB ADMINISTRATION HOME PAGE Home Network Files SSL Certificate Accounts Web Console Settings Logout Welcome to the Get Console Private Server Update Private This web interface allows you to manage your Get Console Private Server Use this management interface to change network Server settings view system and uploaded from your devices logs manage SSL certificates and User accounts In addition this To update your Private interface allows direct console access to remote iOS devices currently available as below Server cic here Get Console Server Status Get Support To restart start the Get Console Private Server col here Read the User Manual See the Private Server FAQ here Active Sessions Remote iOS Device Sessions Visit the Community Forum here Session Key Remote Host Device Name Device System Device System Connected oo Model version Our Contact Details 122 56 234 218 Simon Hope s iPhone iPhone 7 0 4 2013 12 05 05 08 00 Customers with a valid Matched Telnet Sessions support contract can contact us at Session Key Remote IP Address Connected p 6492804521 e support get console com Version 1 5 After connecting via web browser to the Private Server and logging in using the default credentials webadmin w3badmin the initi
31. v1 3 and later can also integrate with an existing corporate trouble ticket system If this feature is enabled the Private Server will require its own email account on the corporate mail server and rights on this server to send mail via SMTP port25 and be able to POP its mail account port 110 FIREWALL PORT REQUIREMENTS The following Table describes the ports used by the Private Server These ports will need to be open to the Private Server from any intervening firewall TCP Port Description Used For S O HTTPS Where SSL certificate has been installed and the secure connection is selected in the iPad 5 September 2011 Version 1 20 Page 6 User Manual Get Console Private Server iPhone app settings From iPhone iPad to Private Server tunnelling serial session to Private Server From Remote PC user to Private Server for accessing the admin and web terminal function This port is also used outbound from the Private Server to check the www get console com website for software updates optiona used between Private Server and user defined mail gateway used for sending updates to troubletickets service requests back to existing corporate ticket service desk software In addition to the above TCP port requirements a general requirement of Private Server licensing is the provision of Private server on a Static IP address The IP address can be either public or private however in order to successfully license Pri
32. vate Server it cannot dynamically change 5 September 2011 Version 1 20 Page 7 User Manual Get Console Private Server COMMON DEPLOYMENT ARCHITECTURE The below drawing describes the most common high level network design for deploying Private Server In the field iPad s running Get Console App connected to field equipment In the field iPads connect WR Corporate Firewall NAT s external IP to Private Server via its i to DMZ network IP of Private Server ublic Internet address p a for ports 80 443 Outside Internet DMZ Network i e 172 16 20 0 24 Corporate Firewall Inside Corporate User ETRE yj Internal PC users connect to Private Server on its DMZ address via HTTP or Telnet 2323 192 168 10 0 24 NOC or Remote Access Get Console Private Server Common Deployment Architecture 1 While not the only method this design allows the Private Server to be securely placed where remote internet connected iPads and iPhones can reach it while also allowing secure access from internal users 5 September 2011 Version 1 20 Page 8 User Manual Get Console Private Server Other alternatives include forcing internet connected iPads and iPhones to use the iPad iPhones built in Cisco VPN client to build a IPSEC VPN tunnel to the Corporate Firewall VPN Concentrator and then launch the Get Console session sharing connection to the Private Server This alternative alleviates the need for NAT and also means Pri
33. vate Servers hosted behind dynamic public IP addresses can be used via a static internal private IP address INSTALLING VMWARE APPLIANCE This section provides instructions for installing the Get Console Private Server on either VMWare Server 2 0 free Vmx VMDK package or on a VMWare vSphere Cluster OVF package Other VMWare platforms should follow the VMWare Server instructions Non VMWare platforms should work however are not officially supported please see the community forum at www get console com forum for community support on non VMWare hypervisors INSTALLING WITH VMWARE SERVER To install the Get Console Private Server software in VMWare Server version 2 0 or later Download the latest vmx vmdk package from the Get Console website Unzip into your virtual machines directory onto a datastore location of your VMWare Server Launch VMWare Server Select Virtual Machines tab Then select Add Virtual Machine to Inventory 5 September 2011 Version 1 20 Page 9 User Manual Get Console Private Server wu Mware Infrastructure Web Access Simon Hope amix t60p Application Virtual Machine Administration il D T Help Virtual Appliance Marketplace Log Out Inventory a amix t60p E amix t60p Yirtual Machines Commands taj Name CPU Memory Create Virtual Machine Add Virtual Machine to Inventory Selected Virtual Machine None Target Status Triggered At Trig
34. will prompt user for confirmation of the script to run and timing of the reboot via the VMWare console terminal The terminal needs to be accessed within 30 seconds of pressing submit or the upgrade will be cancelled and the original version of the Private Server will boot CONFIGURING IOS DEVICE GET CONSOLE APP TO USE PRIVATE SERVER To enable a particular Apple iOS device to use the private server 4 fields must be populated correctly in the Get Console app Settings 1 the IP address or FQDN details of the Get Console Private Server An FQDN is needed to support the Secure Connection option These details MUST match the details in the license activation process described in above section 2 avalid username for a user defined on the Private Server must be entered into username field for example webadmin 3 the password for that Private Server hosted username must be entered correctly for example w3badmin 4 the Remote Server setting must have Private Server selected as opposed to North America Asia Pac or Europe Please note that ALL fields are case sensitive Do NOT enable the Secure Connection switch in the App until a valid SSL Certificate has been installed on the Private Server See the SSL Certificate Section below An example of valid iOS device settings is below 5 September 2011 Version 1 20 Page 27 User Manual Get Console Private Server YALE Mayo SHARING SETTINGS Remote Server
35. y OYF Template Oe x Name and Location Specify a name and location For the deployed template Source Name OVF Template Details GetConsole PrivateServer v1 1 Name and Location Host Cluster The name can contain up to 80 characters and it must be unique within the inventory Folder Resource Pool Ready to Complete j H Inventory Location Cloudstore El py Cloudstore Cniot El Amix Capital For the network settings map the network port of the OVF template to your desired VMWare NIC or VLAN In this example case as the appliance will have a public IP address we have mapped to an external 5 September 2011 Version 1 20 Page 11 User Manual Get Console Private Server VLAN If mapping to an internal or DMZ privately addressed VLAN or NIC then for your server to be reachable from internet connected Apple iOS devices the required NAT translations on your external firewall for TCP ports 80 and or 443 to the Private Server will be required see Common Deployment Architecture section Deploy OFF Template Oy x Network Mapping What networks should the deployed template use Source OVE Template Details Mame and Location Host f Cluster Resource Pool Datastore Network Mapping Ready to Complete Map the networks used in this OVF template to networks in your inventory Source Networks Destination Nebworks dvpaorkgraup 39538 Prior to deploying the Wizard summarizes the
Download Pdf Manuals
Related Search