Authentication to Remote Machines Using Linux Client

---

To connect to a remote machine using the Linux client, you need to have authentication to the remote machines. This is accomplished by entering a specific username and password for the server using a new utility called pvnetpass. This utility enters the username and password for that particular server in the Pervasive registry. When a request is received to connect to that server, the Linux requester looks up the username and password you entered with pvnetpass and connects to the server.

---

Note
If you do not add these mappings, your applications can receive status code 3119

---

The mapping of usernames and passwords to servers can exist in either the local machine branch (PS_HKEY_CONFIG) or the current user branch (PS_HKEY_USER) in the registry, depending on whether you use the -g parameter of the utility.

---

Note
The passwords in the registry are encrypted.

---

Using the pvnetpass Utility to Store Client Credentials

The pvnetpass utility allows you to specify the username and password that should be used when connecting to a specific server using the Linux client. For each server to which you plan to connect, add an entry using pvnetpass that specifies the user and password.

You also use pvnetpass

Syntax for pvnetpass

pvnetpass [-g] {-a | -r | -m} server [-u user] [-p pwd] 
pvnetpass -d 

Options

-a	Add an entry for a specified server.
-d	Display a list of all configured servers.
-g	Manipulates default settings for all users. Settings created with -g can be overridden by individual users. Using the -g option creates the server entries in the PS_HKEY_CONFIG tree of the registry as opposed to PS_HKEY_USER when not using the -g option.
-m	Modify an entry for a specified server.
-r	Remove an entry for a specified server.
-p	Specifies the password. If this option is not specified, you will be prompted to enter the password.
-u	Specifies the username to use when connecting to the server. If omitted, currently logged-in user is assumed.

Description

Add, remove, or modify a server entry for the current user.

• If -u is not specified, your current user name will be used.
• If -p is not specified, pvnetpass will prompt for a password.

Use the -d option to display the list of configured servers.

Examples for pvnetpass

To add user 'bholly' with password 'peggysue' to the server named 'myserver':

pvnetpass -a myserver -u bholly -p peggysue 

To verify your entry was accepted, use the -d option.

pvnetpass -d 

This command results in:

Server: myserver 
User: bholly 
Password: (not displayed) 

To change the password with which you will connect to 'myserver' from your Linux client:

pvnetpass -m myserver -u bholly -p newpassword 

To remove the entry for server 'myserver':

pvnetpass -r myserver 

To add the default entry for users trying to connect to server 'myserver' when no user-specific entry exists:

pvnetpass -g -a myserver -u admin -p adminpassword 

To add the default server entry in the user context (PS_HKEY_USER):

pvnetpass -a '*' -u admin -p adminpassword 

To add the default server entry in the machine context (PS_HKEY_CONFIG):

pvnetpass -g -a '*' -u admin -p adminpassword