Optitex Installation Guide (For Administrators)

Optitex Installation Guide (For Administrators)

Table of Contents Overview... 3 Prerequisites... 3 User Preferences Settings and Customizations... 3 Installing Optitex Full Installation... 4 Optitex Full Installation Details... 4 Installing a Network Server... 10 Activating Your License:... 13 Configuring Remote Workstations... 18 The License Server... 18 The License Clients... 19 Managing and Controlling Your Licenses... 19 Advanced Nesting License Keys Installation... 22 Nest ++ Pro License Key Installation, Code Meter... 22 Nest ++ 2 License Key Installation, Sentinel Protection Installer... 25 Service Pack Installation Guidelines... 29 Separate Installation Packages... 30 Installing CutPlan... 30 Installing the Sample Pack... 35 Installing Optitex Plugins... 38 Installing Runway Viewer... 42 Installing Optitex Viewer... 47 Uninstalling Optitex... 52 Silent Installations... 53 General Syntax for Silent Installations... 53 To add a feature... 53 Installing a service pack (update) silently... 53

Overview This document outlines the installation and administration consideration of the Optitex desktop products listed below. It comes to serve as a guideline for enterprise installations, for both a standalone installation as well as one that is part of a wide deployment. The products and components covered in the installation guide are: Optitex Full Installation (2D/3D) Service Pack Sample Pack Plugins stand alone Runway Viewer - standalone (included in full) Optitex Viewer standalone (included in full) CutPlan stand alone Network License Manager SDK stand alone The Optitex installations of both the initial install, as well as the service packs can be installed both attended and unattended. Refer to the Silent Installation section to learn more about silent installation switches. Prerequisites Before installing Optitex on your computer, first make sure your computer is compatible with Optitex. System Requirements Operating System Requirements Use the following guidelines to avoid installation issues: 1. Download and unzip the installation files and have them ready. 2. Don t plug-in your license keys before the installation. The installation package contains the license key drivers. Note: Older major versions may be left intact. You may use them for as long as needed before you remove them. User Preferences Settings and Customizations User preferences, settings and customizations are saved in the file system and in the registry. For example, changes made by the user to Tools > Preferences are written to the Optitex[version#].ini file. The windows folder containing this and more user generated files is :C:\Users\public\OptiTex Proprietary information of Optitex 2016 3

Installing Optitex Full Installation The Optitex full installation should be used for new main versions, or when installing from scratch. The installation packages should also be downloaded. The following components are available when using the full installation: (Some of the components have individual installation packages; see the section below for more information) 1. PDS: Pattern Design System 2. Marker: Marker making & nesting system 3. Direct converters: Convert commonly used CAD system files directly to Optitex format, or export from Optitex to other formats 4. Data Exchange: Import and export universal data exchange format 5. Optitex 2D Viewer: View and plot 2D files 6. Runway Viewer: View 3D files interactively 7. Utilities 1. License Manager 2. HASP RUS Network license key update utility 3. Select language 4. Remote support utility (using Team Viewer) 5. Optitex Batch Creator: batch utility 8. Output utilities: used to configure and manage plotting and cutting 1. Outman 2. OCC Optitex Full Installation Details The full installation package should be executed using the EXE file (and not the MSI file). The Optitex installation requires the following Microsoft components: Microsoft.NET Framework 4 Client Profile Microsoft.NET Framework 4 Extended Microsoft Visual C++ 2005 redistributable Microsoft Visual C++ 2008 redistributable X86 Microsoft Visual C++ 2010 X86 redistributable If your system is missing one or more of these components, they will be installed prior to the Optitex package. Proprietary information of Optitex 2016 4

Important: The available MSI installation file should only be used in command line installations. It does not supply the above Microsoft components. Installing the MSI on a system missing one or more of the prerequisites will result in a non-usable Optitex installation. To run the full Optitex installation: 1. Run the extracted full installation package (recommended: right click and select Run as Administrator). The Optitex Installshield Wizard opens: If you are missing any requirements necessary for installation, a message appears specifying the missing prerequisites, click Install to proceed: Once you have all requirements, the Optitex installation automatically begins and the Welcome Screen appears: 2. Click Next. Proprietary information of Optitex 2016 5

The License Agreement dialog appears: 3. Read the license agreement, then select the I accept the terms in the license agreement radio button. 4. Click Next. The Customer Information dialog appears: 5. Enter your personal information including your name, organization and email. 6. In the Install this application for area, select whether to install the application for anyone who uses this computer, or for the current user only. 7. Click Next. Proprietary information of Optitex 2016 6

The Destination Folder dialog appears: 8. To set the installation folder to another location, click Change and set a different folder. 9. Click Next to accept the default folder location, or to proceed after setting a different folder. The Custom Setup dialog appears: 10. Select the required components: 1. Optitex Suite: Installs all Optitex Applications. 2. Nesting Pack: Select only if you use advanced nesting. 3. Team Viewer: (recommended) Allows you to get online support from Optitex when you need it. Proprietary information of Optitex 2016 7

Note: If you need to add a component later (e.g. nesting pack), you can run the same installation package again, chose Modify, and select the required component. 11. Click Next. The Ready to Install the Program dialog appears: 12. Click Install. The installation process starts: Once the installation is complete, the InstallShield Wizard Completed message appears: Proprietary information of Optitex 2016 8

13. Click Finish. 14. Proceed with one of the two: If Nesting Pack was not included in your Custom Setup, you are all set. Proceed with activating your license key (if required). For more information, see licensing guide. a) If Nesting Pack was included in your Custom Setup, the advanced nesting licensing drivers installation is initiated. Proceed with installing the Code Meter (Nest ++ Pro), or Sentinel (Nest ++ 2) installations. See the next section for step by step instructions. Proprietary information of Optitex 2016 9

Installing a Network Server This section describes how to install an Optitex licensing server and how to activate the software license. This installation is used when you want to only install the licensing components on a network server (and avoid the full Optitex installation), and point all the Optitex client machines to it for licensing (rather than dealing with a per client key). This installation supports the physical and virtual key for the licensing of Optitex 2D/3D products, as well as the server side installation for the nesting module. Note: The instructions in this section support version 15.5 and above (see details) To install a network server 1. Download the Optitex Network License Manager package: 2. Unzip and then run the file named Optitex Network License Manager.exe 3. Click Next to start the installation. Proprietary information of Optitex 2016 10

4. Click the I accept the terms in the license agreement radio button. 5. Click Next. Note: If you have nesting licenses you wish to provide from a server side, you can add the Code Meter driver in this step. 6. Click Next Proprietary information of Optitex 2016 11

7. Click Install to begin the installation. Once the installation is complete a message appears informing you the installation was successful: 8. Click Finish. You can now activate your license. Proprietary information of Optitex 2016 12

Activating Your License: After installing the Optitex network license manager, you can proceed with activating your license. To proceed you must have either a product key string (provided by Optitex) or a physical key. To activate your license: 1. If you are using a hardware (physical key), plug it into the USB port on your server. 2. Run the License Manager from the Optitex product group: 3. If you are installing a virtual (software) key for the first time, the following warning will pop up, you can ignore and continue with clicking OK The License Manager appears: Proprietary information of Optitex 2016 13

4. If you are using a hardware (physical) key, you can skip to step 6. 5. In the Software Key area, enter the Product Key string you received from Optitex as follows: Proprietary information of Optitex 2016 14

6. Click Register Key. Once the key is registered, the following message appears: Proprietary information of Optitex 2016 15

7. In the License area, click Online Activation as follows: Proprietary information of Optitex 2016 16

A message appears informing you that the process may take some time: 8. Click Ok to proceed. Once the installation is complete a message appears. Notice the product version, and modules are updated accordingly: Proprietary information of Optitex 2016 17

9. Click Ok to close the License Manager. Configuring Remote Workstations Once you have installed and activated Optitex, you can now configure a remote workstation. This section contains advanced network licensing information and configuration. The License Server The license server is the computer available on the network, on which the network license key is installed. This computer distributes the licenses concurrently (at the same time) to the clients via the network, listening to the default port: 1947. The server can provide licenses following the license key activation, based on the number of concurrent (floating) licenses available on the key. Proprietary information of Optitex 2016 18

The License Clients The clients need to have the Optitex software package installed. The clients get their licenses automatically as long as they are exposed to the license server via the network. In case the clients have a problem getting the license, because of subnets layout or for any other reason, they can be configured to access the server directly. The client gets an available license form the server. If all licenses are in use, the client will have to wait until a license is released. Managing and Controlling Your Licenses The Safenet environment provides a web based interface to monitor, control and configure your licenses: The Sentinel Admin Control Center (ACC). This is installed by the Optitex package but can also be installed on its own. Using this interface, you can: Verify that your license key installation is intact. Verify the amount of floating licenses. Configure network license server and clients. Monitor access and use of products, features and sessions. Control and end unneeded sessions. Apply license updates. And more Accessing the Sentinel Admin Control Center (ACC) The Sentinel Admin Control Center (ACC) can be accessed on the server or on the client. It can also be accessed remotely if configured to allow it. For more information, see http://localhost:1947/_int_/acc_help_config_basic.html The default communication port of the ACC is port 1947. Unless configured differently, use this port number to access the ACC. To open the ACC: 1. Using any web browser, go to the URL: http://localhost:1947. The ACC for the local machine opens: Proprietary information of Optitex 2016 19

2. Select an option from the menu on the left to view/configure/monitor your licenses. 3. More information can be found under Help. Pointing Clients Directly to the Server Whenever clients are experiencing difficulty reaching the license server, because of subnets layout or any other reason, it is recommended to point the licensing clients directly to the server. To designate a specific server: 1. On the client open the ACC. 2. From the Options menu, select Configuration. 3. On the Configuration for Sentinel License Manager on [Computer_name] page, select the Access to Remote License Managers tab. 4. Clear the Broadcast Search for Remote Licenses checkbox. 5. Check the Aggressive Search for Remote Licenses checkbox. 6. In the Specify Search Parameters box, enter the server computer name or IP address. If more than one server is available put each in a separate line. Proprietary information of Optitex 2016 20

Applying One Client s Settings to Multiple Clients With a large scale network licensing environment, it may be easier to configure one client successfully first and then apply the same settings to all the clients. This is done by using the hasplm.ini file. You can copy it from the previously configured client and replace the existing file for other clients. To configure multiple clients: 1. On the successfully configured client go to: C:\Program Files [or Program Files (x86)]\common Files\Aladdin Shared\HASP 2. In this folder, copy the hasplm.ini file. 3. Replace this file in all clients using the same configuration. Note: A real time indication of the location of the hasplm.ini file can be found in the ACC Configuration page. You will find the path at the bottom of the page. Proprietary information of Optitex 2016 21

Advanced Nesting License Keys Installation If Nesting Pack was included in your Custom Setup, Both Nest ++ pro and Nest ++ 2 license keys installation are initiated. Install only what you need: The Code Meter installation is for Nest ++ Pro. The Sentinel protection installer is for Nest ++ 2. Install both only if you have both nest ++ pro and nest ++ 2 license keys, otherwise, cancel and close what you don t need. Nest ++ Pro License Key Installation, Code Meter Note: Starting from O/15.5 you no longer need to install the Code Meter separately; it will be automatically installed silently if the Nesting Pack has been selected. It will be available several minutes after the installation completes. To install the Nest ++ Pro License: The CodeMeter Runtime Kit is initiated by the Optitex installation: 4. Click Next The End-User License Agreement dialog appears: Proprietary information of Optitex 2016 22

5. Read the license agreement, then select the I accept the terms in the License Agreement radio button. 6. Click Next The Installation Scope dialog appears: 7. Chose and select to install for all users or just for the current user and click Next. The Custom Setup dialog appears: Proprietary information of Optitex 2016 23

8. Click Next. The Ready to install CodeMeter screen appears: 9. Click Install. The Installation proceeds: Proprietary information of Optitex 2016 24

Once the installation is complete: 10. Click Finish. Your Nest ++ Pro key is ready to use, no activation is needed. Nest ++ 2 License Key Installation, Sentinel Protection Installer To install the Nest ++ 2 License: The Sentinel protection installer is initiated by the Optitex installation: Proprietary information of Optitex 2016 25

1. Click Next. The License Agreement dialog box appears: 2. Read the license agreement, then select the I accept the terms in the License Agreement radio button. 3. Click Next. The Setup Type dialog appears: Proprietary information of Optitex 2016 26

4. Click Next. The Ready to Install the Program dialog appears: 5. Click Install. The Windows Firewall Detected! Note Appears: Proprietary information of Optitex 2016 27

6. Click Yes. The installation proceeds: Once the installation is complete: Proprietary information of Optitex 2016 28

7. Click Finish. Your Nest ++ 2 key is ready to use; no activation is needed. Service Pack Installation Guidelines The Optitex service packs should be used to upgrade minor versions (e.g. 15.0 to 15.1) or to apply certain fixes to the current version. The service pack installation package should be downloaded. Notes: 1. Service packs can be applied only to existing installations of the same main version number. e.g., 11.4 to 11.2. A service pack version 12.1 cannot be applied to an existing installation version 11.4. 2. Applying a service pack is appended to the current installation of the same main version. 3. As opposed to full versions, different service pack installations cannot be run alongside each other. 4. The service pack installation overwrites part of the previous installation. 5. If you want to uninstall (O/15.3 SP1) when upgrading, you will receive an error. Ignore this error by clicking Ok. The Service Pack will be uninstalled in any case. Proprietary information of Optitex 2016 29

Separate Installation Packages CutPlan: (requires additional license key) Sample Pack: Containing a large variety of 2D & 3D samples (this is separate from the samples that are included by default. Plugins These are extra add ons (dll files) that can be added to the Optitex program Runway Viewer This is a viewer that allows you to view 3D PDS files without having to open them via Optitex. Optitex Viewer This is a viewer that allows you to open PDS file and view them, as well as view and plot MRK files. SDK Installing CutPlan CutPlan is a program that allows you to optimize your cutting operations. You need an additional key to work with the CutPlan. Please contact your Optitex representative for more information. To install CutPlan: 1. Run the extracted CutPlan file. (recommended: right click and select Run as Administrator). The CutPlan InstallShield Wizard dialog appears and all the files are extracted to your machine: Once the files have been extracted, the CutPlan wizard appears: Proprietary information of Optitex 2016 30

2. Click Next to begin the installation procedure. The License Agreement dialog appears. You must accept the terms and license agreement in order to continue installing. 3. Select the I accept the terms in the license agreement radio button, then click Next. Proprietary information of Optitex 2016 31

The Destination Folder dialog appears allowing you to define the location of the CutPlan s files: 4. To change the file location, click Change otherwise click Next to continue. Proprietary information of Optitex 2016 32

5. If you want install the Sentinel Driver or Code Meter Driver, select the appropriate checkboxes and then click Next Or Click Next to install the CutPlan program only. The system starts the installation process. You can see the progress of the installation in the Status area. Once the installtion is complete the InstallShield Wizard Completed dialog appears: Proprietary information of Optitex 2016 33

Click Finish to close the wizard. Proprietary information of Optitex 2016 34

The CutPlan files are installed in your computer (depending on the type of installation and designated folder): Installing the Sample Pack The Sample Pack is a separate installation that provides a variety of 2D and 3D samples you can use in Optitex, including additional avatars, PDS files, shaders, fabrics, rigid parts, etc. Note: You must install the Sample Pack of your Optitex version. For example, if you have Optitex version O/15.5, make sure you install the Sample Pack version O/15.5. To install the Sample Pack: 1. Run the extracted SamplePack file. (recommended: right click and select Run as Administrator). The SamplePack InstallShield Wizard dialog appears and all the files are extracted to your computer. If you already have a Sample Pack installed on your computer you will have to upgrade the version, otherwise you will follow the regular installation. Proprietary information of Optitex 2016 35

2. Click Yes to upgrade the Sample Pack that is currently on your computer. All of the files are prepared for installation: 3. Click Next to start the installation: The program features are installed. You can see the progress of the installation in the Status area: Proprietary information of Optitex 2016 36

Once the installation is complete the InstallShield Wizard Completed dialog appears: Click Finish to complete the installation. Proprietary information of Optitex 2016 37

You can see all the files were installed successfully in your Optitex folder: Installing Optitex Plugins Optitex offers a set of plugins that can be added to the software, for example marker viewer, ASTM converter, etc. These add ons are dynamic according to the version you select; therefore, the 32bit includes different plugins than the 64bit. You can either install the 32bit or 64bit installation according to your computer s operating system. To install Optitex Plugins: 1. Run the extracted Plugin file. (recommended: right click and select Run as Administrator). The spplugin InstallShield Wizard dialog appears and all the files are extracted to your computer. Proprietary information of Optitex 2016 38

2. Click Next to start the installation procedure. The License Agreement dialog appears. You must accept the terms and license agreement in order to continue installing. Proprietary information of Optitex 2016 39

3. Select the I accept the terms in the license agreement radio button, then click Next. 4. Click Install to begin the installation: Once the installation is complete the InstallShield Wizard Completed dialog appears: Proprietary information of Optitex 2016 40

5. Click Finish when you are done. All of the Plugins are added to your Plugins folder in your Optitex folder: (depending on your designated location for your Optitex files) Proprietary information of Optitex 2016 41

Installing Runway Viewer The Runway Viewer is a separate application from the Optitex setup and can be downloaded and installed quickly by clicking on the download link. Once you install the Runway Viewer a desktop icon is created so you can easily access it. To install the Runway Viewer: 1. Download the installation files. The Install Shield Wizard appears: Proprietary information of Optitex 2016 42

2. Click Next to start installing. The License Agreement dialog appears. You must accept in order to continue with the installation. 3. Click Next to continue. 4. To change the destination folder where all the setup files will be saved, click Change; otherwise click Next. Proprietary information of Optitex 2016 43

5. Click Install to start the installation. 6. Wait for the features to be installed. Proprietary information of Optitex 2016 44

Once the installation is complete you will be informed. 7. Click Finish. Proprietary information of Optitex 2016 45

The Runway Viewer files are installed in your Optitex folder (depending on your designated folder for your Optitex files) Proprietary information of Optitex 2016 46

Installing Optitex Viewer Optitex Viewer enables you to view PDS files, and view and plot Marker files without an Optitex plug. You can either install the 32bit or 64bit installation according to your computer s operating system. To install the Optitex Viewer: 1. Run the extracted Optitex Viewer file. (recommended: right click and select Run as Administrator). The Optitex Viewer InstallShield Wizard dialog appears and all the files are extracted to your computer. 2. Click Next to begin the installation process: Proprietary information of Optitex 2016 47

The License Agreement dialog appears. You must accept the terms and license agreement in order to continue installing. 3. Select the I accept the terms in the license agreement radio button, then click Next. Proprietary information of Optitex 2016 48

4. If you want to change the location where all the files are saved, click Change, otherwise click Next to continue. 5. Click Install to start installing. The installation process begins. You can see the progress of the installation in the Status area. Proprietary information of Optitex 2016 49

Once the installation is complete the InstallShield Wizard Completed dialog appears: 6. Click Finish to close the wizard. Proprietary information of Optitex 2016 50

The Optitex Viewer is installed in your Optitex folder (depending on the designated folder for all Optitex files) Proprietary information of Optitex 2016 51

Uninstalling Optitex If you no longer want Optitex on your computer, you can easily remove it via the Control Panel. 1. Uninstall to remove a main Optitex version. 2. In the Windows Control panel, go to Programs and Features (or similar, depending on windows). The Uninstall or Change a Program dialog opens. 3. From the Installed Versions list, select the Optitex version you want to uninstall. 4. On the menu, select Uninstall. A confirmation message appears. 5. Click Yes to proceed. The program is removed. Notes: Alternatively, you can select Uninstall Optitex [Version] in the Optitex group in the Start menu. Removing one version will not interfere with other installed versions. Some elements need to be removed manually. Proprietary information of Optitex 2016 52

Silent Installations All Optitex installation packages support unattended installation via command line or other means by leveraging the MSI (Microsoft Software Installation) technology. Once the installation is complete desktop icons will appear along with the Optitex installation folder with all the appropriate files. Note: Unattended installations can be complex; therefore, it is recommended that a system administrator will be involved in setting up the installations. Before the Installation 1. Verify that your system specifications are within the recommended system requirements. 2. Check that all prerequisites are installed. 3. Download and unzip the MSI file and have it ready. General Syntax for Silent Installations To install an Optitex product silently use the following syntax: msiexec /i <<path to file>> /qn To add a feature Installing a service pack (update) silently Optitex services packs are based on the windows installer patch technology. It is possible to run a silent install of a patch using the following syntax: "path to SP" /s /v"/qn To install Optitex via MSI: 1. Open CMD (run CMD as Administrator) Or Go to Run 2. To run Optitex enter the following command line: msiexec /i "path to file" /qn 3. To add the Nesting pack, enter the following command line: "msiexec /i "path to file" /qn NESTINGPACK_FEATURE=1". 4. To add TeamViewer, enter the following command line: msiexec /i "path to file" TV_FEATURE=1 /qn 5. To add the Optitex log file, enter the following command line Proprietary information of Optitex 2016 53

/v"/l*v \"path_to_file.log\" 6. To run the Service Pack, enter the following command line: "path to SP" /s /v"/qn Note: Run Msiexec /help for a list of the available parameters and options. Proprietary information of Optitex 2016 54

Copyright 1988-2016 by Optitex. All rights reserved. All text and figures included in this publication are the exclusive property of Optitex, and may not be copied, reproduced, or used in any way without the express permission in writing from Optitex. Information in this document is subject to change without notice and does not present a commitment on the part of Optitex.