Launching the Installation

For example, if you are installing the 3DSpace Service, V6_Product_Dir is:

C:\Soft\ENOVIALiveCollaborationServer.Windows64\1

on Windows and:

/Soft/ENOVIALiveCollaborationServer.Linux64/1

on Linux.

On Windows, run the command:

setup.exe

• if you belong to the Administrators group, the installation will begin
• If you do not, you will be prompted via a UAC (User Account Control) dialog box to type an administrator password to be able to continue, and you must authorize the program to make changes on your machine.

On Linux, run the command:

./StartGUI.sh

Depending on whether the DS Installer is embedded or not in your app, the procedure differs. If the DS Installer is embedded, the installation proceeds as normal. If not, you will be prompted to specify the DS_Installer_Dir directory.

Note that the OK button is disabled because the DS_Installer_Dir folder containing the following path and file, for example on Windows:

inst\win_b64\code\bin\DSYInsAppliGUI.exe

has not yet been selected.

On Linux, an error message specifies that the DS Installer was not found and instructs you to read the Readme.txt file which contains the appropriate instructions.

Remember that Installer_Dir refers to the full path of the DS Installer.

Once you select the correct Installer_Dir folder, the OK button is enabled.

You can avoid having to select the folder via the dialog box by launching the installation with the -installerPath parameter which specifies the Installer_Dir folder as follows:

setup.exe -installerPath C:\Soft\Installer.Windows64
./StartGUI.sh -installerPath /Soft/Installer.SLES64

A progress bar appears

Reinstalling the media in the event of installation errors

Errors may occur when installing any media using the DS Installer infrastructure. In the event of installation failure, you now have the opportunity to start the failed installation again, without having to uninstall and reinstall everything. This applies both to GA and HF installations.

If the installer detects an incomplete installation, a dialog box will inform you that you can restart the installation:

An incomplete installation has been found in this directory.
You can restart the installation, or exit the installer and uninstall.

However, if the installation fails after database objects have been created, for example when installing 3DEXPERIENCE platform services, the database objects will not be restored.

The command must be launched from an elevated Command Prompt window.

For example, if you are installing the Live Collaboration Server, V6_Product_Dir is:

C:\Soft\ENOVIALiveCollaborationServer.Windows64\1

on Windows and:

/Soft/ENOVIALiveCollaborationServer.Linux64/1

on Linux.

Depending on whether the DS Installer is embedded or not in your app, the procedure differs. If the DS Installer is embedded, the installation proceeds as normal. If not, you will be prompted to specify the Installer_Dir directory.

In that case, launch the installation with the -installerPath parameter which specifies the Installer_Dir directory as follows:

StartTUI.exe -installerPath C:\Soft\DS_Installer.Windows64
./StartTUI.sh -installerPath /Soft/DS_Installer.SLES64

StartTUI.exe -UI

Select the correct DS_Installer_Dir folder in exactly the same way as in GUI mode, then click OK to continue.

Text output like the following text is displayed, for example:

C:\Soft\BusinessProcessServices.Windows64\1>StartTUI.exe -UI
64-bit OS
No installer in the current media

C:\Soft\ENOVIABusinessProcessServices.Windows64\1\inst\common\win_b64.installos found, os win_b64

C:\Soft\DS_Installer-V6R2022x.Windows64\DS_Installer.Windows64Installer Media:
"C:\Soft\DS_Installer-V6R2022x.Windows64\DS_Installer.Windows64\1\inst\win_b64\code\bin\DSYInsAppliTUI.exe"
....
Logs are located in "C:\Users\ADMINI~1\AppData\Local\Temp\InstallData-2011_06_21-182634\log\2011_06_21-182634\"
Logs are located in "C:\Users\ADMINI~1\AppData\Local\Temp\InstallData-2011_06_21-182634\log\CODE\win_b64\ENOVIA_BPS.media-2011_06_21-182634\"

*****R2022x Business Process Services ENOVIA Server installation path*****
Specify where ENOVIA Server Install directory files exists.
Input q and hit Enter to quit. Just press Enter to continue.
Default [C:\enoviaV6R2022x\server]:

E:\19.3.0.0.0\Server\network\admin

The questions differ from one app to another.

If you want to continue with the default value, press Enter. If you want to modify the value, type the value then press Enter.

If you want to go back to the previous question, clear the default entry, or quit the installation, special commands are available. Entries beginning with the "!" character are considered as special commands:

• type !b to get the previous page.
• type !c to clear the default value.
• type !q and hit Enter to quit.

If you want to have an entry beginning with a "!" which is not a command, you must precede it by an additional "!". For example, if the question is to enter a password, and if your password is !toto, you must write !!toto. And if you want to enter !!toto, you must write !!!toto (and so on).

If you write a unauthorized command (for example !z ), the following error message will be displayed:

!z is not a permitted command. To input it, you need to enter !!z.
See the installer documentation for more information.

All or part of the following instructions are automatically indicated in each question, according to the different possibilities for each question:

Input !b to get the previous page. Input !c to
clear the default value. Input !q and hit Enter to quit. Just press
Enter to continue.

This is how to fill in check boxes and radio buttons.

Some, all or none of the check boxes can be selected. For radio buttons, only one choice is possible.

Check boxes are identified by[ ]:

1 [ ] : unselected check box
2 [X] : selected check box

Radio buttons are identified by ( ):

1 ( ) : unselected radio button
2 (X) : selected radio button

T o check or uncheck a check box, enter its corresponding number and press Enter.

To change the selected radio button, enter the number associated to the new desired choice and press Enter (this will automatically unselect the previous choice).

According to the installer's configuration, the Select All and Select None choices may be available.

Then, you can either use numbers 1 to n as usual, or you can enter 0 and press Enter in order to unselect all the check boxes, or enter -1 and press Enter in order to select all.

Similarly, there are messages for which you can have several choices, for example when an error occurs:

*****V6R2022x Live Collaboration Server Oracle Server Connection Parameters*****
TNS_ADMIN directory
Input !b to get the previous page. Input !q and hit Enter to quit. Just press Enter to continue.

Default [C:\oracle\product\<Oracle12cR2>\NETWORK\ADMIN]:
--------------------------------------
Warning
Incorrect value for "TNS_ADMIN directory".
C:\oracle\product\<Oracle12cR2>\NETWORK\ADMIN directory not found.
Actions:
[1] OK
[T] Show technical details
--------------------------------------
Please choose an action:

In this case, enter 1 and press Enter to answer the question again, or enter T and press Enter to see the technical details. Show technical details is not really a choice, but an option allowing you to see the technical details about the error, but then you still have to select a choice.

Reinstalling the media in the event of installation errors

Errors may occur when installing any media using the DS Installer infrastructure. In the event of installation failure, you now have the opportunity to start the failed installation again, without having to uninstall and reinstall everything. This applies both to GA and HF installations.

If the installer detects an incomplete installation, a dialog box will inform you that you can restart the installation:

An incomplete installation has been found in this directory.
You can restart the installation, or exit the installer and uninstall.

However, if the installation fails after database objects have been created, for example when installing 3DEXPERIENCE platform services, the database objects will not be restored.

The response file is generated automatically by either a previous GUI mode or TUI mode installation. It contains the responses to questions you were asked during the previous installation. The file name and path is:

InstallPath/InstallData/UserIntentions_CODE.xml

For example, after installing the Live Collaboration Server on Windows, the path would be:

C:\enoviaV6R2022x\server\InstallData\UserIntentions_CODE.xml

After retrieving the response file, you can put it in any location you like.

A response file is specific to:

• a particular operating system: response files are different between Windows and Linux
• a particular application media
• a particular level:
  • a response file captured on level R2021x GA cannot be applied to a R2022x GA or a R2021x HF
  • a response file captured on a R2021x HF1 cannot be applied to a R2022x HF1 or R2021x HF2

The list of variables you can edit is as follows:

• path values
• text values
• port number values
• passwords.

  As the installation does not store passwords in the UserIntentions_CODE.xml file, the response file must be modified to provide passwords. Password keywords are declared in SetVariableProtected XML elements.

  For example:

  <SetVariableProtected name="BBD_PASSWD" value="Put your password here."/>

  Replace the text Put your password here by the password, and replace SetVariableProtected by SetVariable.

  For example:

  <SetVariable name="BBD_PASSWD" value="p@ssw0rd"/>

Boolean variables must never be changed from TRUE to FALSE or vice versa, because this changes the sequence and the list of the installation questions, and the answers may not be found in the response file.

The response file must be:

• XML "well-formed"
• UTF8 encoded.

You launch the silent installation in the same manner as in console mode using the StartTUI program, except that you must specify the --silent option followed by the full path name of the response file.

If the DS Installer core files are embedded in the app, run the following command on Windows:

StartTUI.exe --silent C:\UserIntentions_CODE.xml

and on Linux:

./StartTUI.sh --silent /UserIntentions_CODE.xml

Optionally, you can specify the --xmlreport option to generate an XML file which generates an installation error report in XML format:

./StartTUI.sh --silent /UserIntentions_CODE.xml --xmlreport reportfilepath

for example:

./StartTUI.sh --silent /UserIntentions_CODE.xml --xmlreport C:\tmp\Report.xml

An XML file is created and can be parsed. The file contains a list of <Message> elements contained inside a <Logs> element. Here is a list of the attributes:

• id: a unique identifier for each error. If the id ends with ".0", it means that the message is not an error
• message: the error message, localized in the user language
• techMessage: the technical message
• msgCatalog: the name of the CATNls file (if any)
• msgKey: the name of the key inside the file (if any)
• type: the error type (info / warn / error / fatal).

If the DS Installer core files are NOT embedded in the app, run the following command on Windows:

StartTUI.exe -installerPath DS_Installer_Dir --silent C:\UserIntentions_CODE.xml

and on Linux:

./StartTUI.sh -installerPath DS_Installer_Dir --silent /UserIntentions_CODE.xml