Professional Documents
Culture Documents
Adveon Installation Guide V1.3 and V1.5 - Edgecam - Basic
Adveon Installation Guide V1.3 and V1.5 - Edgecam - Basic
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, mech-
anical photocopying or otherwise, without prior permission of Sandvik Coromant.
Text and graphics have been edited very carefully, however, errors cannot be excluded.
© 2012 - 2013 Sandvik Coromant. All rights reserved.
2
Adveon V1.3 - Installation Guide
Table of content
1 System Requirements 5
1.1 Single Machine Configuration 5
1.2 Network Configuration 5
1.2.1 Client 5
1.2.2 Server 5
2 Prerequisites 6
3 Installation Types 7
3.1 Standard Installation 8
3.1.1 Language, installation type and CAM selection 8
3.1.2 Summary 9
3.2 Advanced Installation 10
3.2.1 Language and installation type selection 10
3.2.2 Select components to be installed 11
3.2.3 Server data configuration ('Server' and/or 'Database' component selection) 12
3.2.4 Database configuration ('Database' component selection) 13
3.2.5 Adveon server configuration ('Server' component selection) 15
3.2.6 Summary 16
3.2.7 Client configuration (only 'Client' component selection) 17
3.2.8 Gateway configuration (only 'Gateway' component selection) 18
4 Uninstallation 19
5 Upgrade 22
6 Repair 24
7 Add Components 26
8 Possible Adveon Setup Scenarios 30
9 Edgecam Specific Information 31
10 Troubleshooting 32
10.1 Installation Issues 32
10.1.1 Saving Log files when Installation fails 32
10.1.2 Client Configuration - Connection Issue 33
10.1.3 Database Configuration 35
10.1.3.1 Connection issue 35
10.1.3.2 Instance issue 35
10.1.4 Known Limitations 36
10.2 Uninstallation Issues 37
10.2.1 Saving Log files when Uninstallation fails 37
10.2.2 Uninstalling Adveon from the control panel 37
10.2.3 Uninstalling Adveon using the orginal installation exe file 38
10.2.4 Finding out which version of Adveon is currently installed 38
3
Adveon V1.3 - Installation Guide
4
Adveon V1.3 - Installation Guide
1 System Requirements
1.1 Single Machine Configuration
Minimum:
o Core processor, 2 GHz
o OS: Windows 7 (32 bit) or newer
o RAM: 4 GB for 32 bit, 6 GB for 64 bit
o Screen: 17" (1280 x 1024)
o 20 GB free disk space required (this estimate includes the download of 2-3 catalogues)
o Internet connection, USB port or DVD drive
Recommended:
o Multicore processor, at least 2 GHz
o OS: Windows 7 (64 bit) or newer
o RAM: 2 GB per each processor core, 8 GB recommended
o Screen: 17" (1280 x 1024)
o 20 GB free disk space required (this estimate includes the download of 2-3 catalogues)
o Internet connection, USB port or DVD drive
1.2.2 Server
Minimum:
o Network connectivity to clients
o Core processor, 2 GHz
o OS:Windows 7 (32 bit)
o RAM: 4 GB for 32 bit, 8 GB for 64 bit
o 20 GB free disk space required (this estimate includes the download of 2-3 catalogues)
o Internet connection, USB port or DVD drive
Recommended:
o Network connectivity to clients
o Multicore processor, at least 2 GHz
o OS: Windows 7 (64 bit)
o RAM: 2 GB per each processor core
o 20 GB free disk space required (this estimate includes the download of 2-3 catalogues)
o Internet connection, USB port or DVD drive
5
Adveon V1.3 - Installation Guide
2 Prerequisites
o Local administration rights
o Installation files on a local drive
o Edgecam already installed and licensed and also the Edgecam Toolstore location must be defined. The lat-
ter can be saved by starting Edgecam at least once after its installation. As a result Edgecam will auto-
matically ask you for the definition of the Toolstore location. These measures will ensure the availability of
Adveon inclusive license and gateway functionality.
Currently supported version: Edgecam 2015 R2 and Edgecam 2016 R1
All other prerequisites needed by the Adveon application (see subfolder "prerequisites" besides the Adveon
installer) will be automatically installed by the Adveon installer. These are:
o .NET Framework 4.5
o Microsoft Visual C++ 2010 SP1 Redistributable Package
o Microsoft SQL Server Express 2014
6
Adveon V1.3 - Installation Guide
3 Installation Types
To install Adveon you can choose one of the following two installation types:
o 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:
l Server: (the Adveon service address and data download service account are specified)
l Adveon Client: default (c:\Program Files(x86)\Adveon)
l Database: default (DB-server: localhost, DB instance: Adveon, DB name: Adveon
l CAM gateway
o Advanced:
Offers individual selection and customization of all available components.
Possible installation and customization of the following components:
l Server
l Adveon Client
l Database
l CAM gateway(s)
Advanced installation can be required if:
l you need to distribute the Adveon components to different machines. Please be aware that a client
server configuration is only possible, if you use the same version of Adveon on all machines
l you need to use Adveon with more than one type of CAM system
l an ‘Adveon’ MS SQL Server instance already exists
l you want to manage the database by yourself
7
Adveon V1.3 - Installation Guide
Change the installer and application language if needed, select the 'Standard' installation type and your CAM sys-
tem interface and click on the ‘Next’ button to continue.
o Be aware the license for Adveon will be provided by your CAM system. So if you choose 'None' or if your
CAM system is still not licensed Adveon won't be able to start.
o If you need more than one CAM-System, an 'Advanced' installation is required as described in chapter '3.2
Advanced Installation'.
Note: For Adveon to be able to export assemblies to Edgecam, the location of the Edgecam Toolstore must be
defined before Adveon installation.
8
Adveon V1.3 - Installation Guide
3.1.2 Summary
Please verify all settings before continuing the installation process. If needed go back to the relevant dialog for cor-
rection.
The configuration file displayed below the summary screen, contains the command line arguments used by the
Adveon installer for this installation.
To continue installation click on the ‘Install‘ button after confirming the disclaimer below.
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.
Note: After installing Adveon, you need to add a catalog to have access to tool data. Please refer to the 'Adveon -
Getting Started Guide' on how to do this.
9
Adveon V1.3 - Installation Guide
Change the installer and application language if needed, select 'Advanced' installation type and click on the ‘Next’
button to continue.
10
Adveon V1.3 - Installation Guide
11
Adveon V1.3 - Installation Guide
Enter the data folder path or leave the default path and click on the ‘Next’ button to continue.
12
Adveon V1.3 - Installation Guide
You can leave the default settings and click the 'Next' button to continue which will create a new SQL server. The
SQL server name is then automatically set to the name of the local machine (represented by 'localhost') and can-
not be modified. If you prefer you can change the name for the instance and the database.
To log on to the database server either you can choose to use ‘SQL Server authentication’ or ‘Windows authen-
tication’. For ‘SQL Server authentication’ the user name is automatically set to ‘sa’ for server administrator and can-
not be modified. You can choose any password as long as it adheres to the password rules.
Click on the ‘Next’ button to continue.
13
Adveon V1.3 - Installation Guide
If you like to use an already existing MS SQL server instance on your machine for deploying the Adveon database
you can select the second option ‘I manage SQL server myself’. In this case:
o enter the respective instance name.
o enter the preferred database name.
o Choose how to log on to the database server. For ‘SQL Server authentication’ enter a valid ‘Username’ and
‘Password’.
14
Adveon V1.3 - Installation Guide
Ports configuration:
In the first field enter the beginning port address for the required port range (e.g. '8000'). The second field will be
filled automatically. If a port number is already assigned you will get the error message
'Port range is not available. Please choose another range'
as soon as you click on the 'Next' button. Enter another number and retry.
15
Adveon V1.3 - Installation Guide
3.2.6 Summary
Please verify all settings before continuing the installation process. If needed go back to the relevant dialog for cor-
rection.
The configuration file displayed below the summary screen, contains the command line arguments used by the
Adveon installer for this installation.
To continue installation click on the ‘Install‘ button after confirming the disclaimer below.
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.
Note: After installing Adveon, you need to add a catalog to have access to tool data. Please refer to the 'Adveon -
Getting Started Guide' on how to do this.
16
Adveon V1.3 - Installation Guide
This mask appears in case of a multi-machine scenario only. Enter the correct 'ServerName' and 'Port' number
(default is '8000') of the Adveon server. Click on the ‘Next’ button to continue.
17
Adveon V1.3 - Installation Guide
This mask appears in case of a multi-machine scenario only. Enter the correct 'ServerName' and 'Port' number
(default is '8000') for the Adveon server. In the last field enter a free port number for the gateway service. Click on
the ‘Next’ button to continue.
Note:
For the gateway service port you can try first with port number '8002' for example. If a port number is already
assigned you will get the error message
'Port range is not available. Please choose another range'
as soon as you click on the 'Next' button. Enter another number and retry.
18
Adveon V1.3 - Installation Guide
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 (chapter Administration of Adveon - Backup). 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. You can also start the uninstallation from the control panel in Pro-
grams and Features to make sure you are using the correct version.
For more information refer to chapter '10.2 Uninstallation Issues'.
Select the installer language and click on the ‘Next’ button to continue.
19
Adveon V1.3 - Installation Guide
Select the ‘Uninstall’ option and click on the ‘Next’ button to continue.
Select the components to be uninstalled. Please be aware, that if you uninstall the server, all clients will stop work-
ing. Click on the ‘Next’ button to continue.
20
Adveon V1.3 - Installation Guide
Once the ‘Finish’ page is displayed, Adveon uninstallation has completed successfully. In some cases, before
installing Adveon again, you’ll have to restart your computer. If you like to do the restart now and continue with
the installation, save your files, select 'Restart' and Close the installer.
21
Adveon V1.3 - Installation Guide
5 Upgrade
Upgrade to a newer version of Adveon, keeping the existing data, user and application settings. This is only pos-
sible if Adveon is already installed. Upgrade is only possible from version 1.1.3.60 onwards.
22
Adveon V1.3 - Installation Guide
Step 4: Finish
Once the ‘Finish’ page is displayed, Adveon upgrade has completed successfully.
23
Adveon V1.3 - Installation Guide
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.
24
Adveon V1.3 - Installation Guide
Step 4: Finish
Once the ‘Finish’ page is displayed, Adveon repair has completed successfully.
25
Adveon V1.3 - Installation Guide
7 Add Components
Add additional components to an existing Adveon installation. Only missing components will be available for selec-
tion.
Select the ‘Add components’ option. Click on the ‘Next’ button to continue.
26
Adveon V1.3 - Installation Guide
Select the component(s) you’d like to install. Click on the ‘Next’ button to continue.
Leave the default settings for the Adveon service address and click on the ‘Next’ button to continue.
27
Adveon V1.3 - Installation Guide
For configuration of 'Adveon service address' leave the default settings. This option appears only if no other com-
ponents are installed at the same time.
For 'Ports configuration' for the gateway service enter a free port number and click on the ‘Next’ button to con-
tinue.
Note:
You can try first with port number '8002' for example. This could be the first free port after the default port range
for the Adveon Server services. If a port number is already assigned you will get the error message
'Port range is not available. Please choose another range'
as soon as you click on the 'Next' button. Enter another number and retry.
28
Adveon V1.3 - Installation Guide
Step 6: Summary
Please verify all settings before continuing the installation process. If needed go back to the relevant dialog for cor-
rection.
The configuration file displayed below the summary screen, contains the command line arguments used by the
Adveon installer for this installation.
To continue installation click on the ‘Install‘ button.
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.
29
Adveon V1.3 - Installation Guide
Single-Machine Scenario
In the simplest scenario Adveon Application will be installed on CAM developer’s machine together with the CAM
system. The CAM Developer can use both CAM application and Adveon application to do his/her job. The following
figure shows this scenario.
Multi-Machine Scenarios
o In advanced scenarios Adveon Server component can be moved to a dedicated machine and serve several
Adveon Clients at the same time. In this case all Adveon data is maintained centrally and users work with
shared data.
o Adveon was designed in a way that you can execute all administrative options on the server only. Because
of this, an Adveon Client should always be installed on the same machine as the Adveon server. This
ensures that the Administrations tasks, such as adding and synchronizing catalogs can be performed.
o Clients without a CAM System should be able to use the license from a CAM System on another machine as
long as not all Licenses are in use by other Clients. One license can only by used by one client at any one
time. So as long as unused Licenses are available Adveon should work.
e.g. in below Scenario, 2 clients can use Adveon at the same time.
o A CAM-Gateway has to be installed on each machine which runs a CAM-system which has to be connected
to the Adveon server.
o An assembly exported by any client connected to the server, will be exported to all available gateways.
Trouble Shooting
When clients connect to the Adveon server the license is checked though the server's service.
If Adveon won’t start because it is missing a license although free licenses are available, the Server might have
some cached information and it might help if you restart the services.
Restart the "Adveon Service Gateway xxxxxxxxx" (where xxxxxxxxx stands for the CAM-system) on the client
only machine(s) with a CAM-system installed and "Adveon Service Host" on the server machine.
Then start the Adveon client on a machine where the license works but it is currently not needed , (client with CAM
system machine), and close it again. That should release the license and allow the client to be started elsewhere.
30
Adveon V1.3 - Installation Guide
Only one Edgecam gateway can be active at any one time. If you have more than one Edgecam version installed,
activate your preferred gateway inside Adveon Administration.
31
Adveon V1.3 - Installation Guide
10 Troubleshooting
This section deals with information which can be helpful to troubleshoot problems related to the Adveon applic-
ation. It describes known issues and log files details.
32
Adveon V1.3 - Installation Guide
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 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.
33
Adveon V1.3 - Installation Guide
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.
34
Adveon V1.3 - Installation Guide
In this case verify that the instance and database name is correct. If all values are correct but the connection test is
still failing the Windows Firewall might be blocking the connection to the MS SQL 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
You have to use the 'Advanced' installation type. For more information see 'Advcanced installation' step 6.
35
Adveon V1.3 - Installation Guide
36
Adveon V1.3 - Installation Guide
If for any reason you do not see this button, forward the following logfiles to your Adveon support team. Not all of
the logfiles are necessarily present:
c:\Users\<username>\AppData\Local\Temp\Adveon_1.0*.log
c:\Users\<username>\AppData\Local\Temp\Adveon_2.0*.log
c:\Users\<username>\AppData\Local\Temp\Adveon_server.log
1. Open the Control panel using the windows Start button and click on Control Panel and Programs and
Features.
2. Right click on Adveon and select uninstall.
37
Adveon V1.3 - Installation Guide
1. Start Adveon, click on the Administration tab and then click on Tool library.
2. Open the Control panel using the windows Start button and click on Programs and features:
38
Adveon V1.3 - Installation Guide
39
Adveon V1.3 - Installation Guide
2. Open the command prompt in Administration mode by right clicking and selecting ‘Run as Administrator’
3. In the command prompt, switch to the directory which contains your Adveon.exe and enter
the following command:
Adveon.exe –uninstall –quiet
4. The uninstallation process is finished as soon as you can’t see listed Adveon anymore in the Taskmanager.
Another alternative
1. Also in the command prompt, switch to the directory which contains your Adveon.exe which you’d like to
use for uninstallation and enter the following command:
Adveon.exe /quiet /ACTION=Uninstall /UNINSTALLCOMPONENTS=All
If you get an error message which tells you that the SQL Server already exists, the uninstallation didn’t
remove the Adveon instance properly, continue with point 2.
40
Adveon V1.3 - Installation Guide
2. Please execute the following command in any case, no matter how above command ended. This way you
make sure that the Adveon instance is removed. Execute the following command including the quotes, but
make sure that it contains the correct SQL server name (up to Adveon 1.1.3.61 it is SQLServer2008R2, see
command used in Possible Pitfalls):
This command can be successful (if the instance still existed) or fail. Both should be ok.
sometimes doesn’t work, because a different instance name was used at installation, e.g. Adveon2. Make
sure you change the command accordingly.
41
Adveon V1.3 - Installation Guide
If there is an Adveon SQL instance it needs to be uninstall from Programs and Features.
42
Adveon V1.3 - Installation Guide
Problem
Solution
43
Adveon V1.3 - Installation Guide
c. Test if the specified account has access to the internet by clicking on the Test account button.
d. If the test is not successful, change it to an account which has access to the internet and test again.
e. If successful, click the 'Apply' button.
3. If the catalog download still does not work after trying above suggestions, it could also be the proxy set-
tings or other internal security measures preventing Adveon from accessing the internet. To test this, try to
display the following url in internet explorer:
https://dds.sandvik.coromant.com/CatalogProvider.svc
44
Adveon V1.3 - Installation Guide
1. License failure although no other Adveon client is running . Usually Adveon was forcibly shut down or
crashed.
2. Below Message suddenly appears (in this example the user is using Adveon together with Edgecam):
Solution
Solution for problem 1
Usually this problem fixes itself after a lockout of about 5 minutes. If you don’t want to wait or the wait takes too
long try the following:
a. Click on the start button and enter services in the search window.
45
Adveon V1.3 - Installation Guide
46