Upload and Import packages via Empirum SDK
Table of Contents
Transfer/Upload Offline PXE Boot Image to the Master Server
You can skip this and directly upload and import via the Offline PXE Image Creator Tool or Package Upload & Import Tool.
Here is how to transfer files to the master server in the Cloud, without having our UUX. The user Emp SupportXXX is used for uploading.
If you are using our UUX it's much easier to upload files and you can find more information's here.
Matrix42 recommends the Web Dav-capable tool Win SCP for the upload.
To open a Web DAV connection, the Web Dav redirector must first be installed on a Windows server!
Start a Windows PowerShell as administrator and execute the following command (this restarts the server):Install-Windows Feature Web Dav-Redirector -Restart
- If you have not already done so, please download and install the Win SCP tool.
- Start the Win SCP tool.

The login window for a new Site is displayed. - Under File protocol, select
Web DAV. - Under Encryption, select T
LS/SSL Implicit encryption. - Enter your Matrix42 Master Server under Host name -
empirumXXX.m42cloud.com(ReplaceXXXwith your instance). - Enter Port
443underPort number.- The login is done with the stored connection information, e.g.
User: Emp CloudXXX-X(ReplaceXXX-Xwith your user).
Password: <Your Password>
- The login is done with the stored connection information, e.g.
- Click on the Advanced button.
- Select the Directories folder and enter
/Matrix42-Empirumunder Remote directory.
- Click OK, click Save and then click Login.
You have now established a connection with the share on your Matrix42 Cloud Server. - Now you can copy the previously created Win PE boot image "
Win PEx64Depot SMB" (in the directoryC:\Temp\2\Offline Pxe Image) to the/Matrix42-Empirum/Configurator/Package Storedirectory (this may take longer, depending on the connection speed).
Win PE Boot Images, Variable Configurations, and Software Packages, but also Operating System, Drivers and Language Package imports can be copied to the Package Store directory.
Import Win PE Boot Image via SDK
You can directly upload and import via the Offline PXE Image Creator Tool or the Package Upload & Import Tool.
After the Win PE boot image has been uploaded to the master server, it can now be imported via SDK. This step is obsolete when you are using our UUX upload function.
- Start Windows PowerShell ISE as administrator.
- To test a connection, you can use the CLOUD-Depot XXX__Connection Test.ps1.txt Power Shell script - (replace
XXX, user and Password with your credentials and delete the .txt extension).param([string]$Server Name='empirumXXX.m42cloud.com', [int32]$Port=443, [string]$User Name='m42cloud\Emp CloudXXX-1', [string]$Password='Password', [string]$Tcp Port)
If the connection information is correct, the following is displayed:
- In this CLOUD-Depot XXX__Import_via_SDK.ps1.txt Power Shell script you need to check the path to the Win PE boot image you just uploaded - in this example it is
"Z:\Configurator\Package Store\Win PEx64Depot SMB" (replaceXXX, user and Password with your credentials and delete the .txt extension). With this Script we will overwrite all existing PXE images in this path.
In this example script it is important to specify "Z:\" as Import Path and "-Is Secure $true" in the Connection String.[string]$Server Name = "empirumXXX.m42cloud.com"[int]$Port = 443[string]$User Name = "m42cloud\Emp CloudXXX-X"[string]$Password = "Password"[string]$import Path = "Z:\Configurator\Package Store\Offline Depot SMB"...$session = Open-Matrix42Service Connection -Server Name $Server Name -Port $Port -User Name $User Name -Password $Password -Is Secure $true - If all entries are correct, run the script (F5). After a successful run, the following is displayed:
Operating system and language packages - create - transfer - import
If an offline subdepot is not yet installed, or if it is not to be used, the requirements as described above must also be fulfilled here.
After an operating system source and / or language package has been created via the Packaging Center > Prepackaged OS Wizard, it must also be transferred to the master server in the cloud.
The procedure is identical to "Transfer Offline PXE Boot Image to the Master Server".
After the network location is established, the offline operating system source or the offline language package can be transferred to the Package Store directory on the master server.
Import via SDK can be done using the same CLOUD-Depot XXX__Import_via_SDK.ps1.txt PowerShell script, or you can create a new script.
The only difference is the path specification to the operating system source or language package.
Change the row[string]$import Path = "Z:\Configurator\Package Store\<Operating system source or language pack>"
to your uploaded operating system source or language pack. If all parameters are entered correctly, the operating system source or language pack is imported and is then available for assignment in the middle tree of the Matrix42 Management Console.
Operating system drivers - create - transfer - import
If an offline subdepot is not yet installed, or if it is not to be used, the requirements as described above must also be fulfilled here.
After a driver package has been created via the Packaging Center > Offline Driver Package Creator, it must also be transferred to the master server in the cloud.
The procedure is identical to "Transfer Offline PXE Boot Image to the Master Server".
After the "network location" is established, the driver package can be transferred to the Package Store directory on the master server.
Import via SDK can be done using the same CLOUD-Depot XXX__Import_via_SDK.ps1.txt Power Shell script, or you can create a new script.
The only difference is the path specification to the operating system driver.
Change the row[string]$import Path = "Z:\Configurator\Package Store\<operating system driver>"
to your uploaded operating system driver. If all parameters are entered correctly, the operating system driver is imported and can then be assigned in the Matrix42 Management Console via the Driver Wizard.