Installation process first-time Installation

In the following process $WT_HOME/../deploy/innoface-wc-project-999999-R11.0-M030-1.0 is referred to as the installation directory.
The basic software has to be installed by a system user with administrative and unrestricted write/read rights to all subfolders in the Windchill directory.

All commands have to be executed in a windchill shell!
All commands / actions have to be executed in the installation directory.
If the commands / actions have been executed successfully, a "BUILD SUCCESSFUL" usually appears at the end.
If the parameter "Java Args" is requested, please specify the value -Xms256

Stop Windchill

Linux

Stop Windchill

Windchill Shell

windchill stop

Stop Apache

Windchill Shell

$WT_HOME/../HTTPServer/bin/apachectl stop

Windows

Stop all Windchill relevant services
Stop the Http/Apache server

Additional information can be found here.

Clear Tomcat cache

Linux

To clear the cache, the directory $WT_HOME/tomcat/instances has to be emptied (not deleted).

Windows

To clear the cache, the directory %WT_HOME\tomcat\instances has to be emptied (not deleted).

Additional information can be found here.

Installation of the basic software

Linux

Navigate into the unzipped installation directory (example: innoface-wc-project-999999-R11.0-M030-1.0) and execute the following command:

Windchill Shell

ant -Dconf=<config> deploy

Windows

Navigate into the unzipped installation directory (example: innoface-wc-project-999999-R11.0-M030-1.0) and execute the following command:

Windchill Shell

ant -Dconf=<config> deploy

Additional information can be found here.

Configuration of the Apache

Linux

Windchill Shell

ant setup_apache_context

The Apache home directory is by default $WT_HOME/../HTTPServer/

If the Apache directory differs from the Windchill default, it has to be specified as well!

Windchill Shell

ant setup_apache_context -Dapachedir=<Apache-home directory>

Info

After the setup, the Apache web service must be restarted.

Windows

Windchill Shell

ant setup_apache_context

The Apache home directory is by default %WT_HOME\..\HTTPServer\

If the Apache directory differs from the Windchill default, it has to be specified as well!

Windchill Shell

ant setup_apache_context -Dapachedir=<Apache-home directory>

Info

After the setup, the Apache web service must be restarted.

Additional information can be found here.

Installation of the Data server

Linux

Carry out the installation depending on the used database (MSSQL or Oracle).

Determine the database used

Windchill Shell

xconfmanager -d wt.db.dataStore

MSSQL

Info

Installation via ant command if sqlcmd client is available.

Windchill Shell

ant dataserver_install_mssql

Windows

Carry out the installation depending on the used database (MSSQL or Oracle).

Determine the database used

Windchill Shell

xconfmanager -d wt.db.dataStore

MSSQL

Info

Installation via ant command if sqlcmd client is available.

Windchill Shell

ant dataserver_install_mssql

Additional information can be found here

Register JavaScript

Linux

Windchill Shell

ant std_register_scripts

Windows

Windchill Shell

ant std_register_scripts

Additional information can be found here

Start Windchill

Linux

Start Apache

1.1 Without SSL

Windchill Shell

$WT_HOME/../HTTPServer/bin/apachectl start

1.2 With SSL

Windchill Shell

$WT_HOME/../HTTPServer/bin/apachectl -DSSL

Start Windchill

Windchill Shell

windchill start

Windows

Start the Http/Apache server
Start all Windchill-relevant services

Register preferences

Linux

In this step, the Windchill Site Administrator credentials are required.

Windchill Shell

ant_register_preferences

Afterward, Windchill must be restarted!

Windows

In this step, the Windchill Site Administrator credentials are required.

Windchill Shell

ant_register_preferences

Afterward, Windchill must be restarted!

Additional information can be found here.

Installation of the queues

Linux

Windchill has to run!
In this step, the Windchill Site Administrator credentials are required.

Windchill Shell

ant create_queues

Windows

Windchill has to run!
In this step, the Windchill Site Administrator credentials are required.

Windchill Shell

ant create_queues

Additional information can be found here.

Additional steps (if a ReleaseEngine is used)

Import task delegates

Linux

Windchill has to run!
In this step, the Windchill Site Administrator credentials are required (Possibly, with Windchill 12, the Windchill installation user has to be used for the import)

Log in to Windchill
Navigate to Site → Utilities → Task Delegate Management
Log in with the LDAP credentials

Import of the delegates

Navigate to: Import Delegates

The following process has to be repeated for each ie * .ldif file!
To have access to the files, this step should be performed on the Windchill installation server

Click Choose File and select the ie*.ldif file in $WT_HOME/tasks/de/innoface/soap
The box Overwrite leaf entries if they exist must be selected!
When the file is selected and the check mark is set, the file can be imported via Import.

Checking the delegates

Navigate to: Find Delegates
Select the Type Identifier "de.innoface.soap" and start the search
The expected delegates are, for example:
- findObjects
- getRepresentation

Windows

Windchill has to run!
In this step, the Windchill Site Administrator credentials are required (Possibly, with Windchill 12, the Windchill installation user has to be used for the import)

Log in to Windchill
Navigate to Site → Utilities → Task Delegate Management
Log in with the LDAP credentials

Import of the delegates

Navigate to: Import Delegates

The following process has to be repeated for each ie * .ldif file!
To have access to the files, this step should be performed on the Windchill installation server

Click Choose File and select the ie*.ldif file in %WT_HOME\tasks\de\innoface\soap
The box Overwrite leaf entries if they exist must be selected!
When the file is selected and the check mark is set, the file can be imported via Import.

Checking the delegates

Navigate to: Find Delegates
Select the Type Identifier "de.innoface.soap" and start the search
The expected delegates are, for example:
- findObjects
- getRepresentation

Additional information can be found here

Import IFConneX workflows

Linux

If the IFConneX workflow is used, it must be imported.

Site admin login credentials are required.

Stop Windchill

Run code

Windchill Shell

cd $WT_HOME
ant -f bin/tools.xml bundle_custom -Dbundle.forceCompile=true -Dbundle.input=wt.util.resource.resourceCustomize
ant -f codebase/MakeJar.xml
ant -f codebase/MakeJar.xml custUpdate

Start Windchill

Import Workflow template

Windchill Shell

 windchill wt.load.LoadFromFile -d loadFiles/innoface/IFConneX_Standard.xml

Windows

If the IFConneX workflow is used, it must be imported.

Site admin login credentials are required.

1. Stop Windchill

Run code

Windchill Shell

cd %WT_HOME%
ant -f bin\tools.xml bundle_custom -Dbundle.forceCompile=true -Dbundle.input=wt.util.resource.resourceCustomize
ant -f codebase\MakeJar.xml
ant -f codebase\MakeJar.xml custUpdate

Start Windchill

Import Workflow template

Windchill Shell

windchill wt.load.LoadFromFile -d loadFiles\innoface\IFConneX_Standard.xml

Note

After the successful installation, interface-specific master attributes usually have to be added.