Ubuntu: Server 12.04

32-BIT
64-BIT

CentOS 6.5

32-BIT
64-BIT

BashX


64-BIT

Install via command line

Using apt

1.Install the NetCloud Client GPG signing key.
    $ wget -O - http://reposerver.pertino.com/Pertino-GPG-Key.pub | sudo apt-key add -
2.Add the NetCloud Client repository server to the distribution sources list.
    $ sudo sh -c "echo 'deb http://reposerver.pertino.com/debs precise multiverse' > /etc/apt/sources.list.d/pertino.list"
3.Install the NetCloud Client.
    $ sudo apt-get update && sudo apt-get -y install pertino-client
4.You will be prompted for your NetCloud user information.

Enter your username and password.

5.You now have a new network interface attached to your private NetCloud Engine network.

To confirm, display the NetCloud Engine virtual interface with

    $ ifconfig

or view the NetCloud Engine management interface.

    $ ifconfig pertino0

The pertino0 interface will have a dynamic private address for IPv4 and IPv6. You will also have a privately accessible Fully Qualified Domain Name (FQDN) displayed in the management console.

6.

For more information, visit our support forum.

Using dpkg

1.Download the latest Cradlepoint NetCloud Client package for your platform and install.

Using 32-bit, enter the following commands:

    $ wget 
    $ sudo dpkg –i 

Using 64-bit, enter the following commands:

    $ wget 
    $ sudo dpkg –i 
2.You will be prompted for your NetCloud user information.

If logging in manually:

a. Enter your NetCloud user name and password.

If logging in using device authentication:

a. Download your API key.

Click on the link below and follow the directions under "How do I generate the key" section to download your API key file.
http://knowledgebase.cradlepoint.com/articles/Support/NCE-Device-Authentication-FAQ

b. Copy the file apikey.pertino that you downloaded above to /tmp

c. You must then modify the file owner and permissions:

    $ cd /tmp
    $ chown root:root apikey.pertino
    $ chmod 600 apikey.pertino

d. You will not be prompted for a username and password. Installation output should look something like this:

The following NEW packages will be installed: pertino client
0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
Need to get 0 B/12.3 MB of archives.
After this operation, 59.2 MB of additional disk space will be used.
Preconfiguring packages ...
Selecting previously unselected package pertino-client.
(Reading database ... 55760 files and directories currently installed.)
Preparing to unpack .../pertino-client_410-4379_amd64.deb ...
Unpacking pertino-client (410-4379) ...
Setting up pertino-client (410-4379) ...
Registering client with API key ...
Merging any new configuration items into existing config
3.You now have a new network interface attached to your private NetCloud Engine network.

a. To confirm, display the NetCloud Engine virtual interface with ifconfig, or view the NetCloud Engine management interface.

    $ ifconfig pertino0

b. The pertino0 interface will have a dynamic private address for IPv4 and IPv6. You will also have a privately accessible Fully Qualified Domain Name (FQDN) displayed in the management console.

4.

For more information, visit our support forum.

Using yum

1.Download the latest Cradlepoint NetCloud Client package for your platform and install.
    $ sudo wget -O /etc/yum.repos.d/pertino.repo http://reposerver.pertino.com/pertino.repo
2.Install the NetCloud Client.
    $ sudo yum -y install pertino-client
3.To start the Cradlepoint NetCloud Client, you must enter your NetCloud account credentials by running the .pauth command. Then start the NetCloud Engine service.
    $ sudo -i
    $ cd /opt/pertino/pgateway
    $ ./.pauth -u <username> -p <password>

If your password contains special characters, put your password in single quotes.

    $ service pgateway start
4.You now have a new network interface attached to your private NetCloud Engine network.

To confirm, display the NetCloud Engine virtual interface with

    $ifconfig

or view the NetCloud Engine management interface.

    $ ifconfig pertino0

The pertino0 interface will have a dynamic private address for IPv4 and IPv6. You will also have a privately accessible Fully Qualified Domain Name (FQDN) displayed in the management console.

5.

For more information, visit our support forum.

Using Cradlepoint NetCloud BASHX Client Package

1.System Requirements

The NetCloud Client BASHX Installation Package is targeted for most any x86_64 Linux distribution. The following are the basic requirements necessary for the NetCloud Client to function properly.

  • x86_64 machine type (uname -m)
  • GLIBC 2.15 (or higher)
  • access to the internet over port 443
  • dhclient utility
2.Installation

The BASHX Installation Package is a self-extracting archive. It will perform the necessary steps to get the package installed onto the system in a standard way.

* Download the latest NetCloud Client package for your platform and install:Using 32-bit, enter the following commands:

$ wget 

* Execute the installation package as root

    $ su -
    $ ./pertino-client-###-###.bashx

* Authentication

$ cd /opt/pertino/pgateway

— User Authentication:

$ ./.pauth -u user@email.com -p 'password'

Or

— Device Authentication:

$ ./.pauth -a {apikey}

or

$ ./.pauth -f {apikeyfile}

* Start the client

    $ cd /opt/pertino/pgateway/init
    $ ./pgateway-service.sh start
    
3.Manifest

The following folders and files are created during the installation process.

    /opt/pertino/pgateway/certs
    /opt/pertino/pgateway/conf/client.conf
    /opt/pertino/pgateway/.gatewayattributes
    /opt/pertino/pgateway/init/pgateway
    /opt/pertino/pgateway/init/pgateway.conf
    /opt/pertino/pgateway/init/pgateway.service
    /opt/pertino/pgateway/init/pgateway-service.sh
    /opt/pertino/pgateway/lib/skyhook-wps/4.9.1_08/linux-x86_64-ubuntu/libwpsapi.so
    /opt/pertino/pgateway/logger-auth.conf
    /opt/pertino/pgateway/logger-gateway.conf
    /opt/pertino/pgateway/logger-tray.conf
    /opt/pertino/pgateway/mycert.pem
    /opt/pertino/pgateway/.pauth
    /opt/pertino/pgateway/pDiagnosics
    /opt/pertino/pgateway/pertino
    /opt/pertino/pgateway/pGateway
    /opt/pertino/pgateway/run
    /var/log/pertino
	     
4.Basic Usage

Use the script provided in /opt/pertino/pgateway/init to start, stop and restart the Client.

* Start the client

    $ ./pgateway-service.sh start

* Stop the client

    $ ./pgateway-service.sh stop

* Restart the client

    $ ./pgateway-service.sh restart

Use the command line utility in /opt/pertino/pgateway to connect, disconnect or manage networks.

* Show the current status

    $ ./pertino -s

* Connect the client to the current NetCloud Engine network

    $ ./pertino -c

* Disconnect the client from the NetCloud Engine network

    $ ./pertino -d

* List available networks

    $ ./pertino --list-networks

* Select a specific network

    $ ./pertino --select-network={network name}
5.Troubleshooting

A diagnostics utility is provided to aid in diagnosing issues. A report is generated when the utility is run that provides information on where issues may exist.

* Execute the diagnostics utility

    $ cd /opt/pertino/pgateway
    $ ./pDiagnostics
        

* View the report using a browser such as Firefox.

    $ firefox diagnostics.html

For deployment automation, we have provided sample source code for Puppet and Chef in GitHub.

Puppet Scripts
Chef Scripts

If you experience any issues, please visit our support site and submit a request.

For information on how to read the NetCloud Client log files, please visit this page.

Chat now Click to Chat