Installation Guide

Transcription

Installation Guide

Installation Guide
Advanced
Adveon Version 1.3
Dezember 10, 2015
Adveon V1.3 - Installation Guide
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.
© 2012 - 2013 Sandvik Coromant. All rights reserved.
2
Table of content
1
System Requirements
6
1.1
Single Machine Configuration
6
1.2
Network Configuration
6
1.2.1
Client
6
1.2.2
Server
6
2
Prerequisites
7
3
Installation Types
8
3.1
Standard Installation
9
3.1.1
Language, installation type and CAM selection
9
3.1.2
Summary
10
3.2
Advanced Installation
11
3.2.1
Language and installation type selection
11
3.2.2
Select components to be installed
12
3.2.3
Server data configuration ('Server' and/or 'Database' component selection)
13
3.2.4
Database configuration ('Database' component selection)
14
3.2.5
Adveon server configuration ('Server' component selection)
16
3.2.6
DMG Virtual Machine configuration ('DMG Virtual Machine gateway' component selection)
18
3.2.7
Summary
19
3.2.8
Client configuration (only 'Client' component selection)
20
3.2.9
Gateway configuration (only 'Gateway' component selection)
21
4
Uninstallation
22
5
Upgrade
25
6
Repair
27
7
Add Components
29
8
Possible Adveon Setup Scenarios
33
9
Edgecam Specific Information
34
10
Troubleshooting
35
10.1
Installation Issues
35
10.1.1
Saving Log files when Installation fails
35
10.1.2
Client Configuration - Connection Issue
36
10.1.3
Database Configuration
38
10.1.3.1 Connection issue
38
10.1.3.2 Instance issue
38
10.1.4
Known Limitations
39
10.2
Uninstallation Issues
40
10.2.1
Saving Log files when Uninstallation fails
40
10.2.2
Uninstalling Adveon from the control panel
40
10.2.3
Uninstalling Adveon using the orginal installation exe file
41
3
10.2.4
Finding out which version of Adveon is currently installed
41
10.2.5
Alternative way to uninstall Adveon
43
10.2.6
Making sure that Adveon is uninstalled completely
45
10.3
Adding Online Catalog not possible
46
10.4
License Problems in Adveon
48
10.5
Saving Logfiles for Troubleshooting
49
11
Appendix
11.1
Command Line Installation
50
11.1.1
Introduction
50
11.1.2
Running Command Line Installer
50
11.1.3
Command Line Conventions
50
11.1.4
Supported Arguments
51
50
11.1.4.1 /ACTION
51
11.1.4.2 /CONFIGFILE
51
11.1.4.3 /CREATENEWSERVERDATA
52
11.1.4.4 /CREATENEWSQLINSTANCE
52
11.1.4.5 /DATABASENAME
52
11.1.4.6 /DATAFOLDER
52
11.1.4.7 /DMGOUTPUTFOLDER
52
11.1.4.8 /EXISTINGDATAPATH
52
11.1.4.9 /INSTALLATIONFOLDER
52
11.1.4.10 /INSTALLATIONTYPE
52
11.1.4.11 /INSTALLCOMPONENTS
53
11.1.4.12 /LANGUAGE
53
11.1.4.13 /LICENSE
53
11.1.4.14 /<MISCELLANEOUS>
53
11.1.4.15 /PORTRANGESTART
53
11.1.4.16 /SERVERNAME
53
11.1.4.17 /SERVICEACCOUNTISLOCALSYSTEM
53
11.1.4.18 /SERVICEPASSWORD
53
11.1.4.19 SERVICEUSERNAME
54
11.1.4.20 /SQLINSTANCENAME
54
11.1.4.21 /SQLSERVERNAME
54
11.1.4.22 /SQLSERVERPASSWORD
54
11.1.4.23 /SQLSERVERUSEINTEGRATEDAUTH
54
11.1.4.24 /SQLSERVERUSERNAME
54
11.1.4.25 /UNINSTALLCOMPONENTS
54
11.1.5
Workflows
56
11.1.6
Typical Use Case Examples
56
11.1.6.1 'Install' Command Line Examples
56
4
11.1.6.1.1 Install Client, Server, Database
56
11.1.6.1.2 Server, Database
56
11.1.6.1.3 Edgecam et al.
56
11.1.6.1.4 TopSolid et al.
57
11.1.6.1.5 GibbsCAM et al.
57
11.1.6.2 'Repair' command line examples
57
11.1.6.3 'Uninstall' Command Line Examples
57
11.1.6.3.1 Uninstall Client
57
11.1.6.3.2 Uninstall Client, Server, Database
57
5
1 System Requirements
1.1 Single Machine Configuration
Minimum:
o
o
o
o
o
o
Core processor, 2 GHz
OS: Windows 7 (32 bit) or newer
RAM: 4 GB for 32 bit, 6 GB for 64 bit
Screen: 17" (1280 x 1024)
20 GB free disk space required (this estimate includes the download of 2-3 catalogues)
Internet connection, USB port or DVD drive
Recommended:
o
o
o
o
o
o
Multicore processor, at least 2 GHz
OS: Windows 7 (64 bit) or newer
RAM: 2 GB per each processor core, 8 GB recommended
Screen: 17" (1280 x 1024)
1.2 Network Configuration
1.2.1 Client
Same as described in chapter '1.1 Single Machine Configuration' in addition to network connectivity to the server.
1.2.2 Server
Minimum:
o
o
o
o
o
o
Network connectivity to clients
Core processor, 2 GHz
OS: Windows 7 (32 bit)
RAM: 4 GB for 32 bit, 8 GB for 64 bit
Recommended:
o
o
o
o
o
o
Network connectivity to clients
Multicore processor, at least 2 GHz
OS: Windows 7 (64 bit)
RAM: 2 GB per each processor core
6
2 Prerequisites
o
o
o
o
o
o
o
Local administration rights
Installation files on a local drive
Edgecam already installed and licensed and also the Edgecam Toolstore location must be defined. The latter can be saved by starting Edgecam at least once after its installation. As a result Edgecam will automatically ask you for the definition of the Toolstore location. These measures will ensure the availability of
Adveon inclusive license and gateway functionality.
Currently supported versions: Edgecam 2015 R2 and Edgecam 2016 R1
TopSolid already installed and licensed. This will ensure the availability of Adveon inclusive license and gateway functionality.
Currently supported versions: TopSolid 7.9
GibbsCAM/Virtual Gibbs already installed and licensed. This will ensure the availability of Adveon inclusive
license and gateway functionality.
Currently supported versions: GibbsCAM 2015 10.8.x; GibbsCAM 2015 10.9.x; GibbsCAM
2015 11.x
DMG Virtual Machine license. This will ensure the availability of Adveon inclusive license and gateway functionality.
Currently supported versions: DMG Virtual Machine 5.x
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
o
o
.NET Framework 4.5
Microsoft Visual C++ 2010 SP1 Redistributable Package
Microsoft SQL Server Express 2014
For internal use only:
Normally Adveon will be licensed via the appropriate CAM system gateway. This means you have to have installed
at least one compatible and licensed CAM system. But for internal tests - in case of a missing (licensed) CAM system - it is also possible to get a licensed Adveon installation by using the 'install.bat' file. If you miss this file next to
the Adveon setup file please get in contact with our Adveon support team.
7
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
l
l
l
o
Server: (the Adveon service address and data download service account are specified)
Adveon Client: default (c:\Program Files(x86)\Adveon)
Database: default (DB-server: localhost, DB instance: Adveon, DB name: Adveon
CAM gateway
Advanced:
Offers individual selection and customization of all available components.
Possible installation and customization of the following components:
l
l
l
l
Server
Adveon Client
Database
CAM gateway(s)
Advanced installation can be required if:
l
l
l
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
you need to use Adveon with more than one type of CAM system
an ‘Adveon’ MS SQL Server instance already exists
you want to manage the database by yourself
For more detailed information please refer to the corresponding chapter.
Note:
After the installation is complete, you will find two shortcuts on your desktop. One for the Adveon Client and an
additional one for the Adveon Admin Client.
Depending on the installed components the Admin Client will contain the following functions:
o
o
o
Backup and restore functions for database and documents.
Switch for activating/deactivating debug mode and 'Save logs' function.
Option to modify 'Port ranges' for Adveon and Gateway services.
8
3.1 Standard Installation
3.1.1 Language, installation type and CAM selection
Change the installer and application language if needed, select the 'Standard' installation type and your CAM system interface and click on the ‘Next’ button to continue.
o
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.
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.
9
3.1.2 Summary
Please verify all settings before continuing the installation process. If needed go back to the relevant dialog for correction.
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.
10
3.2 Advanced Installation
With the ‘Advanced’ installation you can install all Adveon components (Client, Server, Gateway and Database)
and individually customize and combine them. They can be installed on a single machine for standalone use or on
several machines to support multi-machine scenarios.
3.2.1 Language and installation type selection
Change the installer and application language if needed, select 'Advanced' installation type and click on the ‘Next’
button to continue.
11
3.2.2 Select components to be installed
Select the components you’d like to install. A 'CAM System' selection is provided only if one or more supported
CAM systems are installed on the same machine.
Enter installation path or leave the default path and click on the 'Next' button to continue.
Note:
o
o
Be sure to start the installation routine on the same machine as your CAM-Software. 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 CAMSystem 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.
12
3.2.3 Server data configuration ('Server' and/or 'Database' component selection)
Enter the data folder path or leave the default path and click on the ‘Next’ button to continue.
13
3.2.4 Database configuration ('Database' component selection)
First option: 'Create new SQL server' (default)
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 cannot 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 authentication’. For ‘SQL Server authentication’ the user name is automatically set to ‘sa’ for server administrator and cannot be modified. You can choose any password as long as it adheres to the password rules.
Click on the ‘Next’ button to continue.
14
Second option: 'I manage SQL server myself'
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
o
o
enter the respective instance name,
enter the preferred database name and
choose how to log on to the database server. For ‘SQL Server authentication’ enter a valid ‘Username’ and
‘Password’.
Note: If you have selected to install the 'Server' component only, only the second option will be available in this
step.
15
3.2.5 Adveon server configuration ('Server' component selection)
Ports configuration:
Here you can define the port numbers which are required for
o
o
o
the Adveon service address to enable communication with Adveon server in multi-machine-scenarios,
the catalog data synchronizer service and for
CAM gateway(s) if at least one of them is selected.
In the first field enter the beginning port address for the required port range (default is '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.
Data download service account:
After the installation, several Windows services will be running for Adveon. The setting for the ‘Data download service account’ is used by the ‘Adveon Data Synchronizer’ service which is used by the online catalog download / synchronizing feature.
Choose the account which ensures internet access for the 'Adveon Data Synchronizer' service. If this applies to
both accounts we recommend to choose 'Local system account' because if you choose 'Custom account' you have
to modify the password inside Adveon 'Administration' section whenever you change your Windows or Domain
password, else you won’t be able to download or synchronize catalogs anymore.
If you are unsure you can leave the default setting and continue because you can modify this setting later inside
Adveon Administration.
Service address:
The Adveon service address can be saved to a text file which can be used for example by client users for a more
convenient installation process (see 'Client' and 'Gateway' configuration).
16
Within Sandvik network if you are using a SNC domain machine and you have installed Adveon by 'Run Advertised
Programs' in the 'Control Panel' you don't have to consider 'Data download service account' configuration.
17
3.2.6 DMG Virtual Machine configuration ('DMG Virtual Machine gateway' component
selection)
Output folder:
The 'Output folder' is used by Adveon to store the 'vmde' files during export of your tool assemblies to the DMG Virtual Machine. Make sure the folder matches the folder specified as 'VMDE share directory' in the 'Tool' menu (Tool>Options->Application) of the DMG Virtual Machine (see screenshot below), else the export from Adveon to DMG
will not work. The default value for this folder in the DMG Virtual Machine is 'C:\temp\camproject'. If it is changed
in the DMG Virtual Machine, make sure you also change it on Adveon side through the Admin Client.
Note: Please consider that DMG Virtual Machine is only supported under Windows 7.
18
3.2.7 Summary
To continue installation click on the ‘Install‘ button after confirming the disclaimer below.
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.
19
3.2.8 Client configuration (only 'Client' component selection)
This mask appears in the case you want to install only the 'Client' component on a machine in a multi-machine scenario or if you want to add the 'Client' component to a already existing Adveon installation.
Adveon service address
The port number of Adveon service address has already been defined during Server installation. That port number
represents port opened on the machine where Adveon Server is installed.
In a multi-machine scenario: Enter the correct 'ServerName' and 'Port' number (default is '8000') of the Adveon
server or click on the 'Open...' button to browse for the file where the Adveon service address was stored during
the Adveon server installation (see 'Adveon server configuration').
On a single-machine: You can leave 'localhost' for the 'ServerName' and the default port number ('8000').
20
3.2.9 Gateway configuration (only 'Gateway' component selection)
This mask appears in the case you want to install only a gateway component on a machine in a multi-machine scenario or if you want to add a gateway component to a already existing Adveon installation.
Ports configuration
The port range for gateway(s) defines which ports will the gateway(s) use for communication with Adveon Server
and CAM plugins. These ports need to be opened on the machine where Adveon Gateway(s) is/are installed.
Depending on the number and the type(s) of selected CAM-system(s) one or more ports are needed. In the first
field enter the beginning port address for the required port range. Of course you can also leave the predefined
value. The second field will be filled always automatically. If a port number is already assigned you will get the
error message
21
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 Programs and Features to make sure you are using the correct version.
For more information refer to chapter '10.2 Uninstallation Issues'.
Step 1: Language selection
Select the installer language and click on the ‘Next’ button to continue.
22
Step 2: Uninstall selection
Select the ‘Uninstall’ option and click on the ‘Next’ button to continue.
Step 3: Select components to be uninstalled
Select the components to be uninstalled. Please be aware, that if you uninstall the server, all clients will stop working. Click on the ‘Next’ button to continue.
23
Step 4: Uninstall confirmation
Click on the ‘Yes‘ button to proceed with the uninstallation.
Step 5: Finish
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.
24
5 Upgrade
Upgrade to a newer version of Adveon, keeping the existing data, user and application settings. This is only possible if Adveon is already installed. Upgrade is only possible from version 1.1.3.60 onwards.
Select the installer language. Click on the ‘Next’ button to continue.
Step 2: Upgrade selection
Select the ‘Upgrade’ option. Click on the ‘Next’ button to continue.
25
Step 3: Change confirmation
To go ahead click on the ‘Upgrade’ button .
Step 4: Finish
Once the ‘Finish’ page is displayed, Adveon upgrade has completed successfully.
26
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.
Step 2: Repair selection
Select the ‘Repair’ option. Click on the ‘Next’ button to continue.
27
Step 3: Change confirmation
To go ahead click on the ‘Repair’ button .
Step 4: Finish
Once the ‘Finish’ page is displayed, Adveon repair has completed successfully.
28
7 Add Components
Add additional components to an existing Adveon installation. Only missing components will be available for selection.
Step 2: Add components selection
Select the ‘Add components’ option. Click on the ‘Next’ button to continue.
29
Step 3: Select components to be installed
Select the component(s) you’d like to install. Click on the ‘Next’ button to continue.
Step 4: Client configuration ('Client' component selection)
30
Step 5: Gateway configuration (Gateway' component selection)
Ports configuration
The port range for gateway(s) defines which ports will the gateway(s) use for communication with Adveon Server
and CAM plugins. These ports need to be opened on the machine where Adveon Gateway(s) is/are installed.
Depending on the number and the type(s) of selected CAM-system(s) one or more ports are needed. In the first
field enter the beginning port address for the required port range. Of course you can also leave the predefined
value. The second field will be filled always automatically. If a port number is already assigned you will get the
error message
31
Step 6: Summary
To continue installation click on the ‘Install‘ button.
32
8 Possible Adveon Setup Scenarios
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
o
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.
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.
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
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.
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 through 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.
33
9 Edgecam Specific Information
Adveon writes to the active toolstore and support folder as set in 'Toolstore Administrator' – the Bridge Configurator is no longer used.
The CAM Gateway can be started from the Adveon program group and when started is displayed in the task bar
tray as shown below. Usually Adveon will start it automatically for each available CAM system and there is no need
to start it manually.
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.
34
10 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.
10.1 Installation Issues
This section focuses on the issues which can occur during application installation, describes installer log files and
also lists known installation limitations.
10.1.1 Saving Log files when Installation fails
When the installation fails for any reason, it is recommended to save the log files.
You can do this with the following button:
After clicking on 'Save log files' a zip file will be generated.
Please save this zip file to a place suitable to you and send it to support.
35
10.1.2 Client Configuration - Connection Issue
A connection problem can occur when configuring client connection details. When the connection test which is starting automatically after click on the 'Next' 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 multimachine 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.
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
36
o
o
o
multi-machine deployment scenario).
Go to Control Panel -> System and Security -> Windows Firewall.
Click on ’Allow a program or feature through Windows Firewall’ on the top left.
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.
37
10.1.3 Database Configuration
10.1.3.1 Connection issue
This connection problem can occur when configuring database connection details. When the connection test which
is starting automatically after click on the 'Next' button is not successful, the error message is displayed – see picture below.
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
10.1.3.2 Instance issue
The standard installation mode cannot be used when an Adveon MS SQL Server instance already exists. In this
case the message shown in the screenshot below appears after selection of the standard installation:
You have to use the 'Advanced' installation type. For more information see 'Advcanced installation' step 6.
38
10.1.4 Known Limitations
o
o
o
o
The Adveon databases are deployed using the Database installer component. The User can select if the
databases are deployed to an existing MS SQL Server instance or if a new MS SQL 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.
39
10.2 Uninstallation Issues
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
You will need administrator rights to do this.
It is very important to use the compatible Adveon setup file containing the same release as the installed Adveon
release.
If you still experience uninstallation issues contact the system administrator.
10.2.1 Saving Log files when Uninstallation fails
If the uninstallation still does not work, please collect the logfiles at the end of the unsuccessful installation by pressing the button, collect logfiles and forward them to your Adveon support team.
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
10.2.2 Uninstalling Adveon from the control panel
Uninstalling Adveon from the control panel is possible from version 1.2.0.37 onwards.
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.
40
10.2.3 Uninstalling Adveon using the orginal installation exe file
1. To uninstall Adveon, always use the Adveon.exe of the currently installed Adveon, NOT the one of the
Adveon you would like to install, e.g. if you would like to uninstall Adveon Version 1.2.1.4 and install
1.3.1.4, you must use the Adveon.exe of version 1.2.1.4 to uninstall Adveon.
2. Make sure you run the exe in administration mode by right clicking on it and choosing ‘Run as Administrator’. Then follow the wizard.
10.2.4 Finding out which version of Adveon is currently installed
To find out which version of Adveon is currently installed, do one of the following:
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:
3. Open the “Registry” and have a look at:
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Adveon\Adveon\1.0\Server]
To open the registry, click the start button, type 'regedit' in the search field and then double click on 'regedit.exe'.
41
To find Adveon release number, follow above path:
42
10.2.5 Alternative way to uninstall Adveon
If the uninstallation does not finish successfully, try the following:
1. Copy the Adveon.exe to a local directory (in our example c:\temp).
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 containing 'keyword ACTION=Uninstall'
Adveon is already uninstalled, which in this case is what you want. Continue with point 2.
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.
43
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):
"c:\Program Files\Microsoft SQL Server\120\Setup Bootstrap\SQLServer2014\setup.exe" /Action=Uninstall /Q
/IACCEPTSQLSERVERLICENSETERMS /Features=SQLENGINE,SNAC_SDK /InstanceName=Adveon /SKIPRULES=PerfMonCounterNotCorruptedCheck RebootRequiredCheck
This command can be successful (if the instance still existed) or fail. Both should be ok.
3. Reboot your pc.
Possible Pitfall with above command:
The command
"c:\Program Files\Microsoft SQL Server\100\Setup Bootstrap\SQLServer2008R2\setup.exe" /Action=Uninstall /Q
/IACCEPTSQLSERVERLICENSETERMS /Features=SQLENGINE,SNAC_SDK /InstanceName=Adveon /SKIPRULES=PerfMonCounterNotCorruptedCheck RebootRequiredCheck
sometimes doesn’t work, because a different instance name was used at installation, e.g. Adveon2. Make
sure you change the command accordingly.
44
10.2.6 Making sure that Adveon is uninstalled completely
To check if your machine is completely Adveon-free do the following:
1. Check these locations:
l
C:\Program Files (x86)\Adveon
l
C:\ProgramData\Adveon
They should not exist.
That is if no other locations where selected during Advanced installation, in that case the other locations
have to be checked.
2. Check whether there's any "Adveon" DB instance
l
Check the registy key HKLM\SOFTWARE\Microsoft\Microsoft SQL Server\Instance Name\SQL.
There mustn't be any value named "Adveon".
l
Check whether there's Window service name "SQL Server (Adveon)"
If there is an Adveon SQL instance it needs to be uninstall from Programs and Features.
3. Check Programs and features
Of course there mustn't be any "Adveon" installed. If it is, it needs to be removed.
45
10.3 Adding Online Catalog not possible
Symptom
Adding of Online Catalog returns error message: Cannot connect to server
Problem
1. The URL is not correct.
2. The specified data download service account cannot connect to the internet.
Solution
1. Make sure the specified URL is correct
2. By default Adveon is using the local system account to connect to the DDS server.
If this account does not have access to the internet, it needs to be changed. You can do this as follows:
a. Select Administration - Service settings
b. Select Use custom account and supply your own account details
46
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 settings 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
If it won't display, please contact your local system administrator.
47
10.4 License Problems in Adveon
Problem
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.
b. In the search result click on 'Services' to display all available services.
c. Click on each Adveon Service to select it and restart the service.
48
10.5 Saving Logfiles for Troubleshooting
For any problem that might happen, e.g. with assemblies, export or catalog synchronization, you can save log
files.
Go to 'Administration' section -> 'Save log files'. There is a button with "Save log files". Just click on it and save the
log files to a place suitable for you and send them to support.
49
11 Appendix
11.1 Command Line Installation
11.1.1 Introduction
This document describes the installation process of the Adveon application using the command line interface. It outlines its usage and enumerates the command line arguments supported by the Adveon installer along with the constraints between them.
11.1.2 Running Command Line Installer
Adveon application is distributed as a single installation file. Executing this file from the Windows user interface
(e.g. double-clicking it) or from the command line without any arguments runs the graphical installer:
AdveonInstaller.exe
To switch the installer into the command line mode it needs to be run with the /QUIET argument:
AdveonInstaller.exe /QUIET
In the command line mode all installation options must be provided as arguments. There are three ways of passing
the arguments to the installer:
1) Command line arguments
AdveonInstaller.exe /QUIET /ARG_1 /ARG_2.. /ARG_N
2) Arguments in the config file
AdveonInstaller.exe /QUIET /CONFIGFILE=install_01.cfg
3) Combination of both
AdveonInstaller.exe /QUIET /ARG_1 /CONFIGFILE=install_01.cfg
Detailed information about the arguments and the config file are described in chapter '11.1.4 Supported
Arguments'.
11.1.3 Command Line Conventions
The following rules are applied to the Adveon command line arguments:
o
o
o
o
o
The format of an argument is Switch=Value
Switch always starts with a forward slash (/)
All the switches are case insensitive.
Argument value containing spaces must be enclosed in double quotes.
'Argument X depends on argument Y' means if X is present then Y must be present as well.
50
11.1.4 Supported Arguments
If you miss any command line argument(s) in the following sub chapters check chapter '/<MISCELLANEOUS>'
11.1.4.1 /ACTION
Which action to launch (case sensitive): Install, Uninstall, Upgrade, Repair, AddComponents. All the
other arguments (except /CONFIGFILE, /LICENSE and /LANGUAGE) depend on this one.
11.1.4.2 /CONFIGFILE
Path to the configuration file containing arguments. File extension is 'cfg'. Each argument must be on its own line.
Comments starts with semicolon ; and must not be on the same line with argument. If command line and configuration file contain the same switch then the command line argument prevails. IMPORTANT: Configuration file
can contain only supported arguments (specified in this document), all built-in arguments (e.g. /quiet) must be
specified on the command line.
The following screenshot shows an example of a config file with typical arguments for 'Standard' installation:
While running the Adveon installer a configuration file will be created automatically. Its path is displayed in the summary window of the Adveon installer (see red border in screenshot below).
51
11.1.4.3 /CREATENEWSERVERDATA
Whether installer will create fresh data for server part or a backup will be restored.
Available values: Yes/No.
Default value if not specified: Yes
11.1.4.4 /CREATENEWSQLINSTANCE
Whether to create a new SQL instance or to use an existing one.
Depends on: /INSTALLCOMPONENTS
11.1.4.5 /DATABASENAME
Name of the database to which data will be populate.
Default value if not specified: Adveon
Depends on: /CREATENEWSQLINSTANCE
11.1.4.6 /DATAFOLDER
The path to server data folder that contains documents, images and catalog data.
Default value if not specified: C:\ProgramData\Adveon
11.1.4.7 /DMGOUTPUTFOLDER
Output folder for DMG.
Default value if not specified:
(empty string)
Depends on: /INSTALLCOMPONENTS
11.1.4.8 /EXISTINGDATAPATH
The path to the data backup file that will be restored.
(empty string)
Depends on: /CREATENEWSERVERDATA
11.1.4.9 /INSTALLATIONFOLDER
The folder where Adveon components will be installed.
Default value if not specified: C:\Program Files\Adveon (on 32-bit machine) or C:\Program Files
(x86)\Adveon (on 64-bit machine)
11.1.4.10 /INSTALLATIONTYPE
Specifies the installation type when Action is Install. Supported values are (case sensitive): Standard,
Advanced.
52
11.1.4.11 /INSTALLCOMPONENTS
Specifies components to install. Supported values are (case sensitive): Client, Server, Database, Edgecam2015R1, Edgecam2015R2, TopSolidCam, TopSolidV79Cam, GibbsCam, DMG. Values are comma-separated and without spaces. This argument is valid only when action is Install or AddComponents.
Example: /INSTALLCOMPONENTS=Client,Server,Edgecam2015R2
Example: /INSTALLCOMPONENTS=Client,Server,TopSolidV79Cam
Example: /INSTALLCOMPONENTS=Client,Server,GibbsCam
Example: /INSTALLCOMPONENTS=Client,Server,DMG
11.1.4.12 /LANGUAGE
Specifies the language that will be preselected on wizard UI. This argument has no effect in silent mode.
The language value must be specified by culture code in format languagecode2-country/regioncode2
(i.e. en-US, de-DE, zh-CN, ...).
11.1.4.13 /LICENSE
Path to the license file.
(empty string)
11.1.4.14 /<MISCELLANEOUS>
The Windows Installer built-in command line arguments (e.g. /quiet) will not be mentioned in this document but
can be found for example here: http://www.robvanderwoude.com/msiexec.php.
11.1.4.15 /PORTRANGESTART
The starting value of the port range used by server and gateway services.
Default value if not specified: 8000
11.1.4.16 /SERVERNAME
Adveon server name. If server is going to be installed the value of this switch can only be localhost. The argument is used when installing client component so that it can establish a connection to the server.
Default value if not specified: localhost
11.1.4.17 /SERVICEACCOUNTISLOCALSYSTEM
Whether to use LocalSystem as the account under which data service will run.
Default value if not specified: Yes.
11.1.4.18 /SERVICEPASSWORD
The password for the account in /SERVICEUSERNAME. For LocalSystem this argument is not needed.
(empty string)
Depends on: /SERVICEACCOUNTISLOCALSYSTEM
53
11.1.4.19 SERVICEUSERNAME
The user name under which data service will run (either LocalSystem or custom user account with format
domain\username).
Default value if not specified: LocalSystem
Depends on: /SERVICEACCOUNTISLOCALSYSTEM
11.1.4.20 /SQLINSTANCENAME
Name of the SQL instance to be created or name of an existing SQL instance.
Default value if not specified: Adveon
11.1.4.21 /SQLSERVERNAME
Name of the server on which SQL instance runs. If SQL instance or database is going to be installed, the value of
this switch can only be localhost.
Default value if not specified: localhost
11.1.4.22 /SQLSERVERPASSWORD
The password to authenticate in case SQL Authentication is used. It must satisfy the strong password requirements.
11.1.4.23 /SQLSERVERUSEINTEGRATEDAUTH
Whether Integrated or SQL Authentication is used in SQL server.
11.1.4.24 /SQLSERVERUSERNAME
The username to authenticate in case SQL Authentication is used. If /CREATENEWSQLINSTANCE is Yes this
value can only be sa. If /CREATENEWSQLINSTANCE is No it can be any non-empty value.
Default value if not specified: sa
11.1.4.25 /UNINSTALLCOMPONENTS
Specifies components to uninstall. Supported values are (case sensitive): All, Client, Server, Database,
Edgecam2015R1, Edgecam2015R2, TopSolidCam, TopSolidV79Cam, GibbsCam, DMG. Values are
comma-separated and without spaces. This argument is valid only when action is Uninstall and some components have been already installed. Value All cannot be used in combination with other values.
Example: /UNINSTALLCOMPONENTS=Client,TopSolidCam,CAMSystem2
Example: /UNINSTALLCOMPONENTS=Client,Edgecam2015R2,CAMSystem2
Example: /UNINSTALLCOMPONENTS=Client,DMG,CAMSystem2
54
Example: /UNINSTALLCOMPONENTS=Client,GibbsCam,CAMSystem2
55
11.1.5 Workflows
This sections describes behavior of the installation wizard according to various combination of parameters set on
the command line.
1. If INSTALLATIONTYPE=Standard and INSTALLCOMPONENTS doesn’t include any CAM (e.g. Edgecam
[version], TopSolidCam, DMG, GibbsCam), one-click wizard is triggered and Adveon is installed
using standard installation with no CAM gateway.
2. If INSTALLATIONTYPE=Standard and INSTALLCOMPONENTS=$Cam (where $Cam is one of the supported CAMs such as Edgecam[version] or TopSolidCam or DMG or GibbsCam), one-click wizard is
triggered and Adveon is installed using standard installation with the specified CAM gateway.
3. If INSTALLATIONTYPE=Standard and INSTALLCOMPONENTS=$Cam1, …, $CamN (where $Cam1N is one of the supported CAMs such as Edgecam[version] or TopSolidCam or DMG or GibbsCam),
error message is shown (only one CAM can be installed when standard installation is used).
11.1.6 Typical Use Case Examples
This sections shows several config files examples for various installation scenarios.
11.1.6.1 'Install' Command Line Examples
11.1.6.1.1 Install Client, Server, Database
/LICENSE=1user_expires20141231.lic
/ACTION=Install
/INSTALLATIONTYPE=Standard
/INSTALLCOMPONENTS=Client,Database,Server
/INSTALLATIONFOLDER="C:\Program Files (x86)\Adveon_test"
/DATAFOLDER=C:\ProgramData\Adveon_test_server
/CREATENEWSQLINSTANCE=Yes
/SQLSERVERNAME=<ServerPC>
/SQLINSTANCENAME=AdveonSQL
/DATABASENAME=AdveonDB
/PORTRANGESTART=8000
11.1.6.1.2 Server, Database
/ACTION=Install
/INSTALLCOMPONENTS=Database,Server
/DATAFOLDER=C:\ProgramData\Adveon_test_server
11.1.6.1.3 Edgecam et al.
/ACTION=Install
/INSTALLCOMPONENTS=Edgecam2015R2,CAMSystem2
56
/SERVERNAME=<ServerPC>
11.1.6.1.4 TopSolid et al.
/ACTION=Install
/INSTALLCOMPONENTS=TopSolidCam,CAMSystem2
11.1.6.1.5 GibbsCAM et al.
/ACTION=Install
/INSTALLCOMPONENTS=GibbsCAM,CAMSystem2
11.1.6.2 'Repair' command line examples
This applies to all scenarios.
/ACTION=Repair
11.1.6.3 'Uninstall' Command Line Examples
11.1.6.3.1 Uninstall Client
/ACTION=Uninstall
/UNINSTALLCOMPONENTS=Client
11.1.6.3.2 Uninstall Client, Server, Database
/ACTION=Uninstall
/UNINSTALLCOMPONENTS=Client,Database,Server
57

Installation Guide

Transcription

Similar documents

Atlantis Energy Systems Inc.

Regions CD Check Viewer Installation Guide

Chemcrest Installation Guide

Zonnestraal - English

Installation of a Clutchlite at a Har- ley

KV “ANDENES” - KV “SENJA” - KV “NORDKAPP”

QuadraTec™ - Auralex Acoustics

Products_files/6 (catalogo DECO PROJECTS.EN)

S kyline - Franz Viegener

RockyMounts Brass Knuckles