Installing 3d com Search on UNIX

1. Check your machine's operating system against the following table to verify that it will indeed support 3d com MetaSearch.

• Launch the 3d com Installation.
• In the Select Software dialog box of the installation (step 12), you should choose the N3G configuration.

// --------- Example ---------
example = [.
Name = "example",
RealName = "Example",
Checked = false,
Internal = false,
Technical = false,
Program = "http://search.example.com/search.gw",
ProgramURL = "http://search.example.com/search.gw?search=",
Home = "http://www.example.com/",
Parameters = fun(Request)
[. search = Request .]
end,
Init = fun(Results)
return Seq(Results, "a # br small");
end,
Extract = fun(Answer)
var Result = [. .];
var Item = Elem(Answer, "a")[0];
Result.Title := Text(Item);
Result.URL := Str_Split(Item.href, ";")[1];
Result.Abstract := Text(Answer);
return Result;
end
.],

 

1. Copy / paste the definition of one of the pre-defined drivers in order to have a model for the creation of your driver definition.
2. Modify the object name example to correspond to the identifier of your driver. 
3. Modify the Name variable to be the object name surrounded by quotes.
4. Modify the RealName variable to be the driver name as you wish it to appear on the screen in your MetaSearch menus.
5. Modify the Checked variable to be:

• true:  if you wish the entry in the MetaSearch menu to be pre-checked
• false:  if you wish the entry in the MetaSearch menu not to be pre-checked

6. Modify the Internal variable to be:

• true:  if you wish the entry in the MetaSearch menu to appear in the list of Internal drivers 
• false:  if you wish the entry in the MetaSearch menu not to appear in the list of Internal drivers (it will appear in the list of General drivers by default)

 

7. Modify the Technical variable to be:

• true:  if you wish the entry in the MetaSearch menu to appear in the list of Technical drivers 
• false:  if you wish the entry in the MetaSearch menu not to appear in the list of Technical drivers (it will appear in the list of General drivers by default)

8. Modify the Program variable to be the URL of the called program cgi.
9. Modify the ProgramURL variable to be a concatenation of the above Program variable + the minimum argument required, e.g.: 

• connect to the browser from your desktop
• make a search
• copy / paste the search string from the browser's URL field into your ProgramURL variable

10. Modify the Home variable to be the URL home of your driver.

For the following three variables, you can consult the topic Markup Algebra  in the Compaq webl documentation which you'll find at the following location of your installation:

$install_path/docs/metasearch/CompaqWEBLanguage.pdf

11. Modify the Parameters variable to contain the search arguments of the ProgramURL in webl syntax.  
12. Modify the Init variable to define the initialization function in webl syntax.
13. Modify the Extract variable to define the extraction in webl syntax. 

For further information, consult the Compaq webl documentation:

$install_path/docs/metasearch/CompaqWEBLanguage.pdf

1. In the MetaSearch settings file
         $install_path/startup/metasearch/metasearch.properties
customize the Proxy Preferences variables:

            # Proxy preferences (use | to separate hosts)
       http.proxySet=true
       http.proxyHost=128.1.2.3
       http.proxyPort=80
       http.nonProxyHosts=lyon|pepita

2. In the $install_path/code/command  directory of your installation, run the command: 

runMetaSearchServer  password  "login_name:login_password" 

where  login_name  is the 3d com proxy login name and 
            login_password is the 3d com proxy password.

1. Customize the MetaSearch settings file $install_path/startup/metasearch/metasearch.properties to define the mail server.

• define the mail server machine name in the variable  metasearch.mailServer 
• define the Simple Mail Transport Protocol (SMTP) in the variable  metasearch.mailPort 

# Name of your mail server
metasearch.mailServer=soleil
# Port of your mail server
metasearch.mailPort=25

 

1. Customize the variable  metasearch.language  in the MetaSearch settings file $install_path/startup/metasearch/metasearch.properties  to conform to the language used in your company, i.e.

for English: metasearch.language=en
for French: metasearch.language=fr
for German: metasearch.language=de
for Japanese: metasearch.language=ja
for Chinese: metasearch.language=zh

1. Customize the optional settings in the MetaSearch settings file
         $install_path/startup/metasearch/metasearch.properties
   to conform to your company's needs.
   
   The following is a list of some of the settings you can customize:

• MetaSearch language variable : metasearch.language
• trace variables : metasearch.traces,  metasearch.stdOut
• timeout variables : metasearch.timeout, metasearch.longTimeout, metasearch.shortTimeout, metasearch.time
• proxy server variables : http.proxySet, http.proxyHost, http.proxyPort, http.nonProxyHosts

# ---------------------------
# METASEARCH USER PREFERENCES
# ---------------------------
# Encoding (us-ascii, ISO-8859-1, etc.), default: current encoding
metasearch.encoding=ISO-8859-1
# en (English), de (Deutsche), fr (French) or jp (Japanese), default: en
metasearch.language=en
# Print traces or no (true or false), default: true
metasearch.traces=true
# Print on screen or no (true or false), default: true
metasearch.stdOut=true
# Port that will be used by the MetaSearch Server, default: 8081
metasearch.serverPort=8081
# Name of your mail server
metasearch.mailServer=soleil
# Port of your mail server
metasearch.mailPort=25
# Timeout for automatic searches (1000 = 1 second), default: 500000
metasearch.timeout=500000
# Timeout for downloads, default: 1000000
metasearch.longTimeout=1000000
# Timeout for direct searches, default: 20000
metasearch.shortTimeout=20000
# Time to launch the automatic search (XX:XX), default: 07:00
metasearch.time=07:00
# E-mail address of the MetaSearch administrator
metasearch.administrator=
# Proxy preferences (use | to separate hosts)
http.proxySet=true
http.proxyHost=128.1.2.3
http.proxyPort=80
http.nonProxyHosts=lyon|pepita

1. Modify the file $install_path/startup/metasearch/searchserver.properties by setting the following value:

searchserver.doc=path_of_installed_online_documentation

e.g. C:\Program Files\Dassault Systemes\B18doc/English/online

Note: All directory separators in the defined path should be slashes "/" (not backslashes "\").

1. Choose a filesystem which can grow to meet the storage requirements for all persistent search subscriptions and archives. For example, choose /usr/local/metasearch
2. Edit the CATEnv environment  files (located in the CATEnv directory selected during the install of 3d com):

            .../CATEnv/ENOVIA_3d_com.V5R18.B18.txt

Change the CATMetaSearchPath environment variable to /usr/local/metasearch in both files. For example, set: CATMetaSearchPath =/usr/local/metasearch instead of the default line: CATMetaSearchPath =/tmp

1. To start the Search server, you must run the following command:

• $install_path/code/command/runSearchServer

2. To start the MetaSearch server, you must run the following command:

• $install_path/code/command/runMetaSearchServer

Example:

runMetaSearchServer.sh -env ENOVIA_3d_com.V5R18.B18.txt -direnv "/CATEnv"
 

Example:

• $install_path/code/command/runMetaSearchServer servername etole.dassault-systemes.fr
• $install_path/code/command/runSearchServer servername  
  etole.dassault-systemes.fr 

Note: In order to check if the port 8089 is already taken on an AIX server, use the command
                    netstat -a | grep 8089

$install_path/startup/metasearch/metasearch.properties
$install_path/startup/metasearch/searchserver.properties
$install_path/startup/metasearch/driver.webl
$install_path/code/command/runMetaSearchServer 
        (to modify the proxy username and password)

will not be taken into account until the MetaSearch and Search server processes are  re-launched. See Launch the Search server and the MetaSearch server above.