Altium nexus

Nexus Server Message This documentation page references NEXUS Server (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information. Created: June 07, 2022 | Updated: June 08, 2022 | Applies to version: 5.0 Nexus Server Message This documentation page references NEXUS Server (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information. Parent page: Altium NEXUS Server with Oracle BackendThis document is intended for an IT administrator who is backing up the Altium NEXUS Server when using an Oracle Database Backend. It contains details about the Altium NEXUS Server, its backup procedure within the context of using Oracle, important information on system requirements, as well as an example.To follow this guide, you should have a general understanding of Oracle database concepts and the Windows operating system environment.Backup Process OverviewBacking-up the Altium NEXUS Server when using an Oracle backend depends on how your company manages its Oracle Databases. Some companies run Oracle Databases on top of Windows Server Operating Systems, while others have entire Oracle datacenters. The backup process typically involves three steps, as illustrated in the following image.It is important that the steps be followed in the order they are presented. High level overview of the Altium NEXUS Server and Oracle database backup procedure.Assumptions made throughout this Document An IT admin performs the installation. At a very minimum, the user performing NEXUS Server installation should have administrative rights to the host machine. The Oracle Schema and Oracle application credentials used on the source and destination Oracle servers must be the same.High-level Overview of the Altium NEXUS Server ArchitectureSimilar to other software designed to run on Microsoft Windows, the Altium NEXUS Server is a multi-threaded, multi-service server application. Since this document solely focuses on parts of the Altium NEXUS Server that may interact with an Oracle Database, the following image is simplified to represent the overall Altium NEXUS Server Backend Architecture. High level overview of the Altium NEXUS Server architecture. The Backend Storages of Altium NEXUS Server contains most of the customer binary data, while the Windows Services is a collection

Machine. This is required to properly run the Altium NEXUS Server backup Command utility (avbackup.exe). Appropriate DBA access to the Oracle server (i.e. Add user’s Windows account to DBA role in Windows environment).Backup Procedure On the Altium NEXUS Server Host machine: Create a backup folder (it helps to have common file paths, for example: C:\Backups). Backup your Altium NEXUS Server data by running the avbackup.exe tool as Admin. The tool is located in the C:\Program Files (x86)\Altium\Altium NEXUS Server\Tools\BackupTool folder. Example backup commands: Command line to navigate to the backup tool directory: cd C:\Program Files (x86)\Altium\Altium NEXUS Server\Tools\BackupTool\. Command line to backup the Altium NEXUS Server data into the file named Q2_Backup.zip, writing the file to the folder C:\Backups: avbackup backup -z "C:\Backups\Q2_Backup.zip" -i "C:\Program Files (x86)\Altium\Altium NEXUS Server\LocalVault.ini". On the Oracle Database Server Host machine: Create a backup folder (it helps to have common file paths, for example: C:\Backups). Backup your Oracle data (this section assumes that the user account and schemas are both named ANSUSER313 and have password Altium): Launch a command prompt with Admin privileges. Stop IIS Servers using command: net stop WAS. Temporarily elevate involved schema to DBA status before backup. Backup/Export the schema associated with the Altium NEXUS Server. An example of an export command is: exp ANSUSER313/Altium@xe owner=ANSUSER313 file=c:\Backups\ANSUSER313.dmp log=c:\Backups\ANSUSER313_export.log statistics=nonewhere,ANSUSER313 – user that has full privileges on scheme and rights to access the DB.Altium – password for Oracle user account associated with the Altium NEXUS Server.xe – network service name of target DB contained in tnsnames.ora.owner = ANSUSER313 – name of the schema.file = c:\Backups\ANSUSER313.dmp – backup location.log = c:\Backups\ANSUSER313_export.log – backup log (optional).ConclusionAlthough the aforementioned example includes additional details pertaining to the handling of an Oracle Database, there are only three key steps to backing up your Altium NEXUS Server data: Step 1 is to stop the IIS services and NEXUS Server IIS Application Pools. Step 2 is to backup the Altium NEXUS Server data. Step 3 is to backup the Oracle data associated with the Altium NEXUS Server.Performing this procedure in the order described greatly reduces the likelihood of data corruption due to Oracle database and NEXUS Server binary data mismatch. Printer-friendly version If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

A member of the organization's IT department.Can I connect to multiple Altium NEXUS Servers?You can only be 'signed in' to one Altium NEXUS Server at any given time, since you are connecting to a platform of services, rather than to a single Server service. Typically an organization will have a single Altium NEXUS Server installation. However, if more than one Altium NEXUS Server is available, simply sign out of one and sign in to another, as required.From Altium NEXUS, you can still sign in to a legacy Altium Vault (Vault 2.0 to 3.0), or connect to a legacy Altium Personal Vault: Altium Vault - sign out of your active server, then use the Sign in dialog to sign in to the Altium Vault. Altium Personal Vault - sign out of your active server, then use the Sign in dialog to connect to the Personal Vault. Remember that for a Personal Vault you are connecting, not signing in - so the Altium NEXUS GUI will not show you as being signed in to any server after successful connection to the such a vault.Once you have signed in/connected to a target entity it will be listed in the Known Servers region, on the Data Management - Servers page of the Preferences dialog in Altium NEXUS.While legacy Vault technologies can still be connected to, and used, there is no further development to these types of Vault. You will therefore not enjoy the current enhancements found in, and future improvements gained by, using the Altium NEXUS Server.I'd still like to run my Altium Personal Vault, is this possible?Absolutely. If you have a previous flavor of Vault running on the same PC ensure that the communication ports are unique. An Altium NEXUS Server uses the default port 9780 (same as for its Altium Vault predecessor), an Altium Personal Vault uses the default port 9680.To make your Personal Vault a 'Known Server' in Altium NEXUS - on the Data Management - Servers page of the Preferences dialog - sign out of your active server, then use the Sign in dialog to connect to the Personal Vault. Remember that for a Personal Vault you are connecting, not signing in - so the Altium NEXUS GUI will not show you as being signed in to any server after successful connection to the such a vault. You can then sign back in to the server that was active previously,

Of supporting services.This document focuses on the Backend Storages since the data within this block is what gets backed up, potentially migrated to another machine, then restored either on the same or different machine. Within the Backend Storages, the following items can be found: Databases – contains metadata such as component footprint and schematic symbol association, parameters, file paths, links to component supply chain data sources and more. This information could reside inside a Firebird or Oracle database. File Storage – this File Storage area holds binary data inside the NEXUS Server’s VCS repository. This binary data includes information such as PCB and Schematic Project documents, footprints, symbols, Draftsman and other native or non-native NEXUS Server documents.High-level Overview of the Altium Backup ToolThe Altium backup tool is called avbackup.exe. This is a command line utility that IT administrators can execute to backup their Altium NEXUS Server data. avbackup.exe is the same utility used for backup purposes when the Altium NEXUS Server is configured with a default Firebird database backend, or when using the Oracle database as a backend.When using avbackup.exe on a NEXUS Server implementation that uses an Oracle Database, administrators should be mindful of the following: avbackup.exe does NOT support backing up your Oracle Database. This feature only works on Altium NEXUS Server implementations using a Firebird database backend that was originally auto-configured by the Altium NEXUS Server Installer. avbackup.exe will generate a Zip file containing all NEXUS Server binary data. avbackup.exe will automatically shut down all Altium NEXUS Server services (including IIS services) during data backup, then restart all services it shut down, after a successful backup.Example Backup of NEXUS Server with Oracle backend on the Windows PlatformIn this example, the instructions also cater to smaller businesses who may not have a dedicated Oracle Database Administrator (DBA), but still have the need to backup their NEXUS Server and associated Oracle data on their network. The following steps show how a basic backup of Altium NEXUS Server and the Oracle database can be performed.When using Altium NEXUS with Oracle as the backend database, the server that is integral to the deployed NEXUS solution supports Oracle version 19c.Alternatively, more advanced IT administrators can write batch files that automatically perform the following procedure.Required Items Backup folders – folders where you plan to store Altium NEXUS Server and Oracle data need to already exist. Admin access to the Altium NEXUS Server Host