Post Installation for 3d com Server on UNIX

Designate a directory to store Snapshot documents

During the installation, this directory was specified in the step Data Directories Configuration. However, if you wish to change the location of your snapshot directory after the installation, you should do the following steps.
  1. Choose a filesystem which can grow to meet the storage requirements for all persistent snapshots made by 3d com users. For example, choose /usr/local/publish
  2. Edit the CATEnv environment  file (located in the CATEnv directory specified during the installation in the step Choosing Environment Location): 
             .../CATEnv/ENOVIA3dcomEnvironmentName.txt

    Change the CATW3PublishPath environment variable to  /usr/local/publish  in all files. For example, set:
        CATW3PublishPath=/usr/local/publish
    instead of the default line:
        CATW3PublishPath=/tmp

Note that the access privileges to the designated directory, e.g. /usr/local/publish ,  
must be 777.

  1. Set the HTTP 'Views' alias to   /usr/local/publish   as described in the 'Configure the HTTP server' section.

Designate a directory for saving information associated to shared WorkBooks

During the installation, this directory was specified in the step Data Directories Configuration. However, if you wish to change the location of your shared WorkBooks directory after the installation, you should do the following steps.
You must tell the system where you wish to save information associated to shared WorkBooks.
  1. Modify all occurrences of the variable CATSharedWorkbookPath  in the files found in the CATEnv directory (the environment directory that you specified during the installation in the step Choosing Environment Location) to point to the desired directory.

Enable VPM1

  1. If you did not enable VPM1 but wish to do so as an afterthought, 
    you should create the file  $install_path/startup/servers/serversV4/EnvV4Conf  and initialize it as follows:
  • to activate the reference to a VPM1 installation, add the following line:
                    VPM_TO_INSTALL=YES ; export VPM_TO_INSTALL
  • to reference the $HOME of the VPM1 administrator, add the following line:
                    VPM_CUST=/home/vpmadm ; export VPM_CUST


Enable CADAM Viewer on AIX

The CADAM Viewer is a 3d com feature only available on AIX. It allows to view *.ccd models (CADAM format) in a 2D local viewer. To use this feature, the person performing the installation should type (as root) the following command after the installation of 3d com:

chmod -R 777 $install_path/resources/CDD/TMP $install_path/resources/CDD/DRAWINGS

Otherwise, the 3d com Server will be unpredictable when trying to open *.ccd files

Define the location of the Default Cache directory

The file  $install_path/docs/java/defaultCache.properties  
designates the location at which data is temporarily downloaded. Its contents are deleted at the end of your 3d com session. This file must be defined.

You must specify a directory per OS client. The access privileges to the specified directory must include the write privilege.

Example:

CacheLocation.OS_WINDOWS_XP=E:\Models
CacheLocation.OS_WINDOWS_2000=E:\Models
CacheLocation.OS_AIX=/tmp
CacheLocation.OS_SOLARIS=/tmp
CacheLocation.OS_HPUX=/tmp
Note: All files written to the Cache during a Portal session are deleted at the end of the session.

Configure the HTTP Server

3d com requires an HTTP server on the server machine. 

  1. You must first configure the HTTP server.
  • Configure the mime type for dsar files:
    associate the dsar suffix to the mime-type application/octet-stream
  • Configure the mime type for exe files:
    associate the exe suffix to the mime-type application/octet-stream
  • Declare the 3d com alias
    Alias /enovia_portal/  %install_path%/docs/
    The URL to access 3d com will be:

    http://server_name/enovia_portal
  • URL mapping configuration:
    Alias /Views/ Publisher_database_directory/
  • CGI configuration: declare the 3d com cgi-bin directory:
      ScriptAlias /cgi-bin/ %install_path%/docs/cgi-bin/ 

    Note: By default, some http servers provide a default cgi-bin alias. In this case, it is necessary after declaring the 3d com cgi-bin directory to deactivate that which was provided by default.

  • Declare the User Galaxy access:
    Alias /resources/ %install_path%/resources/
  1. The following operation depends on the type of HTTP server you use:

on an Apache 2.2.3 server or an IBM http server

add the suffix dsar to the mime.types line: application/octet-stream bin
add the suffix exe to the mime.types line: application/octet-stream bin
add the following lines to the  httpd.conf  configuration file:

Alias /enovia_portal/ %installation_path%/intel_a/docs/
Alias /Views/ "<installation_path>/Views/
ScriptAlias /cgi-bin/ %installation_path%/intel_a/docs/cgi-bin/

Example, in which 

  • the installation code unload directory was designated as:   /home/data/portal/
  • the installation was made on a machine running:   AIX

...
#
# ScriptAlias: This controls which directories contain server scripts.
# ScriptAliases are essentially the same as Aliases, except that
# documents in the realname directory are treated as
# applications and run by the server when requested 
# rather than as documents sent to the client.
# The same rules about trailing "/" apply to ScriptAlias directives as # to Alias.
#
ScriptAlias /cgi-bin/ "/home/data/portal/aix_a/docs/cgi-bin/"
#
...
...
Alias /enovia_portal/ "/home/data/portal/aix_a/docs/"
<Directory "/home/data/portal/aix_a/docs">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

Alias /Views/ "/home/data/portal/publish/"
<Directory "/home/data/portal/publish">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>
...

on a Domino server

add the suffix dsar to the mime.types line: application/octet-stream bin
add the suffix exe to the mime.types line: application/octet-stream bin

add the following lines to the  httpd.conf  configuration file:
(The httpd.conf file is usually located under /etc/httpd. If the Domino Server is 
configured to run under the non default language, the httpd.conf file is located under /etc/httpd/config/language. For instance for the japanese language the file is /etc/httpd/config/Ja_jp/httpd.conf)
 
Pass /enovia_portal/* %install_path%/docs/*
Pass /Views/* Publisher_database_directory/*
Pass /resources/* %install_path%/resources/*
Exec /cgi-bin/* %install_path%/docs/cgi-bin/*

on a Netscape server

go to the Netscape Server Manager page

  • Select MIME types in Server Preferences. Then create a new type 
    with content-type application/octet-stream bin and suffix dsar
  • Select MIME types in Server Preferences. Then create a new type 
    with content-type application/octet-stream bin and suffix exe
  • URL mapping configuration: select in the item 
    URL configuration / URL mappings      the sub-item:
      Map a URL to a local directory

Enter the following values into the 2 fields:

  • URL prefix: enovia_portal
  • Directory to map to: enovia_portal

Repeat the operation with the following values:

  • URL prefix: Views
  • Directory to map to: Publisher_database_director
  • CGI configuration: select in the item CGI and Server Parsed HTML 
    the sub-item Specify a directory that will contain CGI programs only

Enter the following values into the 2 fields:

  • URL prefix: cgi-bin
  • CGI directory: enovia_portal
  1. Restart the HTTP server.

 
 

Configure the server machine

  1. You need to configure the server machine desktop session.
  • Allow the X connections from any hosts by typing  xhost +  within the server desktop
  • WARNING: The X session on the server has to be always active and can not be touched: in particular the 3d com windows can not be moved or resized
  • WARNING: The server screen saver and the server screen lock need to be configured as OFF

Optional: Copy the Administration WorkBook to a New WorkBook and remove elements from the Administration WorkBook 
Some companies might consider it undesirable that users modify the viewer settings defined by the Administrator. In that case, the following procedure should be followed:
  1. Create a new WorkBook (see Using WorkBooks in the Getting Started tutorial of the User Guide ), which you should rename appropriately (e.g. MyAdministrationBook).
  2. Click the Administration WorkBook.
  3. Select the Installation, Performance Analyser and Viewers Administration folders.
  4. Right-click and select Copy from the contextual menu.
  5. Click the new WorkBook you created in step 1 above.
  6. Right-click the Links folder and select Paste from the contextual menu.
    The Administration WorkBook contents are now duplicated in the new WorkBook.
  7. Edit the file $install_path/docs/java/InstallProject.xml to correspond to those elements to which your company wishes to remove user access (e.g. to remove access to the Performance Analyzer and to the Viewers Administration, remove the lines in bold below):

<?xml version="1.0" encoding="UTF-8"?>
<SerializedData classname="com.dassault_systemes.catweb.bookmarktree.
  BookmarkTreeCATlet">
<Tab NAME="">
<folder NAME="Installation">
<BOOKMARK NAME="Install application mode" url="bean://com.dassault_systemes.catweb.nomad.controller.
  NomadCATlet?product=application">
</BOOKMARK>
<BOOKMARK NAME="Install nomad"
url="bean://com.dassault_systemes.catweb.nomad.controller.
  NomadCATlet?product=nomad">
</BOOKMARK>
<BOOKMARK NAME="Portal Registration" url="bean://com.dassault_systemes.catweb.base.catlet.
  RegistrationCATlet">
</BOOKMARK>
</folder>
<folder NAME="Performance Analyser">
<BOOKMARK NAME="Performance Meter" url="bean://com.dassault_systemes.catweb.perfmeter.PerfCATlet">
</BOOKMARK>
</folder>
<folder NAME="Viewers Administration">
<BOOKMARK NAME="Administrate Local 3D Viewer" url="bean://com.dassault_systemes.catweb.local3D.controller.
  LocalCATlet3D">
</BOOKMARK>
<BOOKMARK NAME="Administrate Remote 3D Viewer" url="bean://com.dassault_systemes.catweb.remote.controller.
  RemoteCATlet3D">
</BOOKMARK>
<BOOKMARK NAME="Administrate Local 2D Viewer" url="bean://com.dassault_systemes.catweb.local2D.controller.
  LocalCATlet2D">
</BOOKMARK>
<BOOKMARK NAME="Administrate Remote 2D Viewer" url="bean://com.dassault_systemes.catweb.local2D.controller.
  RemoteCATlet2D">
</BOOKMARK>
</folder>
</Tab>
</SerializedData>

Users accessing 3d com will no longer have access to the removed elements of the Administration WorkBook. 

 

It is important to perform these steps before any of your users access 3d com.
Your installation is now complete.