Unloading Your Product Code on AIX

	This task explains how to unload the CATIA Version 5 code from scratch on a single workstation running UNIX. The concepts, procedures and look and feel of the installation procedure for Windows have been carried over to the AIX environment in order to provide a common Version 5 installation interface for all supported operating systems. This installation procedure steps you through a CATIA installation, for illustration purposes. The installation steps are the same for installing ENOVIA DMU Navigator and DELMIA configurations.
	Before starting the installation, check you have all the hardware and software prerequisites.

	How To Display the DSLS Computer ID of Your Computer You must run DSLicTarget tool first. This tool is located either in the root of your media or in the `code/bin` directory of your installation path. For example, you can run the command: `DSLicTarget -t` To know more about the syntax, please see the DSLicTarget Command Syntax of the Dassault Systemes License Server User's Guide. The Computer ID of your computer is also displayed: at the top of the `License Manager` dialog box, access via the `Tools > Options...` command when running the application by the `Nodelock key Management` tool, from the `Start > Programs > CATIA > Tools` menu.


	Phase 1: Mount the Media Note: Before proceeding, you must first create a filesystem into which the ENOVIAV5VPM product files will be unloaded (the filesystem must be dedicated to ENOVIA V5). Mount the physical media or download it. Launch `./start` shell command. If you have downloaded the media, the start file will be located in the folder 1. Check that the DISPLAY variable is exported appropriately before continuing, then enter the command: `./start` to start the installation procedure. The start command checks you have the correct prerequisites. Then, the Version 5 setup program is run and the `Welcome` dialog box greets you. The setup program invokes a full self-explanatory graphical interface which walks you through the installation. The `Welcome` dialog box is then displayed on a background window. Note that the screenshots illustrating the installation procedure were taken without the background window. Click `Next.` The `Choose Destination Location` dialog box appears. A default destination folder is already proposed. `AIXInstallPath` If the default destination directory is suitable, click `Next`. Click `Yes` if prompted to create the directory if it does not exist. Or, click `Browse...` and navigate to select another folder and click OK. The folder you choose must be empty. You can also specify a new folder: the folder will be created after confirmation. Click `Next`. The `Choose Environment Location` dialog box appears. A default destination folder is already proposed: `/CATEnv` If the default directory is suitable, click `Next` or click `Browse...` and navigate to select another folder and click OK. You can also specify a new folder: the directory will be created after confirmation. For more about environment files, refer to About the Environment Created on Your Workstation on UNIX. Click `Next`. The `Setup Type` dialog box appears. This dialog box lets you specify whether you want to install all of the software on the media, or select the configurations and/or products to be installed: `Complete`: specifies you want to install all the software, and moves on to the next installation step (installation of online documentation files) when you click Next `Custom`: lets you choose the configurations and/or products to be installed. If you want to choose which configurations and/or products to install, check the `Custom` option and click `Next`. The `Install Language-Specific File and Fonts` dialog box appears. Check the buttons to install the user interface files for the appropriate language(s) and/or to install language-indexed fonts. Uncheck the buttons for the language files you do not want to install. Uncheck the buttons for the language files you do not want to install. This will let you skip the installation of unnecessary language files and fonts and enable you to save disk space. The following language-indexed fonts are all installed by default: Simplified Chinese Traditional Chinese Japanese Korean SSS4 (miscellaneous). If you intend to access data containing language-indexed fonts for a specific language environment, for example, drawing documents, if you have not installed the fonts beforehand, you will obtain a message when opening the document, saying that a font is missing and that it will be replaced by another font. To avoid this problem, we recommend that you check the option to install the language-indexed fonts. Note: The choice you make at installation is definitive: you cannot add or remove languages or fonts later when installing additional configurations and/or products. Click `Next`. The `Select Software` dialog box appears. By default, the list of all the configurations on the media is displayed. Choose whether you want to install configurations and/or products by using the list box provided. Depending on what you chose, the list will display the names of all the configurations or products on the media. Click on the configurations and/or products to select them. The selected configurations and/or products are listed in the `Selected Software` list. In our example, we chose to install the DP2 - CATIA - Drawing Production 2 and MD2 - CATIA - Mechanical Design 2 configurations: The dialog box specifies the space available for the installation. Clicking on each configuration or product also specifies the amount of space required for installing those configurations or products; the space required is updated progressively as you select from the list. At this stage, and depending on the space required for the configurations you are installing, you may be informed that there is not enough space in the destination directory. If so, go back and choose another destination directory where there is enough space. There is nothing to prevent you from installing all the configurations and products on the media. However, you will be able to use only the software for which you have enrolled licenses, except if you are using a demo mode license as explained in Running in Demo Mode. Click `Next`. Depending on the configurations and/or products you chose, the `Install Extra` Products dialog box may appear: An extra product is a standard product associated with certain configurations and products. You can choose to install or not to install an extra product. For more information, refer to Extra Products. Click `Next`. If your configuration requires you to configure Orbix, the `Choose Orbix Configuration` dialog box appears. Orbix is used for server-client communications. You can accept the default values. Note: The default values are set to 1570/1590/200. If CATIA or DMU have been installed previously, these values are already taken. If this is the case, use different values than the CATIA and DMU port numbers. For `Port Number for Orbix daemon`, the default is 1570. A check is performed to determine if the port if free. If it is not free, the port number proposed is incremented by "1" until a free port is found. For `Starting port number for daemon-run servers,` the default is 1590. No check is performed to determine if the port if free. If it is not free, the port number proposed is incremented by "20". Check the option `Boot Orbix daemon at restart` if you want the Orbix daemon to be restarted the next time you reboot your workstation. Click `Next`. The `Server Timeout Configuration` dialog box appears. If your configuration uses servers run by the server manager: This value corresponds to the duration in ms after which the server exits if it has not been contacted by the associated client. You enter a value in minutes, then the value is internally transformed into ms and stored in the `CATIAServerManager.imp` file. When launching a server under its responsibility, the server manager passes the timeout value to it. The default value is 60 mn. The value can be increased up to 35.700 mn (1 month). The value can be decreased down to 2 mn. The increment is 1 mn. This behavior is valid for all servers run by the server manager: ENOVIAV5VPM, 3dcom, and the settings server for example. Only servers managed by the server manager take into account the timeout parameter. For example, the workbook server is not impacted by the timeout value. You can customize this value by editing the SERVER_TIMEOUT parameter in the appropriate file after the installation and setting it to a value different from the default one (1 hour). Modifying Server Timeouts This task explains how to modify the timeout of the ENOVIAV5VPM, 3d com and Settings servers. Note that the Settings server is common to both ENOVIAV5VPM and 3d com. To control the timeout of all servers globally, add the following line: `export SERVER_TIMEOUT=<value in milliseconds>` to the beginning of the file: `$install_path/code/command/runServerManager` Note: The default value is 3600000 milliseconds. The maximum value is 2142000000 milliseconds. All processes started by the server manager then inherit the same environment. Click the `Next` button to move to the next step. The `Vault Client Configuration` dialog box is displayed. When installing a Version 5 product which contains a potential vault client, this dialog box prompts you to indicate if you want to configure a vault client once the code has been installed. If you choose to configure a vault client, you will be prompted to do so in another dialog box which will be displayed before the `PLMDBSetup` process is started. After installation, you can run the `VaultClientSetup` command in order to catalog another vault server, modify the parameters of an existing one, or remove an existing one. The `VaultClientSetupB` command provides the same functionalities in batch mode. Note: You can only install a vault server by using a configuration belonging to the ENOVIAV5VPM brand. For more detailed information about the vault, refer to Setting Up Vault Servers and Clients. Click `Next`. If you are installing from scratch, the `Choose Communications Ports` dialog box appears. This allows you to set up on your computer: a port reserved for the communications backbone process a port reserved for starting the communications backbone process automatically a port reserved for processing events when using peripheral devices (spaceball, spacemouse, joystick). By default, the `Set up communication ports` option is checked because it is strongly recommended. This installation step adds lines to various system files. For more information about the communications backbone and which files are concerned, refer to Communications Backbone Files. The installation setup analyses the file in question. If the three lines are present (for example, due to a previous installation), the dialog box will not appear. Furthermore, if the installation path is different, the installation path referenced in the `/etc/inetd.conf` file is updated. This means that the most recent installation takes priority. Click `Next`. This displays the `Start Copying Files` dialog box. The central area lists the current settings you set in the previous steps. The result looks something like this (depending on which software you chose to install): Click `Install` to start copying the files to your computer. A progression indicator appears. Depending on your AIX platform, the software may be provided on a suite of medias. Once the software on the first media has been installed, you will be prompted to insert the next media, and click OK to continue the installation until you have inserted the last media. Note: You must install all the software medias: you cannot, for example, install only one out of two. If you click the Cancel button before installing the final media, the software previously installed will be uninstalled. Vault Client Setup If you indicated earlier that you want to set up a vault client, the `Vault Client Setup` dialog box appears. Click `Add...` to display the following dialog box. Specify the Vault alias name, Server hostname and Orbix daemon port, then click OK. The `Vault Client Setup` dialog box is updated. Use the `Modify...` and `Delete` to modify or delete the selected configuration. For more detailed information about the vault, refer to Setting Up Vault Servers and Clients. Click `Close`. Once the product files have been copied, the `Setup Complete` dialog box informs you that the installation has been completed. Click `Finish` to start a Version 5 session. An installation log is created (or the existing log is updated) in the current temporary directory, located by default in: `$HOME/CXINST.log` If you did not import a NODELOCK license certificate If you chose to run Version 5 now, but did not import a nodelock license certificate, a message window appears informing you that you have not yet requested a configuration or product license: Click `OK`. The `License Manager` dialog box appears in front of the application window, and contains a list of the names of installed software. The configuration/product names are grayed out. In our example, we installed the DP2 - CATIA - Drawing Production 2 and MD2 - CATIA - Mechanical Design 2 configurations. Note: The field below each license specifies: "Not Granted". This is because this is the first time you are starting Version 5, and you have not yet reserved any licenses. At this stage, if you click the `OK` button, a session will still be started, but you will not be able to work with the product: menu commands will be grayed out, and you will only be able to use the `File > Exit` command.
	Resetting the Server Manager After Installing Different Product Lines in the Same Location When you install configurations including orbix software, you also install software components which run the orbix daemon. During this process, the Server Manager is registered to the orbix daemon, and the following file is created: `AIXInstallPath/OS/startup/orbix/config/Repositories/ImpRep/CATIAServerManager.imp` where "OS" is aix_a64. This file contains: `server_path -env environment_name -direnv environment_directory` If, for example, you first install another product line (CATIA, DELMIA, ENOVIA DMU Navigator or 3d com) and the configurations you install include orbix, and you then install ENOVIAV5VPM in the same installation directory, the name of the environment referenced in the `CATIAServerManager.imp`file will be (if you installed CATIA, for example): `CATIAEnvironmentName` and not: `ENOVIAV5VPMEnvironmentName` which will lead to problems. You have two solutions to avoid this problem. You could install ENOVIAV5VPM first before installing any other product lines. Or, if you installed other product lines first, perform the following steps as "root": Regenerate the `CATIAServerManager.imp` file by running the following command: `AIXInstallPath/OS/code/command/runRegisterServerManager -env ENOVIAV5VPMEnvironmentName` Stop the orbix daemon. Restart the orbix daemon running the following command: `AIXInstallPath/OS/code/command/catstart -run runOrbix`