Connection Management

In this section we will cover the various configuration options for Tenup connectivity. Tenup provides functionality for terminating sessions, keeping sessions alive and connecting to 1010data from behind corporate proxy servers.

Basic Connectivity Options

There are many options available in Tenup for managing connectivity. The two most basic are the -l and -L options. The -l option tells Tenup to logout of its 1010data session before the program exits:
Note: The above is the default behavior for Tenup.
In the above example, Tenup will complete its extract and load process and then logout of 1010data. Conversely, you can also tell Tenup to stay connected to its current session and then exit after the extract and load process is complete:

In the above example, Tenup will exit after it completes the extract and load process but your User ID will remain logged in to 1010data.

Tenup also provides an option for outputting the current session ID and password to the console:
$ tenup64 -u [USERNAME]-S
Using the -S option will output your session ID and your encrypted password. This information can be used to initiate a Tenup transaction using an existing session ID and encrypted password:
Note: The above two options will not logout of a 1010data session by default.

Terminating and Possessing an Existing Session

You may encounter a situation in which the account you used to connect to 1010data has already established a connection outside of your Tenup session. This could happen if you recently logged into 1010data via another interface and didn't log out, or if you use a shared account within your work group. If you try to load data with Tenup while your account is already logged in, Tenup will return an error:
Error - 5 - Already logged in
In this event, you will need to end or possess the existing session before Tenup can use the account to connect to 1010data. You do this by killing the existing session with the -k option, or by possessing the existing seesion with the -K option. To terminate (or 'kill') the existing session, apply the -k option as follows:
If you prefer to possess the existing session, us the -K command, as follows:
The command above tells Tenup to use the existing session instead of terminating it and starting a new one.

Connecting from a Corporate Proxy

If you connect to the internet from behind a corporate proxy server, you can tell Tenup to connect through the proxy. Tenup provides this functionality with the -P option, followed by a space and the proxy information, fomatted as follows:
This command routes the Tenup connection through the specified proxy server, then connects to 1010data and runs your query as normal. If you do not know the correct proxy server information to provide, ask your network administrator.
Note: Not all proxy servers require a username and password. Check with your network administrator to find out exactly what information you need to connect via your company's proxy server.

SAM Pools

If you access 1010data as part of a SAM pool, you need to use different login credentials than if you had your own, unique 1010data ID. SAM stands for: Shared Access Management. SAM pools are generally used to share a single set of login credentials with a larger pool of actual users. Specifying your SAM pool is done with the --pool option in Tenup. It takes the Pool Name as it's only parameter. However, you will still need to pass Tenup a username and password. Only in this instance, both -u and -p take the pool owner's username as the login credentials, as follows:
This tells Tenup to login to 1010data with the first free account in the SAM pool. If no accounts are presently available, Tenup will return an error stating that the system is busy.