====== Connection, login and credentials ====== 

To log into the gateway, you will need to connect to it either through the network (through SSH) or sometimes through the debug interface (for [[wiki:ibts:connect_ibts|iBTS]] and [[wiki:istation:connect_istation|iStation]]). The remote SSH access is available on several network interfaces, depending on the gateway: either through its main Ethernet interface, or by the [[wiki:ibts:connect_ibts#local_connection|local Ethernet port for iBTS]], or the [[wiki:ifemtocell:connect_ifemto#wifi_ap_connection|iFemtoCell local Wifi Access Point]].

To access remotely the gateway, you will have to [[#addressing_the_gateway|discover it on the network]], either through its name or its IP address.

For all those access methods, you will need to choose a [[#user_accounts|user account]] with its corresponding [[#default_password|password]].

===== Addressing the gateway =====

The easiest way to connect to your gateway is to address it by name. Wirnet gateways are named after their serial number, as described below, with **XXXXXX** replaced by the six hexadecimal digits from the serial number. These digits are taken from:

  * The last six hexadecimal digits of the “CPU module ID”  for iBTS, 
  * The last six hexadecimal digits of the “Board ID” for iFemtoCell and iStation
  * The last six digits of the EUI for iZeptoCell. 

The prefix depends on the gateway type, and is of the form “klk-GGGG-”. The case is not important, as the DNS is case-insensitive. This gives:

  * ''klk-lpbs-**XXXXXX**'' for iBTS
  * ''klk-wifc-**XXXXXX**'' for iFemtoCell
  * ''klk-wiis-**XXXXXX**'' for iStation
  * ''klk-fevo-**XXXXXX**'' for iFemtoCell-Evolution
  * ''klk-zeth-**XXXXXX**'' for iZeptoCell Ethernet
  * ''klk-zcel-**XXXXXX**'' for iZeptoCell Cellular

For example,
 * if a Wirnet iBTS has 729ATf**1234AB** as CPU module ID, the hostname will be:

 ''klk-lpbs-**1234AB**''

  * if a Wirnet iFemtoCell has 704BEc**1234AB** as board ID, the hostname will be:

 ''klk-wifc-**1234AB**''

  * if a Wirnet iZeptoCell Ethernet has 7076FF0078**1234AB** as gateway EUI, the hostname will be:
  
  ''klk-zeth-**1234AB**'' 
  
  * if a Wirnet iZeptoCell Cellular has 7076FF0078**1234AB** as gateway EUI, the hostname will be:
  
  ''klk-zcel-**1234AB**'' 
  
Please note that these names are resolvable when your gateway is connected to your network through its main Ethernet interface, and when your network has a standard way of linking DHCP leases to the local DNS zone. If you do not have this kind of standard network setup, you may have to rely on another way of addressing your gateway, .e.g. checking your DHCP server to get the gateway’s IP, or using a static IP configuration on the gateway.

++++ Alternative naming and addressing |

If the above way of addressing your gateway does not work, you may rely (for firmware version 4.1 and above, or starting 4.0 for iFemtoCell) on autonomous addressing and local name resolution, sometimes called “Zeroconf” or “Bonjour”. This way of addressing it also necessary when the gateway is directly connected to a computer, i.e. not through a network switch or router.

This works in any application using standard name resolution techniques. The OS implements the specific standard, either [[https://en.wikipedia.org/wiki/Multicast_DNS|Multicast DNS]] or [[https://en.wikipedia.org/wiki/Link-Local_Multicast_Name_Resolution|LLMNR]], the former being more common on Linux and Mac OS, and the latter on Windows.

The local name is then (replacing GGGG with the gateway type and XXXXXX with the serial):
  * ''klk-**GGGG**-**XXXXXX**'' (for LLMNR)
  * ''klk-**GGGG**-**XXXXXX**.local'' (for Multicast DNS)

The name resolution is done on all the interfaces, i.e. backhaul Ethernet port, LOCAL Ethernet port (for iBTS), WiFi client and WiFi access point (for iFemtoCell).

Otherwise, you can also address the gateway by IP address. You can do so by looking at the leases given by your DHCP server. Please contact your local network administrator for more information.

For iBTS, in case you use the LOCAL Ethernet port, the default IP address of the gateway is 192.168.1.1.

++++
===== Network shell access (SSH) =====

Start an SSH client (typically Putty on Windows) using the gateway’s name or IP address (the port is the standard 22).

After getting a prompt: enter login/password (e.g. “''root'' / ''pdmk-**$serialno**''”). See [[#default_password|below for other login and credentials]]. In case of failure, request password to Kerlink support team.


===== User accounts =====

By default different accounts are available on the system:
  * ''root'' with full access to any tools, files and devices.
  * ''support'' with limited access.
  * ''usbuser'' with full access to any tools, files and devices. ''usbuser'' has no ''/home'' directory, it is dedicated to protecting the USB access.
  * ''admin'' dedicated to web interface access, SMS commands and RESTAPI.

===== Default password =====

==== root ====
 
To prevent Web robots to attack the gateway with standard login/password such as ''root''/''root'', default password is built using the last 6 digits of the serial number, __CPU module S/N__ for Wirnet iBTS, __EUI__ for Wirnet iZeptoCell and __board ID__ for other Wirnet Gateways: ''pdmk-**$serialno**''.

For example, if the serial number of a CPU module is ''641ATe0507DD'', then the root password will be ''pdmk-0507DD'' (case sensitive).

This 6 digits number can also be retrieved in the hostname. It is displayed in the shell prompt:
<code>
klk-lpbs_0507DD login: root
Password: pdmk-0507DD
</code>




==== usbuser ====

Default ''usbuser'' password is ''USBklkPassword''.

==== admin ====

Default ''admin'' password is ''pwd4admin''.


===== How to change the passwords =====

<note warning>
For security reasons, it is strongly recommended to change the default passwords.
</note>

Use the following command to change the password: 

<code bash>
passwd <account>
</code>

<note important>The support account can't modify passwords.</note>

===== File transfer (SFTP/SCP) =====

Start an SFTP client (typically WinSCP on Windows) using the gateway’s name or IP address. 

Enter a login and password (“''root'' / ''pdmk-**$serialno**''”). See [[#default_password|below for other login and credentials]]. In case of failure, request password to Kerlink support team.

==== WinSCP on Windows ====

To retrieve files easily with a graphical interface, WinSCP can be used: [[https://winscp.net/eng/index.php|Download link]].\\

WinSCP acts as the Linux ''scp'' or ''sftp'' command, allowing to retrieve file with a copy/paste or drag'n'drop from a distant server to a computer.\\

Install WinSCP as a classic Windows program and run it.

**<fc #ff0000>1</fc>** - **Configure** the protocol. Here, ''Secured File Transfer Protocol'' is required.\\
**<fc #ff0000>2</fc>** - **Configure** the gateway's IP address.\\
**<fc #ff0000>3</fc>** - **Enter** username : default is root.\\
**<fc #ff0000>4</fc>** - **Enter** password : default is the following pattern ''pdmk-**XXXXXX**'' where XXXXXX are hexadecimal digits from the serial number. More informations [[#default_password|here]].\\
**<fc #ff0000>5</fc>** - **Click** to login.

{{:images:winscp-login.png?| }}

==== Send/Retrieve files ====

**<fc #ff0000>1</fc>** - **Copy/paste or drag'n'drop** the file on computer's side window.\\
**<fc #ff0000>2</fc>** - A window will appear - **Click OK** - to confirm the transfer.\\
**<fc #ff0000>3</fc>** - **Check** the folder where the file has been downloaded. It is now on the computer's folder.\\

{{:images:winscp-getfile.png?| }}