Authentication to Remote Machines

---

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

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.

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