Adveon Installation Guide - joinville.ifsc.edu.br

Adveon™ Installation Guide Version 1.0

June 10th, 2014

Adveon 1.0.0.1

Edgecam 2014 R2

Adveon™ Installation Guide

2

Sandvik Coromant is not obliged to announce modifications of the document on beforehand. Product names are used without a guarantee of free disposal.

All rights reserved: no parts of this publication may be reproduced or transmitted by any means, electronic, mechanical photocopying or otherwise, without prior permission of Sandvik Coromant.

Text and graphics have been edited very carefully, however, errors cannot be excluded.

© Sandvik Coromant, April 2014. All rights reserved.


3

Contents

1 System requirements ........................................................................................................................................ 4

1.1 Adveon single machine configuration................................................................................................................ 4

1.2 Adveon network configuration .......................................................................................................................... 4

1.2.1 Adveon client ..................................................................................................................................................... 4

1.2.2 Adveon server .................................................................................................................................................... 4

2 Prerequisites...................................................................................................................................................... 5

3 Installation ......................................................................................................................................................... 6

3.1 Overview ............................................................................................................................................................ 6

3.2 Standard Installation Mode ............................................................................................................................... 7

3.3 Client only installation mode ........................................................................................................................... 12

3.4 Advanced installation mode ............................................................................................................................ 15

4 Uninstallation .................................................................................................................................................. 28

5 Upgrade ........................................................................................................................................................... 31

6 Repair............................................................................................................................................................... 33

7 Add components ............................................................................................................................................. 35

8 Troubleshooting .............................................................................................................................................. 38

8.1 Installation ....................................................................................................................................................... 38

8.1.1 Client Configuration – connection issue .......................................................................................................... 38

8.1.2 Database Configuration – connection issue .................................................................................................... 40

8.1.3 Log files ............................................................................................................................................................ 41

8.1.4 Known Limitations ........................................................................................................................................... 41

8.2 Uninstallation ................................................................................................................................................... 42

8.3 Application and Services Logfiles ..................................................................................................................... 42


4

1 System requirements

1.1 Adveon single machine configuration

Minimum:

Core processor, 2GHz

Windows 7 32bit or newer

4GB of RAM (32bit), 6 GB for 64 bit

17" screen (1280x1024)

Disk: 500GB SATA 7200rpm

Internet connection, USB port or DVD drive

Recommended:

Multicore processor at least 2GHz

Windows 7 64bit or newer

2GB of RAM per each processor core, 8GB recommended

17" screen (1280x1024)



1.2 Adveon network configuration

1.2.1 Adveon client

Same as Adveon single machine configuration (see chapter 1.1) in addition to network connectivity to the server.

1.2.2 Adveon server

Minimum:

Network connectivity to clients

Core processor, 2GHz

4GB of RAM (32bit), 8GB for 64 bit



Recommended:

Network connectivity to clients

Multicore processor at least 2GHz

64bit OS (Windows Server 2008R2, Windows 7)

2GB of RAM per each processor core,




5

2 Prerequisites

Local administration rights.

Installation files on a local drive.

If needed, the with Adveon interfacing CAM software, already installed. Currently supported:

o Edgecam 2014R2

Before running the installer, the location of the ‘Edgecam Toolstore’ must already be defined, else

the installation of the ‘Edgecam Gateway’ will fail. The location of the Toolstore is determined the

first time you start Edgecam after Edgecam installation. So unless you’ve freshly installed Edgecam

this won’t be an issue.

All other prerequisites needed by the Adveon application are included in the installation package. These are:

o .NET Framework 4.5

o MS Visual C++ 2010 SP1 Redistributable Package

o MS SQL Server Express 2008 R2 SP2

o MS Report Viewer 2012 Runtime

Note:

The standard installation mode cannot be used when an Adveon MSSQL Server instance already exists.

In this case the following message appears after selection of the standard installation:

You have to use the advanced installation mode or contact the administrator.


6

3 Installation

3.1 Overview

You can choose one of the following three installation modes:

Standard: All components of Adveon will be installed on a single machine. If multi-machine set-up is

required, the advanced installation option has to be used.

The following components will be installed onto one machine:

o Server: (you specified Adveon service address and data download service account) o Adveon Client: default (c:\Program Files(x86)\Adveon) o Database: default (DB-server: your server name, DB instance: Adveon, DB name: Adveon) o CAM gateway (if selected, only one possible)

Client only: Adveon will be running in client/server mode. Only for the installation of additional Client-

Interfaces. Components installed

o Adveon Client: (your specified Installation path and web service address)

Advanced: Offers individual selection and customization of all available components.

Possible installation and customization of the following components:

o Server

o Adveon Client installation path

o Database

o CAM gateway(s)

Advanced installation can be required if you:

o need to distribute the Adveon components to different machines.

o need to use Adveon with more than one type of CAM system.

o have an Adveon MS SQL Server instance on the machine running the installation, already installed.

Note:

The standard installation mode cannot be used when an Adveon MS SQL Server instance already exists.

In this case the following message appears after selection of the standard installation:

You have to use the advanced installation mode or contact the administrator.

Depending on the type of installation, and the performance of your system, the installation can take up to 30 minutes.

For more detailed information please refer to the corresponding chapter.


7

3.2 Standard Installation Mode

Step 1: Select the language

Select the installer language and click on the ‘Next’ button to continue.

Step 2: Agreement for ‘Disclaimer and Terms of Use’

To continue the installation, select the ‘I agree‘ checkbox and click on the ’Next’ button to continue.


8

Step 3: Select the installation type

Select ‘Standard’ installation mode and click on the ’Next’ button to continue.

Step 4: Select the CAM installed on your machine

If one or more CAM systems are available on your system, select the desired CAM system interfacing with Adveon,

and click on the ‘Next‘ button to continue. If you’d like to choose more than one CAM-System, you have to do an

advanced installation.


9

Step 5: CAM system configuration

Please be aware, that the CAM settings vary according to the CAM software installed. The screenshots above show

only an example.

For the Edgecam configuration choose the Edgecam version you’d like to use with Adveon.

Supported: 2014R2

Afterwards click on the ‘Next’ button to continue.


10

Step 6: Adveon server configuration

After the installation, several Windows services will be running for Adveon. The setting for the ‘Data download service

account’ on above page, affects only the ‘Adveon Data Synchronizer’ service which is used by the Adveon online

catalog synchronizing feature (see red frames in screenshot below). All other services are always running under the

‘Local system’ account (see blue frames in screenshot below).

It is not possible to give a general recommendation for this setting. A correct setting depends on your individual

requirements and your environment.


11

Possible pitfalls:

Local system account:

o when using the online catalog synchronizing feature, make sure, that the local system account has

internet access.

Custom account:

o only the user whose account was specified is able to use the Adveon data synchronizing feature.

o if the user account password is changed, the password also needs to be changed for the ‘Adveon

data synchronizer’ service. This can be done, by selecting ‘Properties’ and then the ‘log on’ tab

(see screenshot below).

After Adveon server configuration click on the ‘Next‘ button to continue.

Step 7: Summary

Please verify all settings before continuing the installation process. If needed go back to the relevant dialog for

correction. Otherwise click on the ‘Install‘ button to proceed with the installation.

When the ‘Finish’ page is displayed, all components are installed successfully.

Click on the ‘Close’ button to close the Adveon application installer to finish installation..


12

3.3 Client only installation mode

Be aware, that it is not possible to connect to a CAM system in the ‘Client only’ installation mode. If this is needed, you have to do the ‘Advanced’ installation (see chapter 3.4) and select the ‘Client’ and ‘CAM gate-way’ component.




If you agree on the disclaimer and continue the installation, select the ‘I agree‘ checkbox and click on the ’Next’

button.


13

Step 3: Select installation type

Select ‘Client only’ installation mode and click on the ‘Next’ button to continue.

Step 4: Installation path

Enter an alternative installation path if needed. Otherwise leave the default setting and click on the ‘Next’ button to

continue.


14

Step 5: Client Configuration

The Adveon web service address is needed to get access to the Adveon server.

Enter the server name, server port and Adveon Web Service name (name of instance). Optionally you can set

values by using the ‘Open…’ button and browsing for the file where the address of the Adveon Web Service

was stored during the Adveon Server installation (see step 9 in chapter 3.4).

Click on the ‘Test connection’ button to verify that the Adveon Web Service is available on the specified

address. If the message ‘Service is accessible.’ appears the ‘Next’ button will be enabled. If the web service is

not available, refer to chapter 8 on how to troubleshoot this issue.

Click on the ‘Next’ button to continue.

Step 6: Summary




Click on the ‘Close’ button to close the Adveon application installer to finish installation.


15

3.4 Advanced installation mode

With the ‘Advanced’ installation you can install all Adveon components (Client, Server, Gateway and Database) and

individually customized and combine them. They can be installed on a single machine for standalone use or on several

machines to support multi-machine scenarios.




If you agree on the disclaimer and continue the installation, select the ‘I agree‘ checkbox and click on the ’Next’

button.


16

Step 3: Select installation type

Select the ‘Advanced’ installation type and click on the ’Next’ button to continue.

Step 4: Installation path

Enter an alternative installation path if required. Otherwise leave the default setting and click on the ‘Next’ button to

continue.


17

Step 5: Select the components to be installed

Select the components you’d like to install. Please Consider that:

the 'Server' component always automatically selects the 'Database' component. If no Adveon MS SQL Server

instance is available, the installation process will create a new SQL 2008R2 server.

the combination of only client and database is not recommended although the Adveon installer allows this

type of selection.

Be sure to start the installation routine on the same machine where your CAM-Software is running, as the

CAM Gateway has to be on the same machine where your CAM-software is running. If you’d like to use more

than one CAM-System on different machines, you’ll have to run the Adveon installer, installing a CAM

Gateway, on each machine.

depending on your selection, the installation steps will vary.

After selection click on the ‘Next’ button to continue.


18

Step 6: Server data configuration The ‘Server’ component was selected

Enter the data folder path or leave the default value. Click on the ‘Next’ button to continue.


19

Step 7: Data generation strategy The ‘Server’ component was selected

Choose the first option if you need a new database containing only catalog elements. Otherwise choose the second

option which will restore backup data from another Adveon installation to access previousely created individual data.

To search for the backup file, cklick on the ‘Browse…’ button.



20

Step 8: Database configuration The ‘Server’/’Database’ component was selected First option: ‘Create new SQL 2008R2 server’

If you don’t already have an existing Adveon MS SQL Server instance, we recommend leaving the default settings, in

which case a new SQL 2008R2 server will be created. The SQL server name is then automatically set to the name of

the PC running the Adveon application installer and cannot be modified.

You can modify the name for the instance and the database. The default setting is ‘Adveon’ for both.

You can choose to use ‘SQL Server authentication’ instead of ‘Windows authentication’. For ‘SQL Server

authentication’ the username is automatically set to ‘sa’ for server administrator and cannot be modified. Create

and confirm your preferred password.

Click the ‘Next’ button to continue.


21

Second option: ‘Use existing SQL 2008R2 server’:

If you like to use an already existing MS SQL server instance on your own or on a remote machine for deploying the

Adveon database you can select the option ‘Use existing SQL 2008R2 server’. Please consider that due to possible

firewall and SQL server restrictions the deployment on a remote server might not work. To bypass this problem, we

recommend selecting a SQL server running on the same PC where the installer is launched.

If you decide on using an existing SQL server, you also have to:

specify an existing server name, instance name (if named instance is used) and database name

choose how to log on to the database server (‘Log on to the server’ option).

For ‘SQL Server authentication’ enter a valid ‘Username’ and ‘Password’

Click on the ‘Test connection’ button to verify your settings. If successful the ‘Next’ button will be enabled.

If the web service is not available, refer to chapter 8 on how to troubleshoot this issue.



22

Step 9: Adveon server configuration The ’Server’ component was selected

After the installation, several Windows services will be running for Adveon. The setting for the ‘Data download service

account’ on above page, refers to the ‘Adveon Data Synchronizer’ service only, which is used by the Adveon online

catalog synchronizing feature (see red frames in screenshot below). All other services are always running under the

‘Local system’ account (see blue frames in screenshot below).

It is not possible to give a general recommendation for this setting. A correct setting depends on your individual

requirements and your environment.


23

Possible pitfalls:

Local system account:

o when using the online catalog synchronizing feature, make sure, that the local system account has internet

access.

Custom account:

o only the user whose account was specified is able to use the Adveon data synchronizing feature.

o if the user account password is changed, the password also needs to be changed for the ‘Adveon data

synchronizer’ service. This can be done, by selecting ‘Properties’ and then the ‘log on’ tab (see screenshot

below).

After Adveon server configuration click on the ‘Next‘ button to continue.


24

Step 10: Client Configuration (read mode) The ‘Client’ component together with the ‘Server’ component was selected

Verify the settings and continue to the next step by clicking on the ‘Next’ button.

Step 10: Client Configuration (edit mode) The ‘Client’ component without the ‘Server’ component was selected

Enter the server name, server port and Adveon Web Service name (name of instance). Optionally you can set the

values by using the ‘Open…’ button and browsing for the file where the address of the Adveon Web Service was

stored during the Adveon Server installation (see step 6 in chapter 3.4).

Click on the ‘Test connection’ button to verify that the Adveon Web Service is available on the specified address.

If the message ‘Service is accessible.’ appears the ‘Next’ button will be enabled. If the web service is not

available, refer to chapter 8 on how to troubleshoot this issue.



25

Step 11: Gateway configuration The ‘CAM Gateway’ component together with the ‘Server’ and/or ‘Client’ component was selected

Choose the CAM system(s) interfacing with Adveon, then click on the ‘Next’ button to continue. Step 11: Gateway configuration The ‘CAM Gateway’ component without the ‘Server’ and/or ‘Client’ component was selected

Enter the ‘web service address’ to get access to the Adveon server (see Step10 above)

Choose the CAM system(s) interfacing with Adveon



26

Step 12: CAM system configuration

The ‘CAM Gateway’ component was selected

The CAM settings vary according to the CAM software installed. The screenshots above show only two examples.

For the Edgecam configuration choose the Edgecam version you’d like to use with Adveon.

Currently supported: 2014R2



27

Step 13: Summary




Click on the ‘Close’ button to close the Adveon application installer to finish installation..


28

4 Uninstallation

Before the uninstallation of Adveon we recommend to make a backup of the database and related files.

For further information, please refer to the Adveon user guide. You can choose to uninstall only certain components,

or do a complete uninstallation of Adveon.

To uninstall Adveon, start the Adveon Installer and continue with the following steps. Be sure that the installer and

the Adveon version have matching versions. We generally do not recommend using ‘Programs and Features’ in the

Windows ‘Control Panel’ for the uninstallation of Adveon.

Step 1: Select language


Step 2: Components Modification

Select the ‘Uninstall’ option and click on the ‘Next’ button to continue.


29

Step 3: Select Components to be uninstalled

Select the components you would like to uninstall.

Please be aware, that if you uninstall the server, all clients will stop working.

click on the ‘Yes‘ button to confirm your choice.

Step 4: Uninstall confirmation

click on the ‘Yes‘ button to proceed with the uninstallation.

Once the ‘Finish’ page is displayed, Adveon uninstallation has completed successfully.


30

In some cases, before installing Adveon again you’ll have to restart your computer. This might be the case if :

The .net framework is not usually present on your machine. As it is deployed as part of the Adveon

installation a restart will be needed.

Another SQL server is running on your machine which might keep some files locked.

If you want to do the restart now and then continue with the installation, save your files, select Restart and Close the

installer.

Click on the ‘Close’ button to close the Adveon application installer.


31

5 Upgrade

Upgrade to a newer version of Adveon, keeping the existing data, user and application settings. Only possible when Adveon is already installed.




Select the ‘Upgrade’ option and click on the ‘Next’ button to continue.


32

Step 3: Change Confirmation

To go ahead with the upgrade, click on the ‘Upgrade’ button to continue.

Once the ‘Finish’ page is displayed, Adveon is upgraded successfully.



33

6 Repair

A repair is replacing Adveon specific files, without touching the user data and settings.

You can try a repair, if the application files get corrupted, e.g. by malicious software or a hard drive failure.




Select the ‘Repair’ option and click on the ‘Next’ button to continue.


34

Step 3: Change confirmation

Click on the ‚Repair‘ button to start the repair process.

Once the ‘Finish’ page is displayed, the components are repaired successfully.

In some cases, before installing Adveon again you’ll have to restart your computer. This might be the case if :

The .net framework is not usually present on your machine. As it is deployed as part of the Adveon

installation a restart will be needed.

Another SQL server is running on your machine which might keep some files locked.

If you want to do the restart straight after the repair, save your files, select Restart and Close the installer.



35

7 Add components

Add additional components to an existing Adveon installation. Only missing components will be available for selection. As an example this chapter describes the installation of the ‘Client’ component. For further reference or the installation of other components please refer to the respective Steps in the chapter 3.4 Advanced installation.




Select ‘Add components’ option and click on the ‘Next’ button to continue.


36

Step 3: Select components to be installed

Select the missing component – in this example the ‘Client’ component – and click the ‘Next’ button to continue.

Step 4: Client configuration

Specify the settings for ‘Client Configuration’ (see also Step 10 in chapter 3.4).



37

The ‘Finish’ page will be displayed when all the components are installed successfully.



38

8 Troubleshooting

This section deals with information which can be helpful to troubleshoot problems related to the Adveon application.

It describes known issues and log files details.

8.1 Installation

This section focuses on the issues which can occur during application installation, describes installer log files and also

lists known installation limitations.

8.1.1 Client Configuration – connection issue

A connection problem can occur when configuring client connection details. When the connection test using the ‘Test

connection’ button is not successful, the following error message is displayed – see picture below.

In this case verify that the address is correct. If the address is correct but the connection test is still failing try the

following potential solutions:

1. The Windows Service hosting Adveon Web Service is not started on the specified machine In order to check the status of the Adveon Windows Services follow these steps:

o Connect to the machine hosting the Server component – see the value of ‘YourServerName’ in the dialog (it can be a different machine than the machine where client is being installed in multi-machine deployment scenario)

o Start Services MMC snap-in The snap-in can be started from Administrative Tools or type Services.msc on command line or in

the Start ‘Search program and files' dialog.

o Ensure that the ‘Adveon Service Host’ Windows service is started – see picture below. When the service is not started you have to start the service or contact your Administrator.


39

2. The Windows Firewall blocks the connection

During the Server component installation the Windows Firewall is configured to allow a connection to the

Adveon Client. To verify this configuration - checking Windows Firewall setting on the machine where Server

component was installed - follow the steps below:

o Connect to the machine where the Server component was installed – see the value of ‘YourServerName’ in the dialog (it can be a different machine than the machine where client is being installed in multi-machine deployment scenario)

o Go to Control Panel -> System and Security -> Windows Firewall

o Click on the ’Allow a program or features through Windows Firewall’ on the top left

o Verify the setting for the ‘Adveon Server Service Host’ – see picture below

The port number value must match the value specified in the Client Configuration dialog.


40

8.1.2 Database Configuration – connection issue

This connection problem can occur when configuring database connection details. When the connection test with the

‘Test connection’ button is not successful, the error message is displayed – see picture below.

In this case verify that the server, instance and database names are correct. If all values are correct but the connection

test is still failing the Windows Firewall might be blocking the connection to the MSSQL Server on the database server.

Contact your administrator to verify this issue. A rule has to be created to enable the connection for the dynamic port

when a dedicated Adveon named MS SQL instance is used, or for the specific port 1433 when the default instance is

used.

See link below how to configure Windows Firewall for the database engine access.

http://technet.microsoft.com/en-us/library/ms175043(v=sql.105).aspx

http://technet.microsoft.com/en-us/library/ms175043(v=sql.105).aspx


41

8.1.3 Log files

The log files created during the installation process are stored in the %temp% folder. The folder contains log files

created from the Adveon application installer including its prerequisites.

Two types of log files are created:

Log files for the overall bundle

<bundle_name>_<major_ver>.<minor_ver>_<timestamp>.log

Log files for the bundle

packages<bundle_name>_<major_ver>.<minor_ver>_<timestamp>_<package_seq_no>_<package_id>.log

8.1.4 Known Limitations

This sections describes know limitation and issues of the installer.

The Adveon databases are deployed using the Database installer component. The User can select if the

databases are deployed to an existing MSSQL Server instance or if a new MSSQL Server instance dedicated

just to the Adveon databases is created.

Remote deployment is currently not supported. The Database component can only be installed to the local

machine.

It is currently not supported to install just Server services. Databases are always deployed within the Server

component.

The documents must be stored on the local machine. This is due to the limited access of the local service

account under which the document service currently runs.


42

8.2 Uninstallation

If you are running into problems uninstalling Adveon application the standard way, you can try to start the

uninstallation process from the command line:

Adveon.exe –uninstall –quiet

If you still experience uninstallation issues contact the system administrator.

8.3 Application and Services Logfiles

This section focuses on the issues which can occur during application runtime. The Client application, Server and

Gateway services issues can be investigated using log files created during runtime.

The Client application log files can be found by default in ‘%appdata%\Adveon\Logs’ folder. The log files location is

configured in the XML file in the Client installation folder (by default ‘C:\Program Files (x86)\Adveon\Client’) =>

AP.Adveon.Presentation.Application.exe.config

The Services application log files can be found by default in Logs ‘C:\ProgramData\Adveon\Logs’ folder.

There are several log files here:

Adveon_service_debug.log, Adveon_service_error.log: Logs for the service host. It contains information about startup and shutdown of the host and the addins. The log files location is configured in log4net section of Error! Reference source not found. configuration file. The AP Adveon Service Host service configuration s stored in the XML file in the Server installation folder (by default ‘C:\Program Files (x86)\Adveon\Server\Services\Host’) => AP.Common.Service.Host.exe.config

Adveon_debug.log, Adveon_error.log: Centralized log file used for both client and service side logging. The log files location is configured in log4net section of AP.Adveon.Logging.Service.AddIn.dll.config.

Adveon.DataSynchronizer.debug.log, Adveon.DataSynchronizer.error.log: Logs for datasynchronizer service. For configuration, see log4net section of the Error! Reference source not found. configuration. The Adveon ata Synchronizer service configuration is stored in the XML file in the Server installation folder (by default

‘C:\Program Files (x86)\Adveon\Server\DataSyncService’) => Adveon.DataSynchronizer.exe.config

Documents

Adveon Installation Guide - joinville.ifsc.edu.br