Attn - The correct way to connect to the repository

Question

From iFS Product Management.
Many people appear to be having trouble connecting to the repository and are using the wrong API calls to do. The recommended API calls changed between beta and production. For the production release here is the correct way to connect:
1. Four pieces of information are need to connect to the repository
1. The iFS User Name
2. The iFS User's password
3. The properties file to be used
4. The database password of the user who owns the iFS Schema
This is different from the beta where the database password was hardcoded into the properties file.
Note that any TNSNAMES information is still containing in the databaseURL entry in the properties file.
package ifs.demo.samples;
import oracle.ifs.beans.*;
import oracle.ifs.common.*;
import java.util.Locale;
public class ConnectionTester extends Object {
public static LibrarySession testConnection()
throws IfsException
LibraryService service = new LibraryService();
CleartextCredential me = new CleartextCredential("gking","ifs");
ConnectOptions connect = new ConnectOptions();
connect.setLocale(Locale.getDefault());
connect.setServiceName("IfsDefault");
connect.setServicePassword("manager");
return service.connect(me,connect);
public static void main(String[] args)
try {
LibrarySession ifs = testConnection();
ifs.disconnect();
} catch (IfsException e) {
IfsException.setVerboseMessage(true);
e.printStackTrace();
Note that in this example "gking" is the iFS user name, "ifs" is the gking user's ifs password. "manager" is the password of the database user who owns the iFS Schema.
"IfsDefault" is the server properties file that describes the ifs connection. This file is in called "IfsDefault.properties" and is located in the package oracle.ifs.server.properties". This means that the folder that contains the 'oracle' folder that is the root of this package must be referenced in the class path when running this example.
Note, if you use the older, 3 argument form of the connect you will get an unable to connect exception as the iFS will not have the Schema Password.
null

Answer 1

When I run the example below on Solaris (after setting the CLASSPATH etc., I get a oracle.ifs.common.IfsException: IFS-21008: Login Failure
oracle.ifs.common.IfsException: IFS-10170: Invalid name/credential.
(I am providing all 4 pieces of information for connecting)
When using the web interface the same userid and password work fine (system/manager).
Please help.....
<BLOCKQUOTE><font size="1" face="Verdana, Arial">quote:</font><HR>Originally posted by Mark_d_Drake ():
From iFS Product Management.
Many people appear to be having trouble connecting to the repository and are using the wrong API calls to do. The recommended API calls changed between beta and production. For the production release here is the correct way to connect:
1. Four pieces of information are need to connect to the repository
1. The iFS User Name
2. The iFS User's password
3. The properties file to be used
4. The database password of the user who owns the iFS Schema
This is different from the beta where the database password was hardcoded into the properties file.
Note that any TNSNAMES information is still containing in the databaseURL entry in the properties file.
package ifs.demo.samples;
import oracle.ifs.beans.*;
import oracle.ifs.common.*;
import java.util.Locale;
public class ConnectionTester extends Object {
public static LibrarySession testConnection()
throws IfsException
LibraryService service = new LibraryService();
CleartextCredential me = new CleartextCredential("gking","ifs");
ConnectOptions connect = new ConnectOptions();
connect.setLocale(Locale.getDefault());
connect.setServiceName("IfsDefault");
connect.setServicePassword("manager");
return service.connect(me,connect);
public static void main(String[] args)
try {
LibrarySession ifs = testConnection();
ifs.disconnect();
} catch (IfsException e) {
IfsException.setVerboseMessage(true);
e.printStackTrace();
Note that in this example "gking" is the iFS user name, "ifs" is the gking user's ifs password. "manager" is the password of the database user who owns the iFS Schema.
"IfsDefault" is the server properties file that describes the ifs connection. This file is in called "IfsDefault.properties" and is located in the package oracle.ifs.server.properties". This means that the folder that contains the 'oracle' folder that is the root of this package must be referenced in the class path when running this example.
Note, if you use the older, 3 argument form of the connect you will get an unable to connect exception as the iFS will not have the Schema Password.<HR></BLOCKQUOTE>
null